QI Conta 交易

在预付卡场景中，借记或贷记操作会反映在持卡人的 QI Conta 上。这些交易由 Balance Transaction 实体表示。这些交易必须在持卡人的 QI Conta 上执行，即使存在延迟。因此，若某笔借记因任何原因无法执行，Balance Transaction 将保持待处理状态，并由 QI 系统自动重试，直到全部金额被扣除。

跟踪这些交易非常重要，若某笔 Balance Transaction 长期处于待处理状态，客户应联系持卡人，确保 QI Conta 处于可用状态且有足够余额来处理该待付款项。

每当创建 Balance Transaction 时，系统将发送 Balance Transaction Event webhook。

QI Conta 交易事件 Webhook

{
	"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"
}

详情

字段	类型	描述
`balance_transaction_key`	string	授权请求的唯一标识符
`transaction_key`	string	与本请求关联的授权实体的唯一标识符
`amount`	string	本次事件在 QI Conta 中的交易金额
`transacted_at`	string	交易执行的时间
`balance_transaction_status`	string	本次事件后 `Balance Transaction` 的状态

balance_transaction_status 描述交易是否已在持卡人 QI Conta 上执行，可能处于待处理（pending_transaction_execution）、部分交易（partially_transacted）或已交易（transacted）状态。

注意！

QI Tech 的 webhook 不应进行严格映射。我们 API 返回的 webhook payload 中可能会包含额外字段。

Webhook 重发！

Webhook 的查询和重发请参阅文档：Webhook 重发

详情​

详情