亮色模式

API - 绑卡查询

POST/v3/merchants/<merchant_id>/queryCardToken

:::tip[]
该接口提供信用卡绑卡结果的查询，商家可以通过该接口主动查询绑卡结果状态，完成下一步的业务逻辑。

签名构建因子为入参列表中所有参数;
访问时需要将替换为商户号；
:::

环境域名地址

生产环境：https://gpapi.lianlianpay.com/v3/merchants/<merchant_id>/queryCardToken
沙箱环境：https://celer-api.LianLianpay-inc.com/v3/merchants/<merchant_id>/queryCardToken

接口协议结构体

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

请求参数

Header 参数

signature

string

签名

必需

示例值:

XJqQTCs1QTsp+xO3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9Bg9hfTnOFziCaU0OD3ddYWTMRf13uyLjwwOKD6LWyBCd+17Fq4bBdFcCwiuA6ZUkXbIWKiLACf8gY0JkKpuEvXSSrvHcpS9MPakuXKKwOBRY1UXBhWr2bL3qr8r4bLUk1A3 5ZU7Oj5r2xZV3JrdeFYqBLss1jbXNT9bS4J5JFoFKw/xBzoBkYh7btm28b8i8Q5lY2Vu7vZVK+BGKfBff2PQOJ347VGyR3+ch4qrw0ABRC52jEycWWoGQbnzs6W8DwBGg64/aR7GpNz9sHIy6YW8KwZg==

timezone

string

时区

必需

示例值:

Asia/Hong_Kong

timestamp

string

必需

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

示例值:

20211022160000

Content-Type

string

必需

示例值:

application/json

merchant_id

string

商户号

必需

<= 32 字符

sub_merchant_id

string

站点号

必需

<= 32 字符

merchant_user_no

string

用户ID

必需

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

<= 64 字符

lianlian_card_token_id

string

卡凭证标识

必需

<= 32 字符

{
  "lianlian_card_token_id": "PAYMENT_TOKEN20231105680001",
  "merchant_id": "202210220002387000",
  "merchant_user_no": "user1234567890",
  "sub_merchant_id": "1020241105229000"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

return_code

string

返回码

必需

返回码

return_message

string

返回消息

必需

返回消息

trace_id

string

追踪号

必需

需要技术支持时候，请提供至LianLian Pay技术人员

order

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

{
  "return_code": "SUCCESS",
  "return_message": "Success",
  "trace_id": "0606923d7a1647df9317159efbfe8efb.199.17314696256950645",
  "order": {
    "holder_name": "zhang san",
    "card_no": "420000******0000",
    "card_expiration_year": "2025",
    "card_expiration_month": "12",
    "lianlian_card_token_id": "PAYMENT_TOKEN2024110103154059",
    "card_token_type": "PAYMENT_TOKEN",
    "lianlian_card_token_status": "VALID",
    "brand": "visa"
  }
}