Payment

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.

Query Parameters

  • Name
    key
    Type
    string
    required
    Description

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

cURL
curl --request GET \
  --url https://staging.s88pay.net/{merchant_code}/v2/dopayment?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
    Please contact the administrator to get your payment code. Example P001.
  • 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
    Description
    Required just on VND, THB, IDR, MYR, and PHP online bank payment.
  • 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
    return_url
    Type
    string
    Description
    Dynamic return URL to redirect back to the merchant page after completing transactions.
  • Name
    random_bank_code
    Type
    string
    Description
    Only for VND (Use value BankQR for E-Wallet and OBT for bank transfer).

    If this parameter is filled then our system will search available bank channels and show it to your users randomly. In this case, you do not need to fill the bank_code parameter.

Example Parameters
merchant_code=ABC123&merchant_api_key=xyz456&transaction_code=TRX123456789&transaction_timestamp=1649699762&transaction_amount=100.50&payment_code=P001&user_id=user123&currency_code=USD&bank_code=null&callback_url=https://example.com/callback&return_url=https://example.com/return&random_bank_code=null

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

Return

Returns a redirect to our payment page. This call returns an error if an error occurs.