Web SDK-V2

首先收集除了卡信息以外的订单信息，发起创建订单请求以获取 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

示例

SDKSDK（客户ID）

{
  "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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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失败

前情提要：#

请求参数

请求示例代码

返回响应

前情提要：