H2H 付款请求

如果您想创建自己的付款页面，可以使用此 API。此功能仅适用于 INR、BDT、VND、JPY、KRW、BRL、TRY、MMK。

发起支付请求

该API用于创建支付请求。此API需要一个 key 参数，该参数包含由 & 字符分隔的参数组合，然后使用 encrypt_decrypt 算法加密。

请求正文

  • Name
    key
    Type
    string
    required
    Description

    由参数和API密钥及API密钥加密生成的键。

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

参数

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

    该参数描述交易请求的时间范围。有关时间戳的更多详细信息，请访问 https://www.epochconverter.com/。

    请注意，我们仅处理以下时间范围内的时间戳。

    min: 当前时间前1小时

    max: 当前时间后5分钟

  • Name
    transaction_amount
    Type
    double
    required
    Description
    交易金额。
  • Name
    payment_code
    Type
    string
    required
    Description
    例如 P001。请联系管理员获取您的支付代码。
  • Name
    user_id
    Type
    string
    required
    Description
    可以由您系统上的用户密钥字段填写。例如：USR98323923
  • Name
    currency_code
    Type
    string
    required
    Description
    请参阅货币列表。
  • Name
    bank_code
    Type
    double
    required
    Description
    仅在BDT、VND、THB、MMK、IDR、MYR 和 PHP 在线银行支付方法更改事件中需要。
  • Name
    deposit_name
    Type
    string
    required
    Description
    存款名称（KRW必填）。
  • Name
    callback_url
    Type
    string
    Description
    URL 回调。我们将使用此 URL 将交易的更新状态发送到您这边。您可以选择在我们的 BO 上设置它，也可以通过此参数设置。如果您同时设置两者，那么我们也会向这两个 URL 发送回调。
  • Name
    identity_id
    Type
    string
    required
    Description
    必填项（适用于土耳其，TRY）
  • Name
    phone
    Type
    string
    required
    Description
    必填项（适用于BDT，11位数字，不含国家代码，例如：01812345678）

参数对象
{
  "merchant_code": "",
  "merchant_api_key": "",
  "transaction_code": "",
  "transaction_timestamp": 0,
  "transaction_amount": 0,
  "payment_code": "",
  "user_id": "",
  "currency_code": "",
  "bank_code": "",
  "deposit_name": ""
}

这些参数必须在通过键发送之前加密。

返回

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

{
 "status": "success",
 "message": "Submit Transaction Success!",
 "transaction_no": "DP16873387xxxxx",
 "transaction_code": "TEST-DP-16873xxxxx",
 "amount": "510.00",
 "upi_id": "example@upi",
 "qr":"https://staging.s88pay.net/imageencoded=true&url=aHR0cHM6Ly9hcGkucGF5cHJvc3R1ZG
  vLmNvbS9hc3NldC91cGkvY2FjaGVkLzgzMmE1NmZlLTBkYzktNDc0Ni05NDhkLWFlYmY
  3E5NDlkMw==",
 "expired_at":"2023-06-22 15:06:04",
 "expired_timezone":"GMT 05:30"
}
{
  "status": "success",
  "message": "Submit Transaction Success!",
  "transaction_no": "DP16873387xxxxx",
  "transaction_code": "TEST-DP-16873xxxxx",
  "amount": "510.00",
  "wallet_number": "01861843585",
  "wallet_number_type": "Agent",
  "wallet_name": "rocket",
  "wallet_code": "1001",
  "expired_at": "2023-06-22 15:06:04",
  "expired_timezone": "GMT 05:30"
}
{
  "status": "success",
  "message": "Submit Transaction Success!",
  "transaction_no": "DP16873387xxxxx",
  "transaction_code": "TEST-DP-16873xxxxx",
  "amount": "510.00",
  "wallet_number": "0797748156",
  "wallet_name": "Pham Chi Cuong",
  "wallet_code": "momo",
  "match_code": "685532",
  "expired_at": "2023-06-22 15:06:04",
  "expired_timezone": "GMT 05:30"
}
{
  "status": "success",
  "message": "Submit Transaction Success!",
  "transaction_no": "DP1697771160414",
  "transaction_code": "TEST-DP-1697771160",
  "amount": "11111.00",
  "wallet_number": "カ）クレラル",
  "wallet_number_type": null,
  "wallet_name": "7276005",
  "wallet_code": "",
  "expired_at": "2023-10-20 12:21:00",
  "expired_timezone": "GMT 05:30"
}