Skip to content
logo
  • Products
    • Amwal Checkout
    • Merchant App
    • Merchant Control Panel
  • Pricing
  • Developers
  • About us
  • Contact Us
Sign In
BA Booking

BA Booking

2
  • BA Booking overview
  • BA Booking Installation
amwalpay woocommerce

Woocommerce

2
  • Overview
  • Woocommerce Installation
CS-Cart

CS Cart

2
  • CS-Cart Overview
  • CS CART Installation
Shopify

Shopify

2
  • Shopify Overview
  • Shopify Installation
odoo

Odoo

2
  • Odoo Overview
  • Odoo Installation
whmcs

WHMCS

2
  • WHMCS Overview
  • WHMCS Installation
Magento

Magento

2
  • Magento 2 Overview
  • Magento Installation
Opencart

Opencart

2
  • OpenCart Overview
  • Opencart Installtion
ZenCart

ZenCart

2
  • ZenCart Overview
  • Zencart Installation
Drupal

Drupal

2
  • Drupal Overview
  • Drupal Installation
PrestaShop

PrestaShop

2
  • PrestaShop Overview
  • PrestaShop Installation
Contact Form 7

Contact Form 7

2
  • Contact Form 7 Overview
  • Contact Form 7 Installation
Joomla

Joomla

2
  • Joomla Overview
  • Joomla Installation
AMWAL INTEGRATED PAYMENT LINK

Integrated Payment Link

1
  • Implementation
Android SDk

Native Android SDK

2
  • Pre Requisites
  • Implementation
ios SDk

Native iOS SDK

3
  • Apple Pay Specific Configuration
  • Pre Requisites
  • Implementation
React SDk

React Native SDK

1
  • Implementation

Laravel Package

2
  • Installation
  • Configuration

Flutter SDK

2
  • Implementation
  • Flutter SDK Overview

SMARTBOX

3
  • Pre Requisites
  • Implementation
  • Acquiring Session Token

Merchant Cloud Notification

1
  • Merchant Cloud Notification Integration Guide

Secure Hash Calculation

1
  • Secure Hash Calculation
View Categories
  • Home
  • Developer | Amwalpay
  • SMARTBOX
  • Acquiring Session Token

Acquiring Session Token

Configuration #

This section describes the parameters you need to configure before submitting the payment request. Below is a table of all the required parameters:

Field Name Mandatory Field Type Constraints Description Sample Value
customerId Yes String Length: 1–36 Unique identifier for the customer. Received when the customer checks “save card” option. The completeCallBack will hold the customerId value. 7267684c-3600-403e-81c7-87d778496e28
merchantId Yes Numeric Length: 1–30 AMWAL Payment Gateway MerchantID 189903
requestDateTime Yes String DateTime Request Date Time “2023-11-12T10:38:39.92000Z”
secureHashValue Yes String See section “Generate The Secure Hash” Secure Hash Value “84EB3BF62F25717D1E9E13C3CFB719A890980BF2631AFB8965182ADE1754”

NOTE: Ensure that the requestDateTime matches the server time closely to avoid security validation errors.

Acquiring Session Token #

The Customer/GetSmartboxDirectCallSessionToken API provides a session token that merchants can use to access a customer’s saved cards for recurring payments. Merchants should acquire and store the customerId when the customer first chooses to save their card during payment.

URLs:

  • Production: https://webhook.amwalpg.com/Customer/GetSmartboxDirectCallSessionToken
  • SIT: https://test.amwalpg.com:24443/Customer/GetSmartboxDirectCallSessionToken
  • UAT: https://test.amwalpg.com:14443/Customer/GetSmartboxDirectCallSessionToken

Sample Request

Method: POST

Content Type: application/json

Authentication: Secure Hash (secureHashValue)

POST /Customer/GetSmartboxDirectCallSessionToken

Content-Type: application/json

{
/*customer id is the value that merchant received with the response of
the first transaction execution and with request to enable save card
checkbox at the Payment Page, the complete call back will hold the
customer Id value.
The unique CustomerId should be received in the response so that
merchant can save and use it here to generate a private session token
for the next payment.
This session token should allow the customer to see his saved cards in
order to choose from them and proceed with payment*/
"customerId":"7267684c-3600-403e-81c7-87d778496e28",
"merchantId": 7921,
"requestDateTime": "2023-11-12T10:38:39.92000Z",
"secureHashValue":"84EB3BF8F62EF25717D1E9E13C3CFB719A890980BBF2631AFD
8965182ADE1754"
}

Sample Response #

If the request is successful, the response will include a sessionToken, allowing the customer to view and select from their saved cards

{
"success": true,
"responseCode": "00",
"message": "Success",
"data": {
"sessionToken":
"eyJhbGciOiJkaXIiLCJlbmMiOiJBMTI4Q0JDLUhTMjU2In0..w__uUsJEv6GYqWSAbSHl4
w.g44u9CS3hFSYe3DWaixF3rITecIognMFIAgg7eQUBLl7EUR76acc2km4xwfKKLJuFtZbR4A4I7JgJX3jFE
qxgfERYEvbS-
},
"errorList": []
}

#

Updated on January 28, 2026

What are your Feelings

  • Happy
  • Normal
  • Sad

Share This Article :

  • Facebook
  • X
  • LinkedIn
  • Pinterest
Implementation
Table of Contents
  • Configuration
    • Acquiring Session Token
    • Sample Response

Secure. Seamless – Powering Payments for Every Business.

Sign Up
Support

4th Floor, Majan Tower Building
North Al Ghubrah, P.O. Box 233, P.C 118
Muscat, Sultanate of Oman

: support@amwal-pay.com

📞 : +96824121845

Resources
  • Developers
  • Careers
Company
  • About us
  • Contact Us
  • Contact Sales
  • Partners

2026 © AmwalPay. All Rights Reserved.

  • Terms & Conditions
  • Privacy Policy