Skip to main content

Composite QR code payment

Decode Composite QR code

Decoding a composite QR code will use the same endpoints as decoding a normal Pix QR code

Request

POST 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/payment-initialization'

Body

{
"payload": "00020101021226850014br.gov.bcb.pix2563pix-h.delbank.com.br/v1/qrcode/charge3rRpryWmbSbn0FxuhHDeF4ngLE5204000053039865802BR5925HOMOLOGACAO INTEGRACAO AP6007ARACAJU62070503***63049D66"
}

Response example

{
"key": "5b0ac9a4-fad6-43f9-be70-6d7c9a2fad26",
"endToEndId": "E3822485720230801135525927150397",
"transactionId": "chargerNAuMldwyUFH5TXacb8rQ8EH1F",
"expirationTime": 60,
"allowChangeAmount": false,
"categoryCode": "0000",
"createdAt": "2023-07-13T20:38:34.272Z",
"capturedAt": "2023-08-01T13:55:25.934Z",
"type": "DYNAMIC_IMMEDIATE_PAYMENT",
"initiationType": "QR_CODE_DYNAMIC",
"status": "CONCLUDED",
"amount": 0.12,
"originalAmount": 0.12,
"payer": {
"name": "FULANO CICLANO",
"document": "16166823533"
},
"beneficiary": {
"number": "29823",
"branch": "0001",
"type": "CURRENT",
"participant": {
"name": "DELBANK",
"ispb": "38224857"
},
"holder": {
"name": "HOMOLOGACAO INTEGRACAO API",
"document": "30287697789",
"type": "NATURAL"
}
},
"additionalInfos": [
{
"name": "Campo 1",
"value": "Informação Adicional1 do PSP-Recebedor"
},
{
"name": "Campo 2",
"value": "Informação Adicional2 do PSP-Recebedor"
}
]
}

Carrying out the payment

Utilizes the endToEndId while carrying out the payment initialization. Remembering that the "endToEndId" expires and it will only be utilized once.

The payment is like the key with a key, adding a few informations listed below:

FieldDescriptionAbout
transactionIdTransaction Id utilized while generating the QR Code by the beneficiary client. This will be used in the conciliation process.This value will be returned after the QR Code payment initialization. Provide the value that will be in the field transactionId.
initiationTypeType of initialization utilized by the payment.This will be filled in according to the type of QR Code/Payload returned by the payment initialization consulting. Possible values:
- QR_CODE_STATIC
- QR_CODE_DYNAMIC
In case the type is QR_CODE_STATIC, use initiationType as QR_CODE_STATIC. Otherwise, send the initiationType as QR_CODE_DYNAMIC.

In summary, the transactionId value of the payment initiation response will be used as the transactionId in making the payment, and the type of value of the payment initiation response will be used as the initiationType in making the payment.

Related to converting the QR Code/Payload initiation type to the initialization type when making the payment.

  • QR_CODE_STATIC -> QR_CODE_STATIC
  • DYNAMIC_IMMEDIATE_PAYMENT -> QR_CODE_DYNAMIC
  • DYNAMIC_PAYMENT_WITH_EXPIRATION -> QR_CODE_DYNAMIC

Request

POST 'https://apisandbox.delbank.com.br/baas/api/v2/transfers'

Body

{
"amount": 0.12,
"description": "description",
"endToEndId": "E3822485720230801135525927150397",
"transactionId": "charge3rRpryWmbSbn0FxuhHDeF4ngLE",
"initiationType": "QR_CODE_DYNAMIC"
}

Response example

{
"id": "ea381676-6673-420a-8eea-a89d7b3edb20",
"endToEndId": "E3822485720230801135525927150397",
"transactionNsu": 721963,
"status": "PIX_PROCESSING",
"type": "PIX_QR_CODE_DYNAMIC",
"amount": 0.12,
"createdAt": "2023-08-01T14:08:12.162Z",
"description": "description",
"payer": {
"number": "31712",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "32752023000149",
"name": "bxxdbde",
"type": "LEGAL"
},
"participant": {
"name": "DELBANK",
"ispb": "38224857"
}
},
"beneficiary": {
"number": "29823",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "30287697789",
"name": "HOMOLOGACAO INTEGRACAO API",
"type": "NATURAL"
},
"participant": {
"name": "DELBANK",
"ispb": "38224857"
}
}
}