Skip to main content

Token-Based Transactions - CVV Only Payments

you should know

You should know that This step can be used and will behave the same in the following integration types:(Hosted Payment Page).

This manual provides guidance on creating a payment page using a Saved Card Token (CVV-Only), allowing customers to complete payments by entering only their CVV without needing to re-enter full card details. You will learn about the necessary parameters required to initiate a customer-initiated payment request effectively.

The Endpoint and Related Postman Collection​

In this manual, we will rely on the PayTabs Hosted Payment Page API Endpoint, mentioned on PayTabs API endpoints postman collection, which you can access fromPayTabs Postman APIs Collection. The endpoint will need to be accessed with a POST request on the below-mentioned URL

POST{{domain}}/payment/request
Be Aware Of

Please note that not using the proper endpoint URL {domain} will lead to authentication issues within your responses. To find the your proper domain you can read ourWhat is my (Region)/(endpoint URL)?tutorial article.

https://secure.paytabs.sa/payment/request

The Required Parameters​

Along with the required parameters specified in "Step 3" of the integration type you are using, you will need to use the following parameter:

  • token

    Parameter
    token
    DescriptionTo know more about this parameter please click here.
    Data TypeSTRING
    Required✘
    Sample
    {
        "token": "2C4652BD67A3EF30C6B390F9668175B9"
    }

  • tran_ref

    Parameter
    tran_ref
    DescriptionIndicates the Transaction Reference on the PayTabs side check details on [Response Parameters | tran_ref]
    Data TypeSTRING
    Required✘
    Sample
    {
        "tran_ref": "TST2234701408XXX"
    }

Request & Response Payloads Samples​

The below sample request payload will show you how you can pass the above-mentioned required parameter, which are needed to be passed with valid values to perform a request. Along with the response payload received after using this request payload.

{
    "profile_id": "79010",
    "tran_type": "sale",
    "tran_class": "ecom",
    "cart_id": "cart_1",
    "cart_currency": "SAR",
    "cart_amount": 12.3,
    "cart_description": "Description of the items/services",
    "paypage_lang": "en",
    "customer_details": {
       "name": "FirstName LastName",
       "email": "[email protected]",
       "phone": "9771555555555",
       "street1": "street2",
       "city": "dubai",
       "state": "dubai",
       "country": "AE",
       "zip": "54321"
    },
    "shipping_details": {
        "name": "FirstName LastName",
        "email": "[email protected]",
        "phone": "971555555555",
        "street1": "street2",
        "city": "dubai",
        "state": "dubai",
        "country": "AE",
        "zip": "54321"
    },
    "token": "2C4654BE67A3E530C6BF90FF65877DBB"
}

Expected Payment Flow Behavior​

  1. First, you should initiate a payment by following the steps mentioned in Hosted Payment Page | Initiating the Payment manual.

  2. Next, you should use the tokenise parameter within your request as clarified in the above Sample Request Payload.

  3. Then, you will receive a response that includes redirect URL. This means you have initiated a correct payment request/page successfully.

    "redirect_url": "https://secure.paytabs.com/payment/page/599458B182E5B6B********************B4818688",

  4. Next, you should redirect your customer to this URL so the payment process can be finalized.

  5. After this, your customer would proceed normally with payment by providing his card information.

  6. Then, he will be redirected to his issuer bank 3DS/OTP page to authenticate the used card

  7. Finally, he would be redirected to a success/error page accordingly. By this time, you will receive the full transaction response in the specified return or callback urls, which will contain the generated token as shown below:

    {
        .
        .
        .
        "token":"{Generated Token}"
        .
        .
        .
    }

  8. Finally, you should save this token in you database so that you can use it to create token-based transactions.

We are glad to be always in help. We aim to serve you better each time. As such, please spare a minute to share feedback about your recent experience with PayTabs Developers , on Trustpilot, or Google Reviews.