跳转至

查询汇款状态

汇款查询

通过幂等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": "TEST20220829100",
    "referenceNumber": "6012968",
    "targetName": "usera lastname",
    "targetDocument": "24988323888",
    "targetBankName": "ARCUS",
    "targetBankCode": "706",
    "targetBankBranchId": "123456789",
    "targetBankAccountId": "706180005047305123",
    "amount": "100.00",
    "amountInCents": 10000,
    "currency": "USD",
    "paidAmount": 196978,
    "paidCurrency": "MXN",
    "exchangeRate": 19.6978,
    "paidTax": 0,
    "createTime": "2022-08-29 01:02:06 GMT-07:00",
    "finalStatusTime": "2022-08-29 01:02:20 GMT-07:00",
    "transferStatus": "IN_PROGRESS",
    "transferStatusCode": 200,
    "transferErrorMsg": "",
    "subMerchantId": "UUID",
    "transactionDetail": {
        "trackingId": "4d8fa6ee-2fe0-4c27-a5c5-587eefc9eac3",
        "referenceNumber": "9322872"
    }
}

HTTP Headers

Key Value
Content-Type 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
referenceNumber String 已弃用，交易的参考编号,请使用transactionDetail中的referenceNumber
targetName String 目标账号的收款人全名
targetDocument String 目标账户持有人的证件类型
targetBankName String 目标账号的银行名称
targetBankCode String 目标账号的银行代码
targetBankBranchId String 目标账号的银行分支码
targetBankAccountId String 目标账号的账号ID
amount String 已弃用。汇款金额，注意： 1 = 1MXN。请使用amountInCents。
amountInCents Long 汇款金额。注意： 100 = 1MXN/1USD
currency String 汇款货币代码，例如MXN、USD
paidAmount Long 当入参货币为MXN时返回null，转换货币代码后的支付金额
paidCurrency String 当入参货币为MXN时返回null，转换货币代码后的货币代码，MXN
exchangeRate Double 当入参货币为MXN时返回null，转换货币代码所使用的汇率
paidTax Long 当入参货币为MXN时返回null，转换货币代码的手续费
createTime Time 汇款请求时间
finalStatusTime Time 汇款操作完成时间
transferStatus String 汇款状态，枚举值，"SETTLED", "FAILED", "IN_PROGRESS" 或者 "REJECTED", 交易状态应以transferStatus为准
transferStatusCode Integer 此次交易的状态码, 交易异常码
transferErrorMsg String 此次交易失败原因
subMerchantId String 子商户ID
transactionDetail JSON 交易凭证信息，交易被拒绝时可能为空值
transactionDetail 字段说明
参数 类型 描述
trackingId String 支付的跟踪键，交易被拒绝时可能为空值
referenceNumber String 支付的参考编号，交易被拒绝时可能为空值
回到页面顶部