7.2 Node.js Package | Capture Transaction

PayTabs Node.js Package makes integration with the PayTabs payment gateway very easy by providing a ready-made payment class that handles the card entry and, billing & shipping information and completes the missing details.

Capture request is available for successfully Authenticated Authorized transactions, to process a capture request tran_type should be “capture” and the transaction id of the original Authorize transaction that you want to capture should be passed in the tran_ref parameter.

You can either capture a partial or full authorized amount or based on the amount, we walk you through how to use and manage the below function:

let transactionCreated = function ($results){
    console.log($results);
}

paytabs.queryTransaction(
    transactionDetails,
    cartDetails,
    transactionCreated
);

Capture request is ONLY available for successfully Authorized (Auth) transactions. 

Through out the article we will use the transaction types clarified in our What is "tran_type"? solution article.

Transaction Reference 

let transactionDetails = [
    transaction.ref,
    transaction.typ,
    transaction.cls
];

Cart Details

let cartDetails = [
    cart.id,
    cart.currency,
    cart.amount,
    cart.description
];

transactionCreated (callable)

let transactionCreated = function ($results){
    console.log($results);
}

Sample Request Payload

To process a capture request, you have to pass a tran_type that MUST be “capture” and the transaction reference of the original authenticated "Auth" transaction that you want to capture, as shown in the below sample:

let transaction = {
    ref: 'TST2229801363947',
    typ: 'capture',
    cls: 'ecom'
};

let cart = {
    id: 'CAP100001',
    currency: 'EGP',
    amount: 200,
    description: 'partial capture test'
};

let transactionDetails = [
    transaction.ref,
    transaction.typ,
    transaction.cls
];

let cartDetails = [
    cart.id,
    cart.currency,
    cart.amount,
    cart.description
];

let transactionCreated = function ($results){
    console.log($results);
}

paytabs.queryTransaction(
    transactionDetails,
    cartDetails,
    transactionCreated
);

Capture request is ONLY available for successfully Authorized (Auth) transactions. 

The response PayTabs will send to you will be a JSON object that contains the full details regarding this capture transaction as shown below:

{
  tran_ref: 'TST2229901364842',
  previous_tran_ref: 'TST2229801363947',
  tran_type: 'Capture',
  cart_id: 'CAP100001',
  cart_description: 'partial capture test',
  cart_currency: 'EGP',
  cart_amount: '200.00',
  customer_details: {
    name: 'Mohammed ELRayes',
    email: 'elrayes@paytabs.com',
    phone: '+201234567890',
    street1: 'dummy street',
    city: 'Port Fouad',
    state: 'PTS',
    country: 'EG',
    zip: '42121'
  },
  payment_result: {
    response_status: 'A',
    response_code: 'G94611',
    response_message: 'Authorised',
    transaction_time: '1970-01-01T00:00:00Z'
  },
  payment_info: {
    payment_method: 'Visa',
    card_type: 'Credit',
    card_scheme: 'Visa',
    payment_description: '4111 11## #### 1111',
    expiryMonth: 12,
    expiryYear: 2022
  },
  serviceId: 1,
  profileId: 8***4,
  merchantId: 3***7,
  trace: 'PMN****4.63****73.00****43'
}

This means that the previously authorized/hold amount from a previous auth transaction will be captured/transferred from the cardholder's bank account to your bank account.

⌂ To get familiar with the whole process and the other steps, kindly navigate to our "The Node.js Packge Integration Manual" solution article. 

⇦ And to get familiar with the rest of the steps regarding the current step "Step 7 - Manage Transactions" kindly click here.

⇦ And to navigate to the previous step in the integration process "Step 6 - Handle the post payment responses" kindly click here.