跳转至

查询汇款状态

汇款查询

通过幂等ID查询汇款状态

HTTP请求

GET /v1/payments/payouts/key/{{idempotencyKey}}

Request Headers
{
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Content-Type: application/json
{
    "statusCode": 200,
    "errorMsg": "",
    "idempotencyKey": "idempotency-key",
    "targetName": "Test Name",
    "targetDocument": "0000000",
    "targetBankCode": "1000",
    "targetBankAccountId": "0000000001",
    "amount": "100.00",
    "amountInCents": 10000,
    "currency": "COP",
    "createTime": "2022-10-10 08:36:36 GMT+00:00",
    "finalStatusTime": "2022-10-10 08:37:13 GMT+00:00",
    "transferStatus": "SETTLED",
    "transferStatusCode": 200,
    "transferErrorMsg": "",
    "subMerchantId": "UUID"
}

HTTP Headers 字段说明

Key Value
Content-Type application/json
Accept application/json
Authorization "bearer"+ "" + {{access_token}}
x-api-key {{api_key}}

路径参数

参数 是否必填 类型 描述
idempotencyKey String 交易的幂等ID

Response Body 字段说明

参数 类型 描述
statusCode Integer 此次请求API状态代码，200代表API请求成功, 401 访问受限, 422 参数错误, 500 内部错误
errorMsg String 如果API请求失败，返回的错误信息
idempotencyKey String 幂等目的，交易的唯一标识ID
targetName String 目标账号的收款人全名
targetDocument String 目标账户持有人的证件号
targetBankCode String 目标账号的银行代码
targetBankAccountId String 目标账号的账号ID
amount String 已弃用。汇款金额，注意： 1 = 1COP。请使用amountInCents。
amountInCents Long 汇款金额。 注意： 100 = 1COP
currency String 汇款货币代码，COP
createTime String 汇款请求时间
finalStatusTime String 汇款操作完成时间. 完成包括下面状态： "SETTLED", "REJECTED"
transferStatus String 汇款状态，枚举值，"SETTLED", "IN_PROGRESS" 或者 "REJECTED", 交易状态应以transferStatus为准
transferStatusCode Integer 此次交易的状态码, 交易异常码
transferErrorMsg String 此次交易失败原因
subMerchantId String 子商户ID
回到页面顶部