跳转至

查询支付状态

HTTP请求

GET /v1/payments/charges/{{idempotencyKey}}

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Response
{
    "transferStatusCode": 200,
    "idempotencyKey": "1ec983fa-1c37-679b-809b-067861d8700019",
    "referenceId": "1ec983fa-1c37-679b-809b-067861d8700019",
    "paymentFlow": "DIRECT",
    "paymentMethod": "WEB_PAY",
    "amount": 1000,
    "currency": "CLP",
    "finalAmount": 1000,
    "finalCurrency": "CLP",
    "country": "CL",
    "createTime": "2023-05-30 00:37:42 GMT-07:00",
    "scheduledTime": "2023-05-30 00:37:44 GMT-07:00",
    "finalStatusTime": "2023-05-30 00:37:44 GMT-07:00",
    "payer": {
        "name": "Juan Garcia",
        "document": {
            "documentId": "530315550",
            "type": "RUT"
        },
        "email": "juangarcia@example.com"
    },
    "transferStatus": "IN_PROGRESS",
    "description": "this is a test pay",
    "callbackUrl": "http://api.client.com/notifications",
    "transferDetails": {
        "webPay": {
            "paymentUrl": "https://liquido.com/gmf-apm/payments/M-9ae481d9-b47f-4459-9b63-644977fe91ed",
             "redirectUrl": "https://www.liquido.com"
        }
    }
}
HTTP Headers 字段说明
健 值
Authorization "bearer" + " " + {{access_token}}
x-api-key {{api_key}}
PATH and Query 字段说明
参数 类型 描述
idempotencyKey String 交易的幂等ID
Response Body 字段说明
参数 类型 描述
transferStatus String 汇款状态，枚举值，"SETTLED", "FAILED", "IN_PROGRESS"
transferStatusCode Integer 此次交易的状态码, 200表示交易成功或者进行中, 其他代表失败
transferErrorMsg String 此次交易失败原因
referenceId String 此次交易的ID
idempotencyKey String 此参数用于幂等目的，交易的唯一标识ID，长度不大于128个字节。
amount Long 收款金额
country String 国家编码 CL
currency String 收款货币代码，长度为3个字节，CLP
finalAmount Long 用于创建收款订单的最终金额。对于需要转换汇率的收款订单，这个字段的值表示源请求金额被转换后的金额。
finalCurrency String finalAmount的收款货币代码
paymentMethod String 支付方式. 枚举值
payer JSON 付款人信息
transferDetails JSON 交易类型的详细信息
description String 描述信息
callbackUrl String 商户接收通知的回调地址. 接收http的get请求
createTime String 创建时间
scheduledTime String 执行时间
finalStatusTime String 最终状态更新时间. 最终状态，包括"REFUNDED", "FAILED"
TransferDetails 对象字段说明
参数 类型 描述
webPay JSON webPay的详细信息
WebPay 对象字段说明
参数 类型 描述
paymentUrl String 这个支付链接
redirectUrl String 支付完成后Liquido将重定向到的URL

支付状态

参数 描述
IN_PROGRESS 交易处理中
SETTLED 交易完成
REFUNDING 退款中
REFUNDED 已退款
CHARGED_BACK 拒付
FAILED 交易失败，异常
回到页面顶部