Pular para o conteúdo principal

Realizar Transação Pix em Lote

A QI Tech oferece a possibilidade de realizar várias transações pix com uma única chamada. Nesse sistema as transações são realizadas de forma assíncrona. Caso na chamada inicial seja retornado um http status 4xx, nenhuma das transações será realizada. Após a solicitação, o parceiro integrador receberá um webhook para cada transação informando o status final da tentativa, podendo ser rejected ou sent.

Request

ENDPOINT
/account/ACCOUNT_KEY/pix_transfer_batch
MÉTODO
POST
{
"request_control_key": "6e4fc980-f8a1-4462-b6e2-d8a49f0ac055",
"pix_transfers": [
{
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"pix_transfer_type": "key",
"target_pix_key": "target_pix_key@email.com",
"transaction_amount": 500.65,
"end_to_end_id": "E73856642202309201429bZKfklNlbwu",
"pix_message": "Ola Mundo"
},
{
"request_control_key": "5fb20e2e-78e3-4ca7-bb36-515640ec2e78",
"pix_transfer_type": "manual",
"target_account": {
"account_branch": "0001",
"account_digit": "3",
"account_number": "12345678",
"owner_document_number": "32402502000135",
"owner_name": "Qi Tech",
"account_type": "checking_account",
"ispb": "32402502"
},
"transaction_amount": 500.65,
"pix_message": "Ola Mundo"
},
{
"request_control_key": "10ad6e08-1a4c-403c-8122-178b0acf1dfa",
"pix_transfer_type": "static_qr_code",
"transaction_amount": 500.65,
"end_to_end_id": "E73856642202309201429bZKfklNlbrb",
"receiver_conciliation_id": "REC00000000000000000000009459463343",
"target_pix_key": "target_pix_key@email.com",
"pix_message": "Ola Mundo"
}
]
}

Path Params

CampoTipoDescriçãoCaracteres
account_keyuuidv4Chave única de identificação da conta.36

Body Params

CampoTipoDescriçãoCaracteres
request_control_key *uuidv4Chave única de identificação da request utilizada pelo cliente no formato uuid v4.36
pix_transfers *arrayLista de objetos pix_transfer vinculados ao lote.lista de Objeto pix_transfer

Objeto pix_transfer

CampoTipoDescriçãoCaracteres
request_control_key *uuidv4Chave única de identificação da request utilizada pelo cliente no formato uuid v4.36
pix_transfer_type *enumeratorTipo do pix a ser realizado.Enumerador pix_transfer_type
target_pix_keystringChave pix da conta a ser enviada a transação.100
target_accountObjectConta destino - Só deve ser enviada em transferências com pix_transfer_type do tipo manual.Objeto target_account
receiver_conciliation_idstringIdenticação de conciliação do recebedor.35
transaction_amount *numberValor da transferência.10
end_to_end_idstringChave de idempotência de uma transação Pix dentro do SPI (Sistema de Pagamento Instantâneo). Esta chave é retornada na consulta de chave Pix. Só deve ser enviado se o pix_transfer_type for key, static_qr_code ou static_qr_code32
pix_messagestringMensagem a ser enviada junto à transferência Pix.140

Objeto target_account

CampoTipoDescriçãoCaracteres
account_branch *stringAgência da conta.6
account_digit *stringDígito da conta.1
account_number *stringNúmero da conta.20
owner_document_number *stringCPF ou CNPJ (apenas números) do titular da conta.14
owner_name *stringNome do titular da conta.150
account_type*enumeratorTipo da conta.Enumerador account_type
ispb *stringBase no CNPJ da instituição financeira (8 dígitos).8

Enumerador account_type

EnumeradorDescrição
checking_accountConta Corrente
salary_accountConta Salário
saving_accountConta Poupança
payment_accountConta de Pagamentos

Enumerador pix_transfer_type

EnumeradorDescrição
manualPix utilizando os dados da conta destino. Obrigatório enviar target_account
keyPix utilizando uma chave pix. Obrigatório enviar target_pix_key. Recomendado enviar end_to_end_id da consulta de chave pix caso tenha sido realizada
static_qr_codePix utilizando um QR code estático. Obrigatório enviar o end_to_end_id retornado na decodificação do QR code
dynamic_qr_codePix utilizando um QR code dinâmico. Obrigatório enviar o end_to_end_id retornado na decodificação do QR code

Response

STATUS
201
Response Body: Transferência em lote Aprovada
{
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"pix_transfer_batch_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"pix_transfer_batch_status": "approved"
}

Enumerador pix_transfer_batch_status

EnumeradorDescrição
approvedTransferência em lote aprovada e transações em processo de execução.
rejectedTransferência em lote rejeitada
pending_2fa_approvalTransferência em lote pendente de aprovação manual
STATUS
4xx
Response Body: Transferência Rejeitada
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {
"pix_transfer_batch_data": {
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"pix_transfer_batch_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"pix_transfer_batch_status": "rejected"
}
}
}
STATUS
4xx
Response Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {}
}
Informação

Os erros anteriormente listados para transferência Pix são passiveis de serem retornados por este endpoint.