🇧🇷Brazil
Effective December 23, the payment method Boleto is no longer available due to updated Brazilian regulations set to take effect on January 1, 2025. We apologize for any inconvenience and appreciate your understanding.
Country specifications
BR
BRL and USD
2
CPF
Numeric.
Length 11
(Validate verifier-digits)
Yes
Card features
Multiplo cards
Some Brazilian bank cards, called "Multiplo" cards, can be used for both credit and debit.
Server2Server
Within our Server2Server integration, by default, we treat them as credit cards.
However, you can use the credit_card.payment_mode setting to force a transaction to be DEBIT or CREDIT. This lets you give customers a choice, like using debit for a one-time payment or credit to pay in installments.
Card-on-file
For cards you have saved:
If you don't specify the type, it will use the type you originally saved (credit or debit).
If you use
credit_card.payment_mode, it will use whatever you specify for that single transaction.
Brands available
payment_method code CC
payment_method code CCAs the payers will be capable to input any card in the displayed checkout form ,the OneShot and Fragments all-in-one solution, we recommend using the payment method code CC in the API requests, which is a generic code.
After the payment is attempted, merchants will be capable to know with which card the user paid.
VI
Visa
VD
Visa Debit
MC
Mastercard
MD
Mastercard Debit
AE
American Express
CL
Cabal
EL
Elo
ELD
Elo Debit
DC
Diners Club
HI
Hipercard
Alternative Payment Methods available
IX
Pix
BANK_TRANSFER
PP
PicPay
VOUCHER
BB
Banco do Brasil
BANK_TRANSFER
CA
Caixa
BANK_DEPOSIT
I
Itaú
BANK_TRANSFER
B
Bradesco
BANK_TRANSFER
SB
Santander
BANK_DEPOSIT
BZ
Banco Original
BANK_DEPOSIT
SF
Banco Safra
BANK_DEPOSIT
UL
Banrisul
BANK_DEPOSIT
NU
Nubank
BANK_TRANSFER
ME
MercadoPago
BANK_TRANSFER
ICSH
iCash
VOUCHER
SUA
SUAPI
WALLET
Fields required for the OneShot solution
Payment method name
country
amount
payer[]
payment_method
All
Yes
Yes
Yes
Yes
payer[] object requirements
payer[] object requirementsPayment method name
document
email
first_name
last_name
phone
address[]
Boleto
Yes
Yes
Yes
Yes
No
Yes
Banco do Brasil
Yes
Yes
Yes
Yes
No
Yes
Itaú
Yes
Yes
Yes
Yes
No
Yes
PicPay
Yes
Yes
Yes
Yes
Yes
No
All the other payment methods
Yes
Yes
Yes
Yes
No
No
address[] object requirements
address[] object requirementsPayment method name
Required for deposits above
street
city
state
zip_code
Boleto
USD 3000
Yes
Yes
Yes
Yes
Banco do Brasil
USD 200
Yes
Yes
Yes
Yes
Itaú
USD 200
Yes
Yes
Yes
Yes
Other fields not in these lists are optional.
If any of the required fields are missing the HOSTED flow will be triggered
HOSTED flow will be triggeredIn that case you will receive the HOSTED value in the checkout_type parameter.
You will have to redirect the user to the redirect_url
Payment flows
Pix
The user selects Pix and chooses the option “Copia e Cola.” A payment code is generated, which they copy and paste into their bank app under the Pix section. After confirming the transaction, the payment is completed instantly.
Last updated
Was this helpful?