跳到主要内容

TED 发送完成后的 Webhook

Webhook 将通知 TED 交易是否已被退回。

Webhook Request Body

Webhook Body: TED 已拒绝
{
"webhook_type": "baas.ted.outgoing_ted",
"webhook_datetime": "2021-10-22T20:30:23.459Z",
"data": {
"request_control_key": "6e290347-330d-4b3a-8ebb-2ac217ad6eb3",
"ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"account_key": "fc6862c4-2b20-4057-8063-b8809866e494",
"created_at": "2021-10-22T20:30:23.459Z",
"ted_status": "sent",
"transaction_amount": 126.97,
"fee_amount": 0.0,
"target_account": {
"account_branch": "0001",
"account_digit": "6",
"account_number": "78340",
"ispb": "12345678",
"owner_document_number": "32402502000135",
"owner_name": "QI Tech"
},
"refusal_reason": {
"refusal_code": 1,
"enumerator": "conta_destinatario_encerrada",
"description": "Conta Destinatária do Crédito Encerrada"
}
}
}

Webhook Body Param

字段类型描述最大字符数
webhook_typestring定义正在报告的事件类型的枚举值23
webhook_datetimestringWebhook 发送的日期和时间20
request_control_keystring客户使用的 uuid v4 格式的请求唯一标识键36
ted_keystringTED 转账的唯一标识键36
created_atstring交易创建的日期和时间24
ted_statusstringTED 交易状态Enumerador ted_status
transaction_amountnumber转账金额10
fee_amountnumber转账收取的费用金额35
target_accountObject目标账户 - 仅在"manual"类型的交易中发送Objeto target_account
refusal_reasonObject根据巴西中央银行标准的拒绝原因Objeto refusal_reason

Enumerador ted_status

枚举值描述
sentTED 转账成功完成。
pendingTED 转账待处理。
rejectedTED 转账已拒绝。
returnedTED 转账已退回。

Objeto target_account

字段类型描述字符数
account_branch *string银行代码(机构代码)。4
account_digit *string账户校验码1
account_number *string账户号码。20
owner_document_number *string账户持有人的 CPF 或 CNPJ(仅数字)。14
owner_name *string账户持有人姓名。50
account_type *string账户类型。Enumerador account_type
ispb *string基于金融机构 CNPJ(8 位数字)。8

Objeto refusal_reason

字段类型描述字符数
bacen_code *string巴西中央银行拒绝代码3
enumerator *string巴西中央银行拒绝枚举值100
description *string巴西中央银行拒绝描述100

Enumerador account_type

枚举值翻译
checking_account活期账户
deposit_account存款账户
guaranteed_account担保账户
investment_account投资账户
payment_account付款账户
saving_account储蓄账户

接收 TED 后的 Webhook

Webhook 将通知 TED 交易的最终状态。

Webhook Request Body

Request Body: 已接收 TED
{
"webhook_type": "baas.ted.incoming_ted",
"webhook_datetime": "2021-10-22T20:30:23.459Z",
"data": {
"request_control_key": "6e290347-330d-4b3a-8ebb-2ac217ad6eb3",
"ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"account_key": "fc6862c4-2b20-4057-8063-b8809866e494",
"created_at": "2021-10-22T20:30:23.459Z",
"ted_status": "received",
"transaction_amount": 126.97,
"fee_amount": 0.0,
"source_account": {
"account_branch": "0001",
"account_digit": "6",
"account_number": "78340",
"ispb": "12345678",
"owner_document_number": "32402502000135",
"owner_name": "QI Tech"
},
"refusal_reason": {}
}
}

Webhook Body Param

字段类型描述最大字符数
webhook_typestring定义正在报告的事件类型的枚举值23
webhook_datetimestringWebhook 发送的日期和时间20
ted_keystringTED 转账的唯一标识键36
created_atstring交易创建的日期和时间100
ted_statusstringTED 交易状态Enumerador ted_status
transaction_amountnumber转账金额10
fee_amountnumber转账收取的费用金额35
target_accountObject目标账户 - 仅在"manual"类型的交易中发送Objeto target_account
refusal_reasonObject根据巴西中央银行标准的拒绝原因Objeto refusal_reason

Enumerador ted_status

枚举值描述
receivedTED 转账成功完成。
pendingTED 转账待处理。
rejectedTED 转账已拒绝。

Objeto target_account

字段类型描述字符数
account_branch *string银行代码(机构代码)。10
account_digit *string账户校验码10
account_number *string账户号码。10
owner_document_number *string账户持有人的 CPF 或 CNPJ(仅数字)。14
owner_name *string账户持有人姓名。50
account_type *string账户类型。Enumerador account_type
ispb *string基于金融机构 CNPJ(8 位数字)。8

Objeto refusal_reason

字段类型描述字符数
bacen_code *string巴西中央银行拒绝代码3
enumerator *string巴西中央银行拒绝枚举值100
description *string巴西中央银行拒绝描述100

Enumerador account_type

枚举值翻译
checking_account活期账户
deposit_account存款账户
guaranteed_account担保账户
investment_account投资账户
payment_account付款账户
saving_account储蓄账户