1. 代收(收款)
Merchant API Documentation
  • 引言
  • 签名算法
  • 信用测试卡
  • 开启正式模式
  • 本地付测试
  • 代付
    • 代付申请接口_ PAY_PAL
      POST
    • 代付申请接口_ ACH_DEBIT
      POST
    • 代付申请接口_CASHAPP
      POST
    • 检索代付交易接口
      GET
    • 代付取消申请接口
      POST
  • 客户
    • 创建客户
      POST
    • 更新客户
      PUT
    • 检索客户
      GET
    • 删除客户
      DELETE
    • 列出所有客户
      GET
  • 代收(收款)
    • 收银台
      POST
    • 本地支付(直连)
      POST
    • 信用卡支付(直连)【PCI】
      POST
    • Web SDK-V2
      POST
    • 检索代收交易接口
      GET
    • Google Pay SDK
      POST
  • 退款申请
    • 退款申请接口
      POST
    • 检索退款接口
      GET
  • 余额查询
    • 检索余额接口
      GET
  • 异步通知
    • 代收异步通知
    • 代付异步通知
  • 订阅
    • 创建订阅
    • 检索订阅
    • 取消订阅
  • 重复性支付
    • 首次重复性支付(直连)
    • 首次重复性支付【收银台】
    • 首次重复性支付【SDK】
    • 后续重复性支付
  • 数据模型
    • 代收模型
      • 信用卡信息
        • CARD
        • 设备信息
      • 代收请求体
      • 代收响应体
      • option配置项
      • option配置项
    • 资金模型
      • 资金响应体
    • 客户模型
      • 客户请求体
      • 客户响应体
      • 收货地址 shipping
      • 产品/服务信息 product
    • 退款模型
      • 退款请求体
      • 退款响应体
    • 代付模型
      • 代付请求体
      • 代付响应体
      • 代付取消请求体
    • 订阅模型
      • 订阅请求体
      • 订阅响应体
      • 订阅计划请求体
      • 订阅计划响应体
      • 其他订阅请求体
    • 响应体基本模型
    • 请求头
  1. 代收(收款)

Web SDK-V2

POST
/pay-api/trade/payment
首先收集除了卡信息以外的订单信息,发起创建订单请求以获取 clientSecret客户端密钥
商户前端需要引入: {{host}}/src/assets/v2/payment-sdk.min.js

前情提要:#

1、必须提供一个嵌入表单的Dom容器,并将容器id通过init方法的containerId参数传递,表单会被嵌入到当前容器,如:
<div id="payment-container"></div>
容器样式以及嵌套任意的父级元素及父元素样式都由商户自行控制;
2、初始化:使用PaymentSDK.init(option, CallbackFn)方法,参数列表如下
init参数描述
参数一 option配置项
参数二 CallbackFn接收初始化结果和支付结果的回调函数(形参对象中的type表示结果类型(init、payment))
option配置项

3、获取结果:初始化结果和支付结果可通过init方法的参数二的回调函数获得;若初始化发现此交易已完成,则直接返回redirectUrl;若填写并提交表单成功,则返回redirectUrl;商户可自行完成跳转。
将js嵌入商户的页面中,示例代码(仅为示例 可结合【前情提要】按需修改html内容):

请求参数

Authorization
Body 参数application/json

示例
{
  "payType": 5,
  "orderNo": "{{orderNo}}",
  "currency": "USD",
  "amount": 9.99,
  "returnUrl": "{{returnUrl}}",
  "notifyUrl": "{{notifyUrl}}",
  "customer": {
    "firstname": "Thiago",
    "lastname": "Gabriel",
    "email": "thiago@example.com",
    "phone": "12345678901",
    "country": "US",
    "state": "CA",
    "city": "San Francisco",
    "address": "310  Park Street",
    "zipcode": "94107",
    "shipping": {
      "firstname": "Thiago",
      "lastname": "Gabriel",
      "email": "thiago@example.com",
      "phone": "12345678901",
      "country": "BR",
      "state": "SP",
      "city": "sao paulo",
      "address": "Rua 9 de setembro",
      "zipcode": "04849333"
    }
  },
  "clientIp": "5.34.176.4",
  "website": "https://test.com",
  "product": [
    {
      "name": "test_name",
      "sku": "test_sku",
      "description": "test_description",
      "quantity": "1",
      "price": "4.99",
      "url": "https://test.com/test_260a61ca16a8"
    }
  ],
  "metadata": "test",
  "remark": "test"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/pay-api/trade/payment' \
--header 'Content-Type: application/json' \
--data-raw '{
  "payType": 5,
  "orderNo": "{{orderNo}}",
  "currency": "USD",
  "amount": 9.99,
  "returnUrl": "{{returnUrl}}",
  "notifyUrl": "{{notifyUrl}}",
  "customer": {
    "firstname": "Thiago",
    "lastname": "Gabriel",
    "email": "thiago@example.com",
    "phone": "12345678901",
    "country": "US",
    "state": "CA",
    "city": "San Francisco",
    "address": "310  Park Street",
    "zipcode": "94107",
    "shipping": {
      "firstname": "Thiago",
      "lastname": "Gabriel",
      "email": "thiago@example.com",
      "phone": "12345678901",
      "country": "BR",
      "state": "SP",
      "city": "sao paulo",
      "address": "Rua 9 de setembro",
      "zipcode": "04849333"
    }
  },
  "clientIp": "5.34.176.4",
  "website": "https://test.com",
  "product": [
    {
      "name": "test_name",
      "sku": "test_sku",
      "description": "test_description",
      "quantity": "1",
      "price": "4.99",
      "url": "https://test.com/test_260a61ca16a8"
    }
  ],
  "metadata": "test",
  "remark": "test"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "data": {
        "merNo": "2500000000",
        "tradeNo": "pay_20250...2121",
        "orderNo": "5239...3750",
        "currency": "USD",
        "amount": 4.99,
        "paymentMethod": null,
        "tradeDate": null,
        "status": 0,
        "code": "requires_action",
        "message": "Req successfully",
        "redirectUrl": null,
        "expireTime": 1754043168864,
        "metadata": "test",
        "remark": "test",
        "clientSecret": "dFhjwLxuIN...1_Vqj_8ArKIU"
    },
    "msg": "",
    "livemode": false
}
🔴500失败
修改于 2026-06-16 07:26:34
上一页
信用卡支付(直连)【PCI】
下一页
检索代收交易接口
Built with