Pix com dados bancários (Pix manual)
É possível realizar um Pix sem uma Chave, basta informar os dados bancários do cliente (semelhante a uma TED). Nesse cenário, você não precisa utilizar o endpoint de Inicialização de Pagamento, basta preencher os dados do payload e enviar a quantia desejada.
Requisição
POST 'https://apisandbox.delbank.com.br/baas/api/v2/transfers'
curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transfers' \
--header 'IdempotencyKey: 9d16ea35-8a85-49ea-a41e-bcf56c677129' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-delbank-api-key: PJPyJ2xGmyB9oDHyNIUwNOt1dgpgolBwcE16ybaKD5rYEc8ujLtarBP0nNw2FKdgK+5YJFciFwTdORlZsdaTzjEbKN5ut+Ag4xGy69bbtXJmzkzRDHry9ubYbMW4xFMb' \
--data '
{
"amount": 0.55,
"description": "manual xptop",
"beneficiary": {
"number": "10138",
"branch": "0001",
"type": "CURRENT",
"participantIspb": "38224857",
"holder": {
"document": "10613462939",
"name": "DOUGLAS ABREU DE VINÍCIUS",
"type": "NATURAL"
}
}
}'
Cabeçalhos (Headers)
Nome | Descrição |
---|---|
x-delbank-api-key | Obrigatório. Chave de API |
IdempotencyKey | Obrigatório. Chave idempotência da requisição. Informe um GUID, sendo um novo cada requisição. |
Corpo da requisição (Body)
Nome | Tipo | Descrição |
---|---|---|
amount | number | Obrigatório. Valor da transferência |
description | string | Descrição sobre a transferência. Essa informação será mostrada a conta beneficiária |
beneficiary | object | Obrigatório. Objeto que contém as informações da conta do beneficiário (cliente recebedor) |
beneficiary.number | string | Obrigatório. Número da conta do cliente beneficiário |
beneficiary.branch | string | Obrigatório. Agência da conta do cliente beneficiário |
beneficiary.type | enum | Obrigatório.Tipo da conta do cliente beneficiário. Domínios:CURRENT - Conta CorrentePAYMENT - Conta PagamentoSAVING - Conta PoupançaSALARY - Conta Salário |
beneficiary.participantIspb | string | Obrigatório. Código ISPB da conta do cliente beneficiário |
beneficiary.holder | object | Obrigatório. Objeto que contém as informações do titular da conta do beneficiário |
beneficiary.holder.document | string | Obrigatório. Nome do titular |
beneficiary.holder.name | string | Obrigatório. Documento (CPF/CNPJ) do titular |
beneficiary.holder.type | enum | Obrigatório.Tipo da pessoa titular da conta do beneficiário. Domínios:NATURAL - Pessoa FísicaLEGAL - Pessoa Jurídica |
Resposta (Response)
O status code 200
indicará sucesso na transação.
Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:
Essas informações serão retornadas após a
criação da transferência
econsulta da transferência
.
{
"id": "0fc7821d-b488-4268-88c0-a2bc443d046e",
"endToEndId": "E3822485720230808004731LMaDWkOcM",
"transactionNsu": 722355,
"status": "PIX_PROCESSING",
"type": "PIX_MANUAL",
"amount": 0.55,
"createdAt": "2023-08-08T00:47:31.251Z",
"description": "manual JD",
"payer": {
"number": "31712",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "32752023000149",
"name": "bxxdbde",
"type": "LEGAL"
},
"participant": {
"name": "DELBANK",
"ispb": "38224857"
}
},
"beneficiary": {
"number": "46441",
"branch": "0007",
"type": "CURRENT",
"holder": {
"document": "01234567890",
"name": "OTAVIO BARBOSA",
"type": "NATURAL"
},
"participant": {
"name": "BANCO DA AMAZONIA S.A.",
"ispb": "04902979"
}
}
}
Para mais informações
Para mais informações e simulações de requisição deste endpoint, acesse o API Reference.