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:
Field | Description | About |
---|---|---|
transactionId | Transaction 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 . |
initiationType | Type 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 thepayment initiation
response will be used as thetransactionId
in making the payment, and thetype
of value of thepayment initiation
response will be used as theinitiationType
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"
}
}
}