亮色模式

Notify - 绑卡结果通知

POST

:::tip[]
连连全球收单在绑卡/解绑处理完成后，此开放消息功能为通知客户卡绑定服务结果通知，通知的地址为商户后台配置的绑卡通知地址，商家根据事件类型处理逻辑。消息服务会根据响应报文判断商家系统是否已经成功处理消息，需要商家同步返回固定报文，消息服务则认为商户已经处理成功，停止发送；如果未返回固定报文内容，连连全球收单则认为消息投递失败，会根据投递重试策略重新发送消息至绑卡通知地址；

签名构建因子为入参列表中所有参数;
:::

投递重试策略

一般情况下，在订单支付成功后会实时投递第一次通知，后续每间隔10分钟触发一次重试，最多投递15次。

接口协议结构体

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

请求参数

Header 参数

signature

string

签名

必需

示例值:

XJxQTCs1QTsp+Xo3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9BHgTFn0FziCalU0OD3ddYWTRMf13uyLjwwOKD6LYwdC80+17FqAbBdeFCWuiA6ZUkXblWKiILACf8y0JKkpuEvXSSrvHcpS9MPakuXKKvOBRY1UXBWhXr2bL3qr84rbLU1Ka5ZU70j5r2xZv3JrdeFTYqBLss1/biXNT9bS45JFFoKwX/8ZoBKYhbYtn82b8QiO5I2YV2uw7VXukEGbtfR2p2O3479VGyR3+ch4qroWABRC52EjCwvV0Gbnzs6Wbw0Bg64/aR7GpNz9sHIy6Yw8KwZg==

timezone

string

时区

必需

示例值:

Asia/Hong_Kong

timestamp

string

必需

格式化时间戳,格式为：yyyyMMddHHmmss

示例值:

20211022160000

sign-type

string

加密方式

必需

示例值:

RSA

event

enum<string>

事件类型

必需

<= 64 字符

枚举值:

CREATE_CARD_TOKENUNBIND_CARD_TOKENUPDATE_CARD_TOKEN

merchant_id

string

商户号

必需

<= 64 字符

sub_merchant_id

string

站点号

可选

<= 64 字符

merchant_user_no

string

用户ID

可选

商家系统中的用户ID唯一标识

<= 128 字符

card_token_data

object (CARDTOKENTDATA)

卡数据

必需

holder_name

string

持卡人姓名

必需

<= 128 字符

示例值:

Zhang San

card_no

string

银行卡号

必需

<= 32 字符

示例值:

420000******0000

card_expiration_year

string

卡年有效期

必需

<= 4 字符

示例值:

2025

card_expiration_month

string

卡月有效期

必需

<= 2 字符

示例值:

lianlian_card_token_id

string

卡凭证标识

必需

<= 64 字符

示例值:

LIANLIAN_TOKEN2024071702882243

brand

enum<string>

国际卡卡品牌

必需

<= 32 字符

枚举值:

visamastercardamexjcbdinersclubdiscover

card_token_type

enum<string>

token类型

必需

<= 32 字符

枚举值:

PAYMENT_TOKENLIANLIAN_TOKEN

lianlian_card_token_status

enum<string>

卡状态

必需

<= 32 字符

枚举值:

VALIDINVALIDUNBIND

{
  "event": "CREATE_CARD_TOKEN",
  "merchant_id": "string",
  "sub_merchant_id": "string",
  "merchant_user_no": "string",
  "card_token_data": {
    "holder_name": "Zhang San",
    "card_no": "420000******0000",
    "card_expiration_year": "2025",
    "card_expiration_month": "12",
    "lianlian_card_token_id": "LIANLIAN_TOKEN2024071702882243",
    "brand": "visa",
    "card_token_type": "PAYMENT_TOKEN",
    "lianlian_card_token_status": "VALID"
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

string

固定: 200

必需

<= 32 字符

message

string

必需

固定: success

<= 32 字符

// 商家通知响应为固定参数
{
  "code": "200",
  "message": "success",
}