curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/payment-initialization' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"payload": "00020101021226820014br.gov.bcb.pix2560pix-h.delbank.com.br/v2/cob/vchargeffab8b4c963344c283e491f5e5204000053039865802BR5907DELBANK6007ARACAJU62070503***6304CB42"
}'
{
"key": "5b0ac9a4-fad6-43f9-be70-6d7c9a2fad26",
"endToEndId": "E3822485720230801135525927150397",
"transactionId": "vchargeffab8b4c963344c283e491f5e",
"expirationTime": 1800,
"allowChangeAmount": false,
"categoryCode": "0000",
"type": "DYNAMIC_IMMEDIATE_PAYMENT",
"initiationType": "QR_CODE_DYNAMIC",
"status": "ACTIVE",
"amount": 99.90,
"originalAmount": 99.90,
"capturedAt": "2024-12-20T14:00:00.000Z",
"beneficiary": {
"number": "29823",
"branch": "0001",
"type": "CURRENT",
"participant": {
"name": "DELBANK",
"ispb": "38224857"
},
"holder": {
"name": "EMPRESA RECEBEDORA LTDA",
"document": "30287697789",
"type": "NATURAL"
}
}
}
Pix
Inicializar Pagamento por QR Code
Decodifica o payload de um QR Code Pix e retorna os dados da cobrança e o endToEndId para executar o pagamento.
POST
/
pix
/
qrcode
/
payment-initialization
curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/payment-initialization' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"payload": "00020101021226820014br.gov.bcb.pix2560pix-h.delbank.com.br/v2/cob/vchargeffab8b4c963344c283e491f5e5204000053039865802BR5907DELBANK6007ARACAJU62070503***6304CB42"
}'
{
"key": "5b0ac9a4-fad6-43f9-be70-6d7c9a2fad26",
"endToEndId": "E3822485720230801135525927150397",
"transactionId": "vchargeffab8b4c963344c283e491f5e",
"expirationTime": 1800,
"allowChangeAmount": false,
"categoryCode": "0000",
"type": "DYNAMIC_IMMEDIATE_PAYMENT",
"initiationType": "QR_CODE_DYNAMIC",
"status": "ACTIVE",
"amount": 99.90,
"originalAmount": 99.90,
"capturedAt": "2024-12-20T14:00:00.000Z",
"beneficiary": {
"number": "29823",
"branch": "0001",
"type": "CURRENT",
"participant": {
"name": "DELBANK",
"ispb": "38224857"
},
"holder": {
"name": "EMPRESA RECEBEDORA LTDA",
"document": "30287697789",
"type": "NATURAL"
}
}
}
Para o passo a passo completo, veja o guia Pagar via QR Code.
POST /transfers, incluindo o endToEndId e o initiationType correto.
Headers
string
required
Sua API key.
string
required
Número da conta Delfinance.
Body
string
required
O conteúdo textual do QR Code — também chamado de “Pix Copia e Cola” ou BR Code. É a string que começa com
000201....Response
string
Identificador único de uso único. Deve ser enviado no
POST /transfers para efetivar o pagamento.string
Identificador de conciliação do QR Code gerado pelo recebedor. Deve ser enviado no
POST /transfers junto com o endToEndId.string
Chave Pix do recebedor vinculada ao QR Code.
string
Tipo do QR Code. Valores possíveis:
QR_CODE_STATIC— QR Code EstáticoDYNAMIC_IMMEDIATE_PAYMENT— QR Code Dinâmico imediatoDYNAMIC_PAYMENT_WITH_EXPIRATION— QR Code Dinâmico com vencimento
string
Tipo de iniciação que deve ser usado no campo
initiationType do POST /transfers. Valores possíveis: QR_CODE_STATIC ou QR_CODE_DYNAMIC.string
Estado atual do QR Code:
ACTIVE— pode ser pagoCONCLUDED— já foi pagoREMOVED_BY_THE_RECEIVER— cancelado pelo recebedorREMOVED_BY_PSP— cancelado pela instituição
number
Valor da cobrança.
number
Valor original antes de eventuais ajustes.
boolean
Indica se o valor pode ser alterado pelo pagador.
number
Tempo restante de validade do QR Code em segundos (para QR Codes Dinâmicos).
string
Código de categoria do recebedor. Padrão:
"0000".string
Instante em que o payload foi capturado por esta requisição, em ISO 8601.
object
Dados da conta do recebedor.
array
Informações adicionais incluídas no QR Code pelo recebedor.
curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/qrcode/payment-initialization' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"payload": "00020101021226820014br.gov.bcb.pix2560pix-h.delbank.com.br/v2/cob/vchargeffab8b4c963344c283e491f5e5204000053039865802BR5907DELBANK6007ARACAJU62070503***6304CB42"
}'
{
"key": "5b0ac9a4-fad6-43f9-be70-6d7c9a2fad26",
"endToEndId": "E3822485720230801135525927150397",
"transactionId": "vchargeffab8b4c963344c283e491f5e",
"expirationTime": 1800,
"allowChangeAmount": false,
"categoryCode": "0000",
"type": "DYNAMIC_IMMEDIATE_PAYMENT",
"initiationType": "QR_CODE_DYNAMIC",
"status": "ACTIVE",
"amount": 99.90,
"originalAmount": 99.90,
"capturedAt": "2024-12-20T14:00:00.000Z",
"beneficiary": {
"number": "29823",
"branch": "0001",
"type": "CURRENT",
"participant": {
"name": "DELBANK",
"ispb": "38224857"
},
"holder": {
"name": "EMPRESA RECEBEDORA LTDA",
"document": "30287697789",
"type": "NATURAL"
}
}
}