批准双因素身份验证 TED 交易
请求
ENDPOINT
/account/ACCOUNT_KEY/ted/TED_KEY/validate_token方法
PUTPath Params
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
account_key | uuidv4 | 账户的唯一标识键。 | 36 |
ted_key | uuidv4 | TED 转账的唯一标识键 | 36 |
通过电子邮件和短信验证
Request Body
{
"token": "329123"
}
通过设备验证
要批准并完成设备验证,请求必须以空负载发送。验证在内部发生,无需请求体中的额外信息。需要注意的是,此端点只应在交易请求启动后使用。
Request Body
{
}
Body Params
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
token | string | 发送给账户转账批准人的验证码(SMS 或电子邮件 TFA 时必填) | 6 |
响应
STATUS
201Response Body: 已发送转账
{
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"transaction_key": "46804f32-101e-4702-8fbc-c2dbc4c2caec",
"ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"transaction_amount": 202.01,
"fee_amount": 10,
"ted_status": "sent",
"created_at": "2021-10-22T20:30:23.459Z"
}
STATUS
202Response Body: 待处理转账
{
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"transaction_amount": 202.01,
"fee_amount": 10,
"ted_status": "pending",
"created_at": "2021-10-22T20:30:23.459Z"
}
STATUS
4xxResponse Body: 已拒绝转账
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {
"ted_data": {
"request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
"ted_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
"transaction_amount": 202.01,
"fee_amount": 10,
"ted_status": "rejected",
"created_at": "2021-10-22T20:30:23.459Z"
}
}
}
STATUS
4xxResponse Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {}
}
信息
此端点也可能返回执行 TED 中列出的错误,以及以下错误。
HTTP 状态码status | QI 代码code | 标题title | 描述(英文)description | 描述(葡文)translation |
|---|---|---|---|---|
| 400 | QIT000001 | Bad Request | Schema Error | Erro de Schema |
| 404 | TED000020 | Not Found | Ted was not found for the given parameters. | Ted não encontrada para os parâmetros fornecidos. |
| 404 | TED000086 | Invalid Status | Ted not in pending_2fa_approval status | Ted não está pendente de aprovação por autenticação de dois fatores |
| 400 | TED000082 | Number of token validation attempts exceeded | The maximum number of failed token validation attempts has been reached | Número máximo de tentativas de validação de token atingida |
| 400 | TED000084 | Incorrect Token | Token sent does not match expected | Token enviado não condiz com, o esperado |
| 400 | TED000083 | Token Expired | Token has expired. Resend token or recreate transfer | Token expirado. Reenvie token ou recrie a transferência |
| 400 | TED000110 | Token Required | A token is required for SMS or email validation. | Um token é necessário para validação via SMS ou email. |