Standalone Save Card

In the world of online payments, a seamless and efficient checkout process is crucial for an exceptional customer experience. E-commerce platforms often offer the option to save card details for future transactions, making future purchases a breeze.

At Geidea, we've taken this convenience to the next level by introducing a new method for customers to save their cards. Now, you can effortlessly add your card to your profile, even without initiating a checkout. This enhancement empowers both merchants and customers, providing greater flexibility and ease in managing payment methods.

Experience the future of hassle-free payments with Geidea – where convenience meets innovation.

How it works:

Through this method, the payment gateway verifies the customer's card with the issuer bank, facilitating the tokenization process and enabling the card to be stored for future use.

Pre-requisite for enabling this feature for a Merchant


The merchant will require tokenization to be enabled on their MID to use this feature.

Save card Flow

Enjoy a hassle-free experience with our streamlined Quick Save card activation!

Create Session for standalone Save card:
To get started with standalone "Save card", merchants simply initiate the process by making a POST request to the /savecard/create-session endpoint. This endpoint generates a unique session ID and sets up the environment, allowing you to effortlessly add your preferred payment method.

After initiating the process, customers are directed to the payment page.
The payment page provides a user-friendly interface for customers to securely enter their card details.
The page may include form fields for card number, expiration date, CVV, and any other relevant information.

Transaction Approval:
Once customers input their card details, the transaction is sent to the payment processor for approval.
Customers may be prompted to confirm the transaction, possibly through additional security measures like three-factor authentication.
The payment processor communicates the approval status back to the merchant with token details

Token Generation:
Upon successful approval, the payment processor generates a unique token for the particular customer.
The token serves as a secure identifier for the customer's payment information without exposing sensitive card details.
The token is sent back to the merchant's server, typically as part of the response to the payment approval request.

Automatic Transaction Void:
After token generation and confirmation, the merchant's system automatically voids the initial transaction.
The voiding process ensures that the end-customer is not charged for the initial transaction made for the purpose of saving the card.
The merchant retains the secure token for future transactions without the need to keep any sensitive card information.

Integration steps

To implement/utilize the feature enabling customers to add their card as a payment method on the website, adhere to the following procedural steps:

  1. Initiate the process by generating a session through the designated endpoint 'Savecard' prior to launching the new Savecard flow page.
  2. Upon completion, the merchant will obtain a 'sessionId' within the response. This 'sessionId' is crucial for commencing the savecard flow at a later stage.



Your API password is a secret key! It is important to never expose it in the frontend of your application. Ensure its security, by storing your API password securely on the server-side, and use a backend proxy to handle API requests to the frontend application. This precautionary approach guarantees that your API password remains confidential on the client side, minimizing the risk of unauthorized access and potential data breaches.

currencyThe currency of the payment. This is a 3-digit alphabetic code, following the ISO 4217 currency code standard. For example: SAR

List of available currencies:
SAR Saudi Riyal
EGP Egyptian Pound
AED UAE Dirham
QAR Qatari Rial
OMR Omani Rial
BHD Bahraini Dinar
KWD Kuwaiti Dinar
USD US Dollar
GBP UK Pound Sterling
EUR Euro

To enable multicurrency for your account - contact our support team.

Below is an example of executing a Create Session API ffor Quick Savecard

curl --location '' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic ZjdjYzhmMjktYWI5YS00YjYyLTg3NjYtYjZhMGNjM2EyMmEzOjAxYjI2YWU3LTFkNmUtNDliOC05MDM4LTVmNzRmYjU5NzUyZQ==' \
--data '{
    "currency": "EGP"

Create Session Response

After sending the create session request in the example above - if your request is valid, then you will receive a response which includes a session object, with a parameter inside. You will need to use this later in order to start Geidea checkout.

Below is an example of a successful response you can expect to receive for the create session request above.

    "session": {
        "id": "a96d87fc-e568-4302-241a-08dc13889484",
        "amount": 1,
        "currency": "EGP",
        "callbackUrl": null,
        "returnUrl": null,
        "expiryDate": "2024-01-23T12:23:33.0755964Z",
        "status": "Initiated",
        "merchantId": "0c00a7f5-7e26-44a7-9f9f-08db6b89eb58",
        "merchantPublicKey": "f7cc8f29-ab9a-4b62-8766-b6a0cc3a22a3",
        "language": null,
        "merchantReferenceId": null,
        "paymentIntentId": null,
        "paymentOperation": "SaveCard",
        "cardOnFile": true
    "responseMessage": "Success",
    "detailedResponseMessage": "The operation was successful",
    "language": "EN",
    "responseCode": "000",
    "detailedResponseCode": "000"

Start the payment

After you have created your session, received your, and initialized the payment object, you are ready to start the payment with Geidea Checkout.

To start the payment, you will need to use the startPayment method by passing the which you received when you created the session

// initialize the payment object
const payment = new GeideaCheckout(onSuccess, onError, onCancel);

// start the payment

The startPayment method must be attached to an action on your web page - you can attach it to a 'Checkout' or a 'Pay' button, or you can use any preferred onClick event on your own web page.

After triggering the startPayment method, Geidea Checkout will appear as a modal/popup iframe on top of your web page by default. This is the recommended flow

Customer Interaction

Customers visit the merchant's website and navigate to the payment section.
They click on the "Add Payment Method" button or a similar action that triggers the initiation of the Quick Savecard process.
This action opens the payment page and signals the beginning of the payment method addition process.