创建收单支付链接 - whalet-acquiring

请求参数

Body 参数application/json

userId

string

用户ID

必需

<= 30 字符

amount

number

交易金额

必需

商品总金额、运费、税费的总和

currency

string

国际标准货币三位代码

必需

>= 3 字符<= 3 字符

示例值:

CNY

description

string

描述

可选

<= 200 字符

shopUrl

string

店铺链接

必需

<= 150 字符

customerInfo

object

客户信息

必需

name

string

客户名称

必需

>= 1 字符<= 100 字符

string

邮箱

必需

country

string

必需

国家/地区 ISO国家地区二字编码

goodsInfoList

array[object (TradeAcquiringLinkGoodsInfo) {3}]

商品信息

必需

goodsName

string

商品名称

必需

<= 100 字符

unitPrice

number

商品单价

必需

quantity

integer

数量

必需

linkValidity

string

链接有效期

必需

示例值:

yyyy-MM-dd HH:mm:ss

logisticsFee

number

运费

可选

taxFee

number

税费

可选

merTradeNo

string

商户订单号（唯一编号）

必需

<= 30 字符

redirectUrl

string

重定向地址，配置后收银台支付成功将跳转至该地址

可选

<= 500 字符

示例

{
  "acquiringPaymentMethod": [],
  "amount": "",
  "country": "",
  "customerId": "",
  "description": "",
  "goodsItemList": [
    {
      "quantity": 0,
      "recordeId": ""
    }
  ],
  "linkName": "",
  "linkValidity": "",
  "logisticsFee": "",
  "merTradeNo": "",
  "source": "",
  "taxFee": "",
  "userId": ""
}

返回响应

🟢200成功

application/json

Body

userId

string

用户ID

必需

tradeId

string

支付ID

必需

merTradeNo

string

商户订单号（唯一编号）

必需

amount

number

金额

必需

currency

string

国际标准货币三位代码

必需

>= 3 字符<= 3 字符

示例值:

CNY

customerEmail

string

客户邮箱

必需

linkUrl

string

链接地址

必需

linkValidity

string

链接有效期

必需

示例值:

yyyy-MM-dd HH:mm:ss

redirectUrl

string

重定向地址

可选

status

enum<string>

支付链接状态

必需

枚举值:

ENABLEUNABLEEXPIREDDELETEPROCESSINGCOMPLETED

示例

{
    "userId": "string",
    "tradeId": "string",
    "merTradeNo": "string",
    "amount": 0,
    "currency": "CNY",
    "customerEmail": "string",
    "linkUrl": "string",
    "linkValidity": "yyyy-MM-dd HH:mm:ss",
    "redirectUrl": "string",
    "status": "ENABLE"
}