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, invoices ( Payment endpoint) ).

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
    Descriptiontoken from previously tokenised transaction. To know more about this parameter please click here.
    Data TypeSTRING
    Required✔
    Sample
    {
      "token": "2C4652BD67A3EF30C6B390F9668175B9"
    }

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 to create token by following the steps mentioned in Token-Based Transactions | Create Token manual.

  2. Next, you should save The token parameter As you already created it in the previous step.

  3. You will create a standard request by following the instructions provided in the Hosted Payment Page | Initiating the Payment, including the token in the request as shown in the shared request payload sample

  4. 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",

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

  6. Once you have redirected your client, the client browser will display the following page to the client, to enter the CVV and click Pay now

    Alt text

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

  8. After, finishing the 3Ds/OTP phase, you will redirected back to the return URL you provided and handle the response from the callback.

  9. Finally,here you achieved the Token-based transaction, the payment is finished using the Token you only provided the CVV

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.