# Brazil {% hint style="warning" %} *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.* {% endhint %} ### Country specifications

country code currency code amount decimals document name document format document required?

country code	currency code	amount decimals	document name	document format	document required?
`BR`	`BRL` and `USD`	2	CPF	Numeric. Length 11 (Validate verifier-digits)	Yes

BR

BRL and USD

CPF

Numeric.

Length 11

(Validate verifier-digits)

Yes

### Card features

Card-on-file	Subscriptions	3DS	Installments	Authorization and Capture
true	true	true	true	false

*** ### 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 {% hint style="success" %} ### `payment_method` code `CC` As 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. {% endhint %}

Logo	payment_method	Name
	`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

payment_method	Name	payment_type	Available for test
`IX`	Pix	`BANK_TRANSFER`	Embbeded, Redirect
`PP`	PicPay	`VOUCHER`	Embbeded, Redirect
`BB`	Banco do Brasil	`BANK_TRANSFER`	Embbeded, Redirect
`CA`	Caixa	`BANK_DEPOSIT`	Embbeded, Redirect
`I`	Itaú	`BANK_TRANSFER`	Embbeded, Redirect
`B`	Bradesco	`BANK_TRANSFER`	Embbeded, Redirect
`SB`	Santander	`BANK_DEPOSIT`	Embbeded, Redirect
`BZ`	Banco Original	`BANK_DEPOSIT`	Embbeded, Redirect
`SF`	Banco Safra	`BANK_DEPOSIT`	Embbeded, Redirect
`UL`	Banrisul	`BANK_DEPOSIT`	Embbeded, Redirect
`NU`	Nubank	`BANK_TRANSFER`	Embbeded, Redirect
`ME`	MercadoPago	`BANK_TRANSFER`	Embbeded, Redirect
`ICSH`	iCash	`VOUCHER`	Embbeded, Redirect
SUA	SUAPI	`WALLET`	Redirect

#### Fields required for the [OneShot](/guides/deposits/solutions/oneshot.md) solution

Payment Method Name	country	amount	payer[]	payment_method
Payment method name	`country`	`amount`	`payer[]`	`payment_method`
All	Yes	Yes	Yes	Yes

#### `payer[]` object requirements

Payment Method Name	document	email	first_name	last_name	phone	address[]
Payment 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

Payment Method Name	Required for deposits above	street	city	state	zip_code
Payment 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

{% hint style="success" %} Other fields not in these lists are optional. {% endhint %} {% hint style="info" %} ### If any of the required fields are missing the `HOSTED` flow will be triggered In that case you will receive the `HOSTED` value in the `checkout_type` parameter.\ You will have to redirect the user to the `redirect_url` {% endhint %} *** ### 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.pandablue.com/guides/deposits/payment-methods/america/brazil.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.