付款

处理付款

此 API 用于提交付款请求。它需要一些参数来提交付款并检查交易状态。需要使用 secret key 和 merchant key 加密请求。

请求正文

  • Name
    key
    Type
    string
    required
    Description

    使用 API 密钥和 API 秘钥加密生成的 参数 生成的密钥。

cURL
curl --request POST \
  --url https://staging.s88pay.net/api/v1/payout/{merchant_code} \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "<string>"
    }'
Processing request...

参数

  • Name
    merchant_code
    Type
    string
    required
    Description
    由服务提供商提供。
  • Name
    transaction_code
    Type
    string
    required
    Description
    由操作员生成。每个交易必须唯一。
  • Name
    transaction_timestamp
    Type
    integer
    required
    Description
    由操作员生成。

    此参数描述交易请求时间范围。有关时间戳的更详细信息，请访问 epochconverter。

    请注意，我们只处理这些限制的时间戳。

    min: 当前时间之前的 1 小时

    max: 当前时间之后的 5 分钟

  • Name
    payout_code
    Type
    string
    required
    Description
    例如 P001。请联系管理员获取您的支付代码。
  • Name
    transaction_amount
    Type
    double
    required
    Description
    交易金额。
  • Name
    user_id
    Type
    string
    required
    Description
    可以由您系统上的用户密钥字段填充。例如：USR98323923。
  • Name
    currency_code
    Type
    string
    required
    Description
    请参阅 货币列表。
  • Name
    address
    Type
    string
    required
    Description
    加密付款时必填 这是用户的加密钱包地址。
  • Name
    bank_account_number
    Type
    string
    required
    Description
    必填 (INR, CNY, VND, THB, KRW, BDT, JPY, BRL 付款) BRL 使用 11 位身份证号码
  • Name
    ifsc_code
    Type
    string
    required
    Description
    仅对 INR 付款必填
  • Name
    bank_code
    Type
    string
    required
    Description
    必填 (INR, CNY, VND, THB, BDT, IDR, MYR, KRW, JPY, BRL 和 PHP 付款)

    可用的 INR 银行代码 显示在 S88pay 后台提现菜单中的银行代码部分。

    可用的 银行代码。

  • Name
    bank_name
    Type
    string
    required
    Description
    必填 (INR, CNY, VND, THB, BDT, IDR, MYR, KRW, JPY, BRL 和 PHP 付款)

    可用的 INR 银行代码 显示在 S88pay 后台提现菜单中的银行代码部分。

    可用的 银行代码。

  • Name
    branch_code
    Type
    string
    Description
    仅对 JPY 必填。分行代码。
  • Name
    account_name
    Type
    string
    required
    Description
    银行账户 / 钱包名称。
  • Name
    callback_url
    Type
    string
    Description
    URL 回调。我们将使用此 URL 将交易的更新状态发送到您这边。您可以选择在我们的 BO 上设置它，也可以通过此参数设置。如果您同时设置两者，那么我们也会向这两个 URL 发送回调。
  • Name
    phone_number
    Type
    string
    Description
    必填项（适用于BDT，11位数字，不带国家代码，例如：01812345678）

参数对象
{
  "merchant_code": "ABC123",
  "transaction_code": "TRX123456789",
  "transaction_timestamp": 1649700000,
  "payout_code": "P001",
  "transaction_amount": 100.50,
  "user_id": "user123",
  "currency_code": "USD",
  "address": "0x123456789abcdef",
  "bank_account_number": "1234567890",
  "ifsc_code": "12323",
  "bank_code": "XYZ",
  "bank_name": "Example Bank",
  "branch_code": null,
  "account_name": "John Doe",
  "callback_url": "https://example.com/callback"
}

这些参数必须在通过 key 正文发送之前进行 加密。

返回值

返回一个交易状态对象。如果发生错误，此调用将返回一个 错误。

{
    "success": true,
    "message": "Invalid Transaction Code ( not unique )!, error code 111"
}
{
    "success": true,
    "message": "request withdraw successful"
}