Transações na QI Conta
No contexto de cartão pré-pago, as situações de débito ou crédito possuem um reflexo na QI Conta do portador do cartão. Essas transações são representadas pela entidade Balance Transaction. Essas transações devem obrigatoriamente ser executadas na QI Conta do portador mesmo que tardiamente. Sendo assim, caso um débito não possa ser efetuado por algum motivo, a Balance Transaction ficará pendente e será retentada automaticamente pelo sistema da QI até que todo o valor seja debitado.
É importante que essas transações sejam acompanhadas e caso alguma Balance Transaction persista em pendência o cliente deve entrar em contato com o portador do cartão para assegurar que a QI Conta esteja apta e com o saldo necessário para cobrir essa pendência.
Sempre que uma Balance Transaction for criada, um webhook de Balance Transaction Event será enviado.
Webhook de evento de transação na QI Conta
{
"key": "cccbd9e9-863f-44b5-aa05-f6afa555bb74",
"data": {
"balance_transaction_key": "cccbd9e9-863f-44b5-aa05-f6afa555bb74",
"transaction_key": "b64c1ca5-095d-4005-a4ed-3be09d7b111f",
"amount": 25.32,
"transacted_at": "2023-07-24T12:00:00.000Z",
"balance_transaction_status": "transacted"
},
"webhook_type": "prepaid_card.balance_transaction_event",
"event_datetime": "2023-07-24T12:00:00.000Z"
}
Details
| Campo | Tipo | Descrição |
|---|---|---|
balance_transaction_key | string | Identificador único da Requisição de Autorização |
transaction_key | string | Identificador único da entidade Autorização relacionada com esta requisição |
amount | string | O valor transacionado na QI Conta neste evento |
transacted_at | string | O horário que a transação foi executada |
balance_transaction_status | string | O estado da Balance Transaction após este evento |
O balance_transaction_status descreve se a transação foi executada na QI Conta do portador do cartão, podendo estar pendente (pending_transaction_execution), parcialmente transacionada (partially_transacted) ou transacionada (transacted)
Os webhooks da QI Tech não devem ser mapeadas de forma restrita. Campos adicionais podem ser incluídos aos payloads dos webhooks retornados em nossas APIs.
A consulta e reenvio de webhooks pode ser feito conforme documentação: Reenvio de webhooks