First of all, it is important to understand what are payment slips and how they work.
Payment slip is a document strongly used in Brazil as a payment method, standardized by the Brazilian Federation of Banks (FEBRABAN). Through a payment slip, either virtual or printed, the issuer (payee or beneficiary) of the document receives the amount determined on it in their account.
See the payment slip example on the image below. The description of the fields is shown in the following sections.
To generate a payment slip it is mandatory to fill out the fields in the table below:
Logo of the bank that generated the payment slip. It may also contain the logo of the payment slip's Receiving Institution.
Bank Prefix Number
Prefix number of the bank that generated the payment slip. It must include the verifying digit, separated by an hyphen (-).
Number referring to the barcode, also known as "Linha Digitável". This number can be used to validate the payment slip.
Place of Payment
Places where the payment slip can be paid.
Payee (or beneficiary)
It is the party to whom the payment slip is generated. This entity will receive the payment
It is the party designated to pay the payment slip.
Guarantor Drawer or Co Beneficiary
Also known as "Beneficiário Final", it is the party designated to intermediate the payment slip. Normally, the guarantor drawer and the payee are the same, but there are some cases where the guarantor drawer is a third-party.
Bar code used to validate the payment slip. It must follow a pattern according to FEBRABAN's documentation.
Expiration date of the payment slip. Based on this date, the payment slip is liable to discounts, fines, and interests.
Amount for which the payment slip was generated.
The fields below, although not necessary to generate a payment slip, can be used to improve users' payment experience.
Date when the document that generated the payment slip was issued.
Instructions about how to handle the payment slip.
Bank Branch/Beneficiary Code
Prefix number of the bank branch that generated the payment slip and payee or product account number.
"Our Number"/Document Code
Identification code of the billing that generated the payment slip followed by the number of the document used by Dock when signed the contract with the partner bank.
Discounts referring to the payment slip amount.
Other deductions referring to the payment slip amount.
Fines and Interests
Fines and interests that the payment slip is liable to.
Other increases that the payment slip is liable to.
Total amount of the payment sli (document amount - discounts - other deductions + fares + interests + other increases).
Billing modality used to generate the payment slip. This field will always come as 500 on Payment Slip API.
Abbreviation of the currency used to generate the payment slip.
Type of document used to generate the payment slip, which can be:\
Indicates if the payer has signed a document taking responsability of paying the payment slip. It allows the payee to contest the payment slip on the court.
It is the date when the payment slip was generated.
Updated 4 months ago