1. 通知
  • 概览
  • 集成模式
    • 收银台模式
    • 嵌入式 iframe 模式
    • Direct API 模式
    • 插件模式
  • 支付方式
    • 支付方式概览
    • 全球
      • 国际卡
      • Afterpay
      • Apple Pay
      • Google Pay
      • Klarna
    • 中国大陆&港台地区
      • Alipay CN
      • Alipay HK
      • JKO PAY
      • TWN BANK
      • WeChat Pay
    • 日韩地区
      • 日本
        • Konbini
      • 韩国
        • Kakao Pay
        • Naver Pay
        • PAYCO
    • 东南亚地区
      • 印度尼西亚
        • Akulaku
        • BNI
        • BRI
        • CIMB Clicks
        • DANA
        • Mandiri
        • Maybank
        • Nobu Bank QRIS
        • OVO
        • Permata
      • 马来西亚
        • Boost
        • Mcash
        • Touch n Go
      • 菲律宾
        • BPI
        • Coins.ph
        • GCash
        • GrabPay
        • Maya
      • 泰国
        • Bualuang iBanking
        • Krungsri Online
        • Prompt Pay
        • Rabbit LINE Pay
        • TrueMoney
      • 越南
        • Napas Card
        • VietQR
        • Zalopay
  • 开始接入
    • 申请测试商户
    • 测试验收场景
    • 上线前准备
    • 如何配置公钥
    • 请求与响应结构
    • API 签名组装规则
    • 支付完成同步跳转参数说明
    • 收银台对接
      • 收银台流程说明
    • iframe 对接
      • 国际卡支付流程(iframe)
      • 国际卡绑卡流程(iframe)
      • Google Pay 流程(iframe)
      • Apple Pay 流程(iframe)
    • Direct API 对接
      • 国际卡支付流程(Direct API)
      • WeChatPay 流程(Direct API)
      • Alipay+ 流程(Direct API)
      • Apple Pay 流程(Direct API)
  • APIs
    • 接口
      • API - 支付
        POST
      • API - 支付查询
        GET
      • API - 退款
        POST
      • API - 退款查询
        GET
      • API - 支付取消
        GET
      • API - 获取iframe凭证
        POST
      • API - 解绑
        POST
      • API - 绑卡查询
        POST
      • API - 物流上传
        POST
      • API - 支付查询-POST
        POST
    • 通知
      • Notify - 支付结果通知
        POST
      • Notify - 退款结果通知
        POST
      • Notify - 绑卡结果通知
        POST
      • Notify - 争议结果通知
        POST
  • 附录
    • 返回码
    • 业务错误码
    • 订单状态
    • 国家编码
    • 州
    • 币种
    • 承运商
    • 资源下载
      • 插件
      • 对接 SDK - Java
      • 对接 SDK - Node
  1. 通知

Notify - 争议结果通知

POST
/
连连全球收单在交易争议(拒付 Chargeback 与 RDR)处理过程中的关键节点(待申诉、败诉、胜诉),主动向商家配置的争议结果通知地址发送争议结果通知。拒付(Chargeback)和 RDR 两种争议类型共用同一套接口结构,仅通过 dispute_type 字段区分。消息服务会根据响应报文判断商家系统是否已经成功处理消息,需要商家同步返回固定报文,消息服务则认为商家已经处理成功,停止发送;如果未返回固定报文内容,连连全球收单则认为消息投递失败,会根据投递重试策略重新发送消息至争议结果通知地址;
签名构建因子为入参列表中所有参数;

投递重试策略#

一般情况下,在争议状态变更后会实时投递第一次通知,后续每间隔10分钟触发一次重试,最多投递15次。

通知触发节点#

Chargeback(拒付)通知节点#

通知状态值说明触发时机
DISPUTE_PENDING待提交拒付生效,商户需上传申诉材料
DISPUTE_LOST败诉申诉失败或商户接受拒付后
DISPUTE_WON胜诉争议撤销后

RDR(快速争议解决)通知节点#

通知状态值说明触发时机
DISPUTE_PREVENTION_REFUND拒付预警退款RDR争议生效后
DISPUTE_PREVENTION_REFUND_REVERSAL拒付预警退款撤销RDR争议撤销后

接口协议结构体#

详情可查看请求与响应结构

请求参数

Header 参数

Body 参数application/json

示例
{
    "dispute_type": "ChargeBack",
    "ll_transaction_id": "2024012601122644",
    "merchant_transaction_id": "693100628120965120",
    "dispute_status": "DISPUTE_PENDING",
    "dispute_amount": 88.88,
    "dispute_currency": "USD",
    "dispute_reason": "10.4",
    "dispute_time": "20240126141430",
    "appeal_due_date": "20240209",
    "card_brand": "MASTERCARD",
    "last_four_digits_of_card": "1234",
    "customer_email": "buyer@example.com",
    "arn": "74000000000000000000000"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://celer-api.LianLianpay-inc.com/' \
--header 'signature: XJxQTCs1QTsp+Xo3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9BHgTFn0FziCalU0OD3ddYWTRMf13uyLjwwOKD6LYwdC80+17FqAbBdeFCWuiA6ZUkXblWKiILACf8y0JKkpuEvXSSrvHcpS9MPakuXKKvOBRY1UXBWhXr2bL3qr84rbLU1Ka5ZU70j5r2xZv3JrdeFTYqBLss1/biXNT9bS45JFFoKwX/8ZoBKYhbYtn82b8QiO5I2YV2uw7VXukEGbtfR2p2O3479VGyR3+ch4qroWABRC52EjCwvV0Gbnzs6Wbw0Bg64/aR7GpNz9sHIy6Yw8KwZg==' \
--header 'timezone: Asia/Hong_Kong' \
--header 'timestamp: 20211022160000' \
--header 'sign-type: RSA' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dispute_type": "ChargeBack",
    "ll_transaction_id": "2024012601122644",
    "merchant_transaction_id": "693100628120965120",
    "dispute_status": "DISPUTE_PENDING",
    "dispute_amount": 88.88,
    "dispute_currency": "USD",
    "dispute_reason": "10.4",
    "dispute_time": "20240126141430",
    "appeal_due_date": "20240209",
    "card_brand": "MASTERCARD",
    "last_four_digits_of_card": "1234",
    "customer_email": "buyer@example.com",
    "arn": "74000000000000000000000"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
// 商家通知响应为固定参数
{
  "code": "200",
  "message": "success"
}
上一页
Notify - 绑卡结果通知
下一页
返回码