> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.bridge.xyz/llms.txt
> Use this file to discover all available pages before exploring further.
# BRL integration guide
To access BRL and the Pix payment rail, please reach out to our team at [sales@bridge.xyz](mailto:sales@bridge.xyz)
## Transaction Minimums and Limits
We require a minimum transaction amount of **10 BRL** with no maximum limit.
## 🇧🇷 What we support
* [Virtual Accounts](https://apidocs.bridge.xyz/platform/orchestration/virtual_accounts/virtual-account#brl) - Accept BRL via Pix payments from 1st and approved 3rd parties.
* [Transfers](https://apidocs.bridge.xyz/platform/orchestration/transfers/transfer#create-transfer) - Receive BRL via Pix payins from 1st and approved 3rd parties, make payouts to any recipient.
* [Liquidation Addresses](https://apidocs.bridge.xyz/platform/orchestration/liquidation_address/liquidation_address#multichain-%2B-multicurrency) - Offramps from stablecoin or crypto to BRL via Pix.
* [Supported Countires](https://apidocs.bridge.xyz/platform/customers/compliance/supported-countries-list) - We support PIX on/offramps for customers in +100 countries.
## Related APIs
* [Pix Endorsement](https://apidocs.bridge.xyz/platform/customers/customers/endorsements#pix-endorsement) required to use the BRL currency and Pix payment rail. If a customer already has the base endorsement, they should also have all of the info needed to grant the Pix endorsement.
* **Important:** As of June 15, 2026 new requirements take into effect for the PIX endorsement. Please reference [BRL Migration Guide](https://apidocs.bridge.xyz/platform/customers/customers/brl-ramp-migration-guide) for more information.
* Create a [BRL Virtual Account](https://apidocs.bridge.xyz/platform/orchestration/virtual_accounts/virtual-account#brl) to onramp funds using a unique account number
* Create a [Pix External Account](https://apidocs.bridge.xyz/platform/orchestration/external-accounts/external-accounts-api#pix-key) to use as a [Transfer](https://apidocs.bridge.xyz/platform/orchestration/transfers/transfer#create-transfer) or [Liquidation Address](https://apidocs.bridge.xyz/platform/orchestration/liquidation_address/liquidation_address#multichain-%2B-multicurrency) offramp destination. We do not allow our BRL Virtual Accounts as an offramp destination.
## Logistics
* **Onramp minimum 20 RBL**
* **Offramp minimum 20 BRL**
* Customer-specific volume limit of \$500k USD-equivalent per month, with enhanced KYC/B required to increase (contact account manager).
* 1st and 3rd party payouts supported
* 1st party payins supported, 3rd party payins supported from businesses.
* Pix on/offramps complete in \~5 minutes however may take up to 30 minutes for transactions >\$50k.
* **Non-Brazilian individual customers (determined by their tax ID)** can access BRL offramps (payouts) however do not have access to BRL onramps (virtual accounts / deposits). **Non-Brazilian business customers can access on and off ramps.**
## Best Practices:
* We currently do not support BR Codes with static amounts.
* When configuring an [External Account](https://apidocs.bridge.xyz/platform/orchestration/external-accounts/external-accounts-api#external-accounts)., ensure that all Pix Keys generated via EVP are entered in **lowercase**.
## KYC Requirements by Customer Type
**Standard KYC individual** customers can provide any missing data either using our [Hosted KYC Link](https://apidocs.bridge.xyz/api-reference/customers/retrieve-a-hosted-kyc-link-for-an-existing-customer), or developers can submit directly via our [Customers API](https://apidocs.bridge.xyz/api-reference/customers/update-a-single-customer-object).
| Likely Missing | How to collect |
| :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------- |
| Tax ID
- For BR: Brazilian tax number (CPF)
- For Non-BR: Passport ID | KYC link or `identifying_information` with `type: cpf, passport, or national_id` |
| Tax ID country | KYC link or `identifying_information` with `issuing_country` |
| Phone number | KYC link or`phone `field |
| Selfie | KYC link, or Customer API `liveness_check_selfies` field |
**Standard KYC business** customers can provide any missing data either using our [Hosted KYC Link](https://apidocs.bridge.xyz/api-reference/customers/retrieve-a-hosted-kyc-link-for-an-existing-customer), or developers can submit directly via our [Customers API](https://apidocs.bridge.xyz/api-reference/customers/update-a-single-customer-object).
| Likely missing | How to collect |
| :------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tax ID
- For BR: Brazilian tax number (CNPJ)
- For Non-BR: Any tax ID number | KYC link or `identifying_information` with `type: cnpj, ein or `[other available options](https://apidocs.bridge.xyz/api-reference/customers/create-a-customer#body-one-of-1-associated-persons-items-identifying-information)`.` |
| Tax ID country | KYC link or `identifying_information` with `issuing_country` |
| Phone number | KYC link or`phone `field |
| Date of incorporation | KYC link or `incorporation_date` field |
| UBO phone number (per UBO) | KYC link or `associated_persons.phone `field |
| Business Formation Document | Customer API`business_formation `field |
| Proof of Source of Funds Document | Customer API `proof_of_source_of_funds `field |
| Business Address | Customer API `registered_address `field with `street_line_1,city, country` |
| Proof of Address Document
- Utility bill, bank statement | Customer API `proof_of_address `field |
**Reliance individual** customers can provide any missing data either using our [Hosted KYC Link](https://apidocs.bridge.xyz/api-reference/customers/retrieve-a-hosted-kyc-link-for-an-existing-customer), or developers can submit directly via our [Customers API](https://apidocs.bridge.xyz/api-reference/customers/update-a-single-customer-object).
| Required | How to collect |
| :------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------- |
| Tax ID
- For BR: Brazilian tax number (CPF)
- For Non-BR: Passport ID | Customer API `identifying_information` with `type: cpf, passport, or national_id` |
| Tax ID country | Customer API `identifying_information` with `issuing_country` |
| Phone number | Customer API `phone` field |
| Selfie | Customer API `liveness_check_selfies` field (array of base64 data URIs) |
| Government ID image | Customer API `identifying_information` with `image_front` |
Images (gov ID and selfie) must be JPEG, PNG, or HEIC format, minimum 200x200px, maximum 15MB.
**Reliance business** customers can provide any missing data either using our [Hosted KYC Link](https://apidocs.bridge.xyz/api-reference/customers/retrieve-a-hosted-kyc-link-for-an-existing-customer), or developers can submit directly via our [Customers API](https://apidocs.bridge.xyz/api-reference/customers/update-a-single-customer-object).
| Required | How to collect |
| :------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tax ID
- For BR: Brazilian tax number (CNPJ)
- For Non-BR: Any tax ID number | Customer API `identifying_information` with `type: cnpj, ein or `[other available options](https://apidocs.bridge.xyz/api-reference/customers/create-a-customer#body-one-of-1-associated-persons-items-identifying-information)`.` |
| Tax ID country | Customer API `identifying_information` with `issuing_country` |
| Phone number | Customer API `phone` field |
| Date of incorporation | Customer API `incorporation_date` field |
| UBO phone number (per UBO) | [Associated Persons API](/api-reference/customers/associated-persons/update)`phone` field on each UBO |
| UBO government ID image (per UBO) | [Associated Persons API](/api-reference/customers/associated-persons/update)`identifying_information` on each UBO with `image_front` |
| UBO tax number (per UBO) | [Associated Persons API](/api-reference/customers/associated-persons/update)`identifying_information` on each UBO with type `cpf` |
| Business Formation Document | Customer API`business_formation `field |
| Proof of Source of Funds Document | Customer API `proof_of_source_of_funds `field |
| Business Address | Customer API `registered_address `field with `street_line_1,city, country` |
| Proof of Address Document
- Utility bill, bank statement | Customer API `proof_of_address `field
|