跳转至

拒付

拒付（Chargeback）是由持卡人通过发卡银行发起的一种争议处理流程，旨在追回其认为有误、未经授权或存在问题的交易款项。

当发生拒付时，我们将通过通知或回调的方式异步告知您。

通知 / 回调

Content-Type: application/json
{
  "eventType": "CHARGE_CHARGED_BACK",
  "data": {
    "chargeDetails": {
      "transferStatusCode": 200,
      "transferErrorMsg": null,
      "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
      "referenceId": "1ec983fa-1a37-679b-809b-067861d87ab0",
      "paymentMethod": "CARD",
      "amount": 10000,
      "currency": "COP",
      "country": "CO",
      "finalAmount": 10000,
      "finalCurrency": "COP",
      "createTime": "2022-03-01 17:53:18 GMT-08:00",
      "scheduledTime": "2022-03-01 17:53:18 GMT-08:00",
      "finalStatusTime": "2022-03-01 17:59:59 GMT-08:00",
      "payer": {
        "name": "username",
        "email": "username@liquido.com",
        "document": {
          "documentId": "41345678",
          "type": "CC"
        },
        "phone": "+5781987654321"
      },
      "transferDetails": {
        "card": {
          "cardInfo": {
            "cardHolderName": "card_holder_name",
            "expirationMonth": 9,
            "expirationYear": 2028,
            "brand": "VISA",
            "bin": "458124",
            "last4": "0000"
          },
          "chargebackInfo": {
            "category": "OTHER",
            "reasonCode": "1999",
            "reasonMessage": "Not Classified"
          },
          "cardId": "8736453a-dad0-4f26-85f0-95e8787d0237"
        }
      },
      "transferStatus": "CHARGED_BACK",
      "description": "this is a test pay",
      "callbackUrl": "https://api.client.com/callback/",
      "subMerchantId": "UUID"
    }
  }
}

字段说明

参数 类型 描述
transferStatus String CHARGED_BACK
transferStatusCode Integer 此次交易的状态码, 200表示交易成功、进行中或预授权成功, 其他代表失败
transferErrorMsg String 失败时的具体错误信息，请参考2xxx相关状态码的描述
referenceId String 此次交易的ID
idempotencyKey String 此参数用于幂等目的，交易的唯一标识ID 长度不大于128个字节。
amount Long 收款金额
country String 国家编码
currency String 收款货币代码，长度为3个字节
finalAmount Long 用于创建收款订单的最终金额。对于需要转换汇率的收款订单，这个字段的值表示源请求金额被转换后的金额。
finalCurrency String finalAmount的收款货币代码
paymentMethod String 支付方式. 枚举值, CARD
paymentFlow String 支付流程. 枚举值, DIRECT
payer JSON 付款人信息
transferDetails JSON 交易类型的详细信息
description String 描述信息
callbackUrl String 商户接收通知的回调地址. 接收http的get请求.
createdTime String 创建时间
scheduledTime String 执行时间
finalStatusTime String 最终状态更新时间. 最终状态，包括"REFUNDED", "FAILED"
subMerchantId String 子商户ID。

对象说明

Payer 对象字段说明
参数 必填 类型 描述
name String 名字，全称
email String 邮箱
document JSON 支付人的身份信息
phone String 电话号码，需包含“+57”的前缀。
Document 对象字段说明
Parameter Required Type Description
documentId String 证件号码.
type String 证件类型，如CC、CE、NIT或TI
transferDetails 对象字段说明
参数 类型 描述
card JSON 卡相关信息
card对象字段说明
参数 类型 描述
cardInfo JSON 卡详细信息
cardId String 卡ID, 使用卡信息支付时不返回，用卡ID支付时会返回
chargebackInfo JSON chargeback详细信息
CardInfo对象字段说明
参数 类型 描述
cardHolderName String 持卡人姓名
bin String 卡号前6位数字
last4 String 卡号后4位数字
brand String 信用卡组织. 如 VISA, MASTERCARD
expirationMonth Integer 1位数或者2位数的信用卡有效期月份。
expirationYear Integer 信用卡有效期年份，4位数。
Chargeback Info
参数 类型 描述
category String 拒付的类型。
reasonCode String 拒付原因代码。
reasonMessage String 拒付原因解释。
Category
参数 描述
FRAUD 交易涉嫌欺诈。
AUTHORIZATION 这笔支付没有被持卡人授权。
CUSTOMER_DISPUTE 客户对这笔支付提出争议。
PROCESSING_ERROR 这笔支付在后续的处理中发现存在问题。
OTHER 这笔支付因为未分类的原因需要被退款。

Reason Code

错误码 错误消息
1001 欺诈——芯片责任转移
1002 欺诈——未出示卡
1003 欺诈——无授权
1101 无授权
1201 信用未处理
1202 未收到产品或服务
1203 产品或服务与描述不符或有缺陷
1204 取消的产品或服务
1301 卡号无效
1302 金额不正确
1303 币种不正确
1304 重复处理
1305 通过其他方式支付
1399 处理中出现错误
1999 未分类
回到页面顶部