H2H Payment Request

You may use this api if you want to create your own payment page. This feature is only available for INR, BDT, VND, JPY, KRW, BRL, TRY, MMK.

Make Payment Request

This API is used to create payment requests. This API requires 1 key parameter, which contains a combination of parameters separated by the & character and then encrypted using the encrypt_decrypt algorithm.

Request Body

  • Name
    key
    Type
    string
    required
    Description

    Key generated from parameters with API key and API secret encryption.

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

Parameters

  • Name
    merchant_code
    Type
    string
    required
    Description
    Provide by Provider.
  • Name
    merchant_api_key
    Type
    string
    required
    Description
    Provide by Provider.
  • Name
    transaction_code
    Type
    string
    required
    Description
    Generated by the operator. Must be unique for each transaction.
  • Name
    transaction_timestamp
    Type
    integer
    required
    Description
    Generate by the operator.

    This parameter describes the transaction request TimeRanges. The more detailed information regardings timestamps, please visit https://www.epochconverter.com/.

    Please note that we only process the timestamp on these limit.

    min: 1 hour before now

    max: 5 minutes after now

  • Name
    transaction_amount
    Type
    double
    required
    Description
    The amount of of the transaction.
  • Name
    payment_code
    Type
    string
    required
    Description
    Example P001. Please contact the administrator to get your payment code.
  • Name
    user_id
    Type
    string
    required
    Description
    Can be filled by the user key field on your system. For example : USR98323923
  • Name
    currency_code
    Type
    string
    required
    Description
    Please refer to currency list.
  • Name
    bank_code
    Type
    double
    required
    Description
    Required just on BDT, VND, THB, MMK, IDR, MYR, and PHP online bank payment PaymentMethodChangeEvent.
  • Name
    deposit_name
    Type
    string
    required
    Description
    Deposit name (mandatory for KRW).
  • Name
    callback_url
    Type
    string
    Description
    Url callback. We will send updated status from a transaction to your side using this url. You can choose either set it on our BO or by this parameter. If you set both then we will send a callback to both urls as well.
  • Name
    identity_id
    Type
    string
    required
    Description
    Required for Turkey (TRY)
  • Name
    phone
    Type
    string
    required
    Description
    Required for BDT, 11 digits numbers without country code (ex. 01812345678 )

Parameters Object
{
  "merchant_code": "",
  "merchant_api_key": "",
  "transaction_code": "",
  "transaction_timestamp": 0,
  "transaction_amount": 0,
  "payment_code": "",
  "user_id": "",
  "currency_code": "",
  "bank_code": "",
  "deposit_name": ""
}

These parameters must be encrypted before being sent through the key body.

Return

Returns a transaction status object. This call returns an error if an error occurs.

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