whalet-acquiring
首页
开放API
  • 收款
  • 鲸卡
  • 收单
首页
开放API
  • 收款
  • 鲸卡
  • 收单
  1. 支付
  • 首页
  • 店铺
    • 获取可申请的支付方式
      POST
    • 添加店铺
      POST
    • 添加店铺结果通知
      POST
    • 查询店铺详情
      POST
    • 申请店铺支付方式
      POST
    • 申请店铺支付方式结果通知
      POST
  • 支付
    • 创建支付链接
      POST
    • 查询交易信息
      POST
    • 支付结果通知
      POST
  • 退款
    • 退款申请
      POST
    • 退款结果通知
      POST
  • 拒付
    • 拒付产生通知
      POST
    • 拒付详情
      POST
    • 查询拒付原因
      POST
    • 拒付申诉
      POST
    • 拒付接受
      POST
    • 拒付结果通知
      POST
  1. 支付

创建支付链接

POST
createAcquiringLink

请求参数

Body 参数application/json
userId
string 
用户ID
必需
<= 30 字符
amount
number 
交易金额
必需
商品总金额、运费、税费的总和
currency
enum<string> 
交易币种
必需
枚举值:
CNYCNHMOPHKDTWDUSDJPYEURGBPAUDCADSGDNZDKRWDKKTRYMYRTHBINRPHPCHFSEKILSZARRUBNOKAEDBRLIDRSARMXNPLNVNDCLPKZTCZKNGNCOPEGPVEFKWDARSRONQARUAHHUFPKRLBPJODPENXOFKESUGXTZSRWFXAFGHSAFNALLAMDANGAOAAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBSDBTNBWPBYRBZDCDFCLFCRCCUPCVECYPDEMDJFDOPDZDECSERNETBFJDFKPFRFGELGIPGMDGNFGTQGYDHNLHRKHTGIEPIQDIRRISKITLJMDKGSKHRKMFKPWKYDLAKLKRLRDLSLLTLLVLLYDMADMDLMGAMKDMMKMNTMROMURMVRMWKMXVMZNNADNIONPROMRPABPGKPYGRSDSBDSCRSDGSHPSITSLLSOSSRDSTDSVCSYPSZLTJSTMTTNDTOPTTDUYUUZSVUVWSTYERZMWZWLXCDXDRXPF
description
string 
描述
可选
<= 200 字符
acquiringShopId
string 
店铺ID
必需
<= 30 字符
customerInfo
object 
客户信息
必需
name
string 
客户名称
必需
>= 1 字符<= 100 字符
email
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
enum<string> 
币种
必需
枚举值:
CNYCNHMOPHKDTWDUSDJPYEURGBPAUDCADSGDNZDKRWDKKTRYMYRTHBINRPHPCHFSEKILSZARRUBNOKAEDBRLIDRSARMXNPLNVNDCLPKZTCZKNGNCOPEGPVEFKWDARSRONQARUAHHUFPKRLBPJODPENXOFKESUGXTZSRWFXAFGHSAFNALLAMDANGAOAAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBSDBTNBWPBYRBZDCDFCLFCRCCUPCVECYPDEMDJFDOPDZDECSERNETBFJDFKPFRFGELGIPGMDGNFGTQGYDHNLHRKHTGIEPIQDIRRISKITLJMDKGSKHRKMFKPWKYDLAKLKRLRDLSLLTLLVLLYDMADMDLMGAMKDMMKMNTMROMURMVRMWKMXVMZNNADNIONPROMRPABPGKPYGRSDSBDSCRSDGSHPSITSLLSOSSRDSTDSVCSYPSZLTJSTMTTNDTOPTTDUYUUZSVUVWSTYERZMWZWLXCDXDRXPF
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"
}
修改于 2025-07-09 09:15:53
上一页
申请店铺支付方式结果通知
下一页
查询交易信息
Built with