亮色模式

API - 获取iframe凭证

POST/v3/merchants/<merchant_id>/token

:::tip[]
该接口提供iframe模式下支付标识的获取，商户可以通过该接口主动获取iframe支付token，再进行下一步创单支付，token有效期为24小时，超期需要重新获取；

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

环境域名地址

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

接口协议结构体

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

请求参数

Header 参数

signature

string

签名

必需

示例值:

I8UAQmkajps69T4D4hQK77ES6DJJJIrOPeI/mK4v+LQ79smFFSJS8RU+D6Rnh9X+q32Pq4bl8lqeKFrQMSp5vusVVmth226z0L5TTEf+h0MJjmhcWxt2r+5zusBkP9kJWycZ9e3kGPIza2eB0/A3xiBkOZzS3eQ9+OPKcMctITPjsB3QrCtlT75Vzz4Tl/ArKKhqlSpkd9NuS6b7PQ3Xx26wqTAKqx9s4itb0vyyLjgMpN2KVoGbDbjGoZSK2cy9DScQX57HzbG6ZpUPPqdslps10x0WGTzD06tq4nL5MorkhFLZlXW14WaQgoDkBqELG8oSr+3Imwc/k7NaMEZ6JA==

timezone

string

时区

必需

示例值:

Asia/Hong_Kong

timestamp

string

必需

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

示例值:

20211022160000

merchant_id

string

商户号

必需

sub_merchant_id

string

站点号

必需

merchant_user_no

string

商户的用户 ID

可选

使用卡绑定功能必填

{
  "merchant_id": "202411010002802001",
  "sub_merchant_id": "1020241101710001",
  "merchant_user_no": "user1234567890"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

return_code

string

必需

返回码

return_message

string

必需

返回消息

trace_id

string

必需

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

order

string

iframe凭证

必需

{
  "return_code": "SUCCESS",
  "return_message": "Success",
  "trace_id": "408f9b05869748a0a89985cb1fddde7a.175.17332992054247185",
  "order": "v3_2_22bf0c0ce7d1462585e912953e0f7f39"
}