跳转至

查询支付状态

HTTP请求

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

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Response
{
    "transferStatusCode": 200,
    "transferErrorMsg": null,
    "idempotencyKey": "2022030214000008",
    "referenceId": "2022030214000008",
    "paymentMethod": "CREDIT_CARD",
    "amount": 300,
    "currency": "COP",
    "country": "CO",
    "createTime": "2022-03-01 21:16:42 GMT-08:00",
    "scheduledTime": "2022-03-01 21:16:42 GMT-08:00",
    "finalStatusTime": "2022-03-01 21:16:48 GMT-08:00",
    "payer": {
        "name": "username",
        "email": "username@liquido.com",
        "document" : "88712345",
        "phone": "+57 3123456789",
        "billingAddress": {  
            "zipCode": "111111",
            "state": "Cundinamarca",
            "city": "Bogotá",
            "street": "Apartamento 502, Torre I",
            "number": "Calle 34 # 56 - 78"
        }
    },
    "transferDetails": {
        "card": {
            "cardInfo": {
                "cardHolderName": "card_holder_name",
                "expirationMonth": 06,
                "expirationYear": 2029,
                "bin": "424242",
                "last4": "4242",
                "brand": "VISA"
            },
            "cardToken": {
                "token": "card_8736453a-dad0-4f26-85f0-95e8787d0237",
                "type": "CARD"
            }
        },
        "cashPay": {
            "email": "test@gmail.com",
            "externalIdentifier": "111111",
            "businessAgreementCode": "111111",
            "paymentIntentionIdentifier": "111111"
        },
        "bankTransfer": {
            "paymentUrl": "test.com"
        },
        "payCash":{
            "referenceNumber":"1264207400046",
            "expirationDate":"2022-09-30",
            "recurring":false,
            "paymentTime": "2022-10-06 00:21:20"
        }
    },
    "transferStatus": "SETTLED",
    "description": "this is a test pay",
    "callbackUrl": "http://api.client.com/callback/",
    "subMerchantId": "UUID"
}
HTTP Headers 字段说明
Key Value
Authorization "bearer" + " " + {{access_token}}
x-api-key {{api_key}}
PATH and Query 字段说明
参数 类型 描述
idempotencyKey String 交易的幂等ID
Response Body 字段说明
参数 类型 描述
idempotencyKey String 幂等目的，交易的唯一标识ID
amount Long 汇款金额
country String 国家代码，CO
currency String 汇款货币代码，COP
createTime String 汇款请求时间
scheduledTime String 调用时间
payer JSON 买家个人信息。
transferDetails JSON 交易其他详细信息
finalStatusTime String 汇款操作完成时间. 完成包括下面状态： "SETTLED", "FAILED" 或者 "REFUNDED"
transferStatus String 汇款状态，枚举值，"SETTLED", "FAILED", "IN_PROGRESS", "REFUNDING", "REFUNDED", "CANCELLED"
transferStatusCode Integer 此次交易的状态码, 200表示交易成功或者进行中, 其他代表失败
transferErrorMsg String 此次交易失败原因
subMerchantId String 子商户ID。

对象字段说明

Payer
参数 必填 类型 描述
name String 名字，全称（入参名字规范：只允许大小写字母，数字和空格的组合。请勿包含西班牙语和葡萄牙语字母，以及其他特殊字符。）
email String 邮箱
document String CC
phone String 电话号码，需包含“+57”的前缀。
billingAddress JSON 账单邮寄地址
BillingAddress
参数 必填 类型 描述
zipCode String 邮政编码
state String 州
city String 城市
street String 街道
number String 门牌号
TransferDetails
参数 类型 描述
bankTransfer JSON 银行转账相关信息，需要注意paymentUrl字段，您需要将客户重定向到此URL，以便他可以在相应的金融机构中进行支付。
psePay JSON Pse 支付相关信息，需要注意paymentUrl字段，您需要将客户重定向到此URL，以便他可以在相应的金融机构中进行支付。
cashPay JSON 现金支付相关信息，您需要告知您的客户businessAgreementCode和paymentIntentionIdentifier字段，以便他们可以在任何相应的Bancario付款点现金付款。
payCash JSON payCash支付详细信息
BankTransfer
参数 类型 描述
paymentUrl String 支付链接
PsePay
参数 类型 描述
paymentUrl String 支付链接
externalIdentifier String 外部标识符
ticketId String 票据编号
CashPay
参数 类型 描述
email String 邮件
externalIdentifier String 外部标识符
businessAgreementCode String 业务协议代码
paymentIntentionIdentifier String 支付意向标识符
Card
参数 类型 描述
cardInfo JSON 卡详细信息
cardToken JSON card token, 用户可以使用card token代替card info来发起支付请求
CardInfo
参数 类型 描述
cardHolderName String 持卡人姓名
bin String 卡号前6位数字
last4 String 卡号后4位数字
brand String 信用卡组织. 如 VISA, MASTERCARD或Amex
expirationMonth Integer 1位数或者2位数的信用卡有效期月份。
expirationYear Integer 信用卡有效期年份，4位数。
CardToken
参数 类型 描述
token String token串
type String token类型, 枚举，当前只有CARD
PayCash 对象字段说明
参数 类型 描述
referenceNumber String 支付者支付时使用的reference号码
expirationDate String 过期日期 墨西哥时间 "yyyy-MM-dd"
recurring Boolean 是否可以多次付款
paymentTime String 实际支付时间 墨西哥时间 "yyyy-MM-dd HH:mm:ss"
回到页面顶部