post https://apisandbox.braspag.com.br/v2/sales/
Environment | Method | Endpoint |
---|---|---|
Sandbox | post | https://apisandbox.braspag.com.br/v2/sales/ |
Production | post | https://api.braspag.com.br/v2/sales/ |
For the Sandbox environment, use the value "Simulado" in the
Payment.Provider
field.
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 | Santander | Caixa Econômica | Citibank |
---|---|---|---|---|---|---|
Provider | Bradesco2 | BancoDoBrasil2 | ItauShopline | Santander2 | Caixa2 | Citibank2 |
MerchantOrderId | 27 (*1 ) | 50 | 8 | 50 | 11 (*2 ) | 10 (*2 ) |
Payment.BoletoNumber | 11 (*3 ) | 9 (*4 ) | 8 (*5 ) | 13 (*3 ) | 12 (*6 ) | 11 (*7 ) |
Customer.Name | 34 | 60 (*8 ) | 30 | 40 | 40 | 50 (*9 ) |
Customer.Address.Street ; Customer.Address.Number ; Customer.Address.Complement ; Customer.Address.District | Street: 70 Number: 10 Complement: 20 District: 50 | Total up to 60 characters (*8 ) | Street, Number and Complement must total up to 40 characters District: 15 | Street, Number and Complement must total up to 40 characters District: 15 | Street, Number e Complement must total up to 40 characters District: 15 | Street, Number e Complement must total up to 40 characters District: 50 ( *9 ) |
Customer.Address.City | 50 | 18 (*8 ) | 15 | 30 | 15 | 50 (*9 ) |
Payment.Instructions | 450 | 450 | N/A | 450 | 450 | 450 |
Payment.Demonstrative | 255 | N/A | N/A | 255 | 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
DigitableLine
parameter is not returned for Banco do Brasil boleto;