Version 3 Create a payment session

Developing

POST

/checkout/senangpay/v3/payment

Initiates a payment session by sending payment and customer details from your server.
On success, returns a uuid (client token) valid for 60 seconds that must be passed
to the JavaScript Web SDK (senangpay.pay(uuid)) to render the payment interface.

Hash Generation

The hash parameter must be generated as a SHA256 HMAC or SHA256 of the following
concatenated string:

{secret_key}{customer_name}{customer_email}{customer_phone}{order_id}{amount}{detail}{payment_method}

Request

Authorization

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/x-www-form-urlencodedRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/checkout/senangpay/v3/payment' \
--header 'Authorization: Basic <encoded-value>' \
--data-urlencode 'payment_method=' \
--data-urlencode 'order_id=' \
--data-urlencode 'detail=' \
--data-urlencode 'customer_name=' \
--data-urlencode 'customer_phone=' \
--data-urlencode 'customer_email=' \
--data-urlencode 'hash=fbc19804e260fb93e8156c56cf210640525cd5a428d93452cb06d72eb6cf96f6' \
--data-urlencode 'amount=' \
--data-urlencode 'fpx_bank_code=' \
--data-urlencode 'filter_card=1' \
--data-urlencode 'filter_card=2' \
--data-urlencode 'shopeepay_platform='

Responses

🟢200Successfully

application/json

Payment session created successfully

Body

Examples

Successful session creationFailed session creation

{
    "result": 1,
    "msg": "payment is successfully",
    "uuid": "a3f5c9e1-7b2d-4f8a-93c6-1e4d2b7a0f55"
}

🟢200Failed

Modified at 2026-03-25 09:35:44

Get list of available FPX banks

Version 1 Create a payment session

Version 3 Create a payment session

Hash Generation#

Request

Request Code Samples

Responses

Hash Generation