收银台

POST

/pay-api/trade/payment

商户受理支付请求当前API，消费者进入到收银台进行支付。

请求参数

Authorization

Body 参数application/json

示例

收银台收银台（客户ID）

{
  "orderNo": "{{paying_orderNo}}",
  "payType":1,
  "currency": "USD",
  "amount": 14.99,
  "returnUrl": "{{return_url}}",
  "notifyUrl": "{{notify_url}}",
  "paymentMethod":"CASHAPP",
  "clientIp":"192.168.1.2",
  "customer": {
    "firstname": "{{test_firstname}}",
    "lastname": "{{test_lastname}}",
    "email": "{{test_email}}",
    "phone": "{{test_phone}}",
    "country": "{{test_country}}",
    "state": "{{test_state}}",
    "city": "{{test_city}}",
    "address": "{{test_address}}",
    "zipcode": "{{test_zip}}"
  },
  "metadata": "test"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

收银台收银台（客户ID）

curl --location '/pay-api/trade/payment' \
--header 'Content-Type: application/json' \
--data '{
  "orderNo": "{{paying_orderNo}}",
  "payType":1,
  "currency": "USD",
  "amount": 14.99,
  "returnUrl": "{{return_url}}",
  "notifyUrl": "{{notify_url}}",
  "paymentMethod":"CASHAPP",
  "clientIp":"192.168.1.2",
  "customer": {
    "firstname": "{{test_firstname}}",
    "lastname": "{{test_lastname}}",
    "email": "{{test_email}}",
    "phone": "{{test_phone}}",
    "country": "{{test_country}}",
    "state": "{{test_state}}",
    "city": "{{test_city}}",
    "address": "{{test_address}}",
    "zipcode": "{{test_zip}}"
  },
  "metadata": "test"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

申请成功交易成功交易失败

{
    "code": 0,
    "data": {
        "tradeNo": "pay_202506251213283708537",
        "orderNo": "asd60102",
        "currency": "USD",
        "amount": 12.34,
        "tradeDate": null,
        "status": 0,
        "code": "requires_action",
        "message": "Please redirect to 'redirectUrl'",
        "redirectUrl": "https://xxx",
        "expireTime": 1728638520977
    },
    "msg": "",
    "livemode": true
}

🔴500失败

修改于 2026-06-23 09:16:09

列出所有客户

本地支付（直连）