Environment | Method | Endpoint |
|---|---|---|
Sandbox | post |
|
Production | post |
|
For the Sandbox environment, use the value "Simulado" in the
Payment.Providerfield.
Specific Rules by Issuer
The following is a list of properties and their size specifications, related to different rules for each issuer and their respective providers:
Property | Bradesco | Banco do Brasil | Itaú Shopline | Itaú API | Santander | Citibank |
|---|---|---|---|---|---|---|
| Bradesco2 | BancoDoBrasil2 | ItauShopline | Itau3 | Santander2 | Citibank2 |
| 27 ( | 50 | 8 | 8 | 50 | 10 ( |
| 11 ( | 9 ( | 8 ( | 8 ( | 13 ( | 11 ( |
| 34 | 60 ( | 30 | 30 | 40 | 50 ( |
| Street: 70 | Total up to 60 characters ( | Street, Number and Complement must total up to 40 characters | Street, Number and Complement must total up to 40 characters | Street, Number and Complement must total up to 40 characters | Street, Number e Complement must total up to 40 characters |
| 50 | 18 ( | 15 | 15 | 30 | 50 ( |
| 450 | 450 | N/A | N/A | 450 | 450 |
| 255 | N/A | N/A | N/A | 255 | 255 |
| Remarks | Details |
|---|---|
*1 | Only letters, numbers, and characters like "_" and "$". |
*2 | If it exceeds 11 digits, the API will generate an incremental number from the defined configuration. |
*3 | The value must be unique, i.e., the bank does not allow repeating previously used values. |
*4 | When submitted with over 9 positions, the API considers the last 9 digits. |
*5 | Must always be the same as the order number (MerchantOrderId). |
*6 | The API automatically concatenates the value “14” + 12 free digits + check digit, before sending it to the bank. If the total exceeds 14 digits, the API considers the last 14 digits. |
*7 | When the number sent exceeds the maximum number, the API generates a random number. |
*8 | The following are accepted as valid characters: numbers, letters A to Z (UPPERCASE) and conjunction special characters (hyphen "-" and apostrophe "'". When used, there must be no space between letters. Correct examples: D'EL-REI / D'ALCORTIVO / SANT'ANA. Incorrect examples: D'EL - REI / a space between words. |
*9 | Special characters and diacritics will be removed automatically. |
Additional rules for Banco do Brasil boleto:
- The
DigitableLineparameter is not returned for Banco do Brasil boleto;