Step 3 – Token Charging / Frame Capture / Direct Interface Credit Card Charging. (Do Transaction)

When to use this function?

This function is typically used after steps 1 and 2.

Businesses that want to create subscriptions, work with tokens, and frame captures will use this function.

Additionally, the function is intended for performing charges in a direct interface model.

What is a "direct interface"?

A direct interface is intended for closed and secure systems or closed native applications (iOS / Android). Charging via a direct interface is done without redirecting to Cardcom’s PCI-compliant payment page.

Important to note: The direct interface model is not intended for websites (WEB). For such systems, the "low profile" module should be used.

On the WEB, a PCI standard is mandatory in the direct interface; without it, the business is vulnerable to hacks and fraud.

In applications, PCI compliance is less critical because hacking an app does not mean hacking the details of all other customers.

Direct Interface Charging Process

When working with the direct interface, it is impossible to obtain Cardcom’s PCI certification, so PCI certification must be obtained directly from the credit company. Additionally, credit card details must not be stored in the system but only transferred through the interface. Also, storing the CVV is forbidden.

Common operations in the "Do Transaction" function

With the "Do Transaction" function, you can perform the following actions:

• Charging and refunding tokens.

• Recurring charging of a token (standing orders).

• Charging and releasing a frame captured in the first step.

• Charging using credit card details (direct interface).

Note: For token charging, the terminal must not require CVV from credit companies.
Such a terminal does not verify the card’s expiry date (only requires it to be in the future), does not check CVV, and ID verification is optional depending on the agreement with the credit company.

Requirements & Necessary models

• Terminal without CVV requirement – for the token model.

• Token model – for token charging and refunding.

• Direct interface model – for performing transactions in a closed iOS system.

Step 3 – Token Charging & Credit Card Charging – Do Transaction

Below is the link to the function in JSON format.
Request method: POST.

Do Transaction
https://secure.cardcom.solutions/api/v11/Transactions/Transaction

Parameters required to be passed to the Do Transaction function:

Legend:

• Red parameter – mandatory

• Bold parameter – recommended

• Parameter not red or bold – optional

Values of the Advanced Object (14)

• 🔴 Red parameter – Required

• Bold parameter – Recommended

• Regular (not red or bold) – Optional

Values of the Document Object (15)

• 🔴 Red parameter – Required

• Bold parameter – Recommended

• Regular (not red or bold) – Optional

RESPONSE of DoTransaction

After sending a POST request to this function, the following values will be returned in the RESPONSE:

✅ Charging a token created in Step 1

{
  "TerminalNumber": 1001,
  "ApiName": "test2025",
  "Amount": 200,
  "Token": "4cf8e168-261e-4613-8d20-000332986b24",
  "CardExpirationMMYY": "0628",
  "ExternalUniqTranId": "h7rZ3#קV3Tp!7kLb0wUeG3zC",
  "ExternalUniqUniqTranIdResponse": false,
  "NumOfPayments": 1
}

✅ Charging a token + Document generation

{
  "TerminalNumber": 1001,
  "ApiName": "test2025",
  "Amount": 200,
  "Token": "4cf8e168-261e-4613-8d20-000332986b24",
  "CardExpirationMMYY": "0628",
  "ExternalUniqTranId": "h7rZ3#קV3Tp!7kL-b0wUeG3zC",
  "ExternalUniqUniqTranIdResponse": false,
  "NumOfPayments": 1,
  "Document": {
    "DocumentTypeToCreate": "TaxInvoiceAndReceipt",
    "Name": "תעבוד",
    "TaxId": "040617640",
    "Email": "test@gmail.com",
    "IsSendByEmail": false,
    "IsVatFree": false,
    "Products": [
      {
        "Description": "hey",
        "Quantity": 1,
        "UnitCost": 200
      }
    ]
  }
}

✅ Charging a captured authorization hold

{
  "TerminalNumber": 1001,
  "ApiName": "test2025",
  "Amount": 200,
  "Token": "4cf8e168-261e-4613-8d20-000332986b24",
  "CardExpirationMMYY": "1225",
  "ExternalUniqTranId": "h7rZ3#קV3Tp4!76-kLb0wUeG3zC",
  "ExternalUniqUniqTranIdResponse": false,
  "NumOfPayments": 1,
  "Advanced": {
    "ApprovalNumber": 204394904
  }
}

✅ Charging a captured authorization hold + Document generation

{
  "TerminalNumber": 1001,
  "ApiName": "test2025",
  "Amount": 200,
  "Token": "4cf8e168-261e-4613-8d20-000332986b24",
  "CardExpirationMMYY": "1225",
  "ExternalUniqTranId": "h7rZ3#קV3Tp4!76-kLb0wUeG3zC",
  "ExternalUniqUniqTranIdResponse": false,
  "NumOfPayments": 1,
  "Advanced": {
    "ApprovalNumber": 204394904
  },
  "Document": {
    "DocumentTypeToCreate": "TaxInvoiceAndReceipt",
    "Name": "תעבוד",
    "TaxId": "040617640",
    "Email": "test@gmail.com",
    "Products": [
      {
        "Description": "hey",
        "Quantity": 1,
        "UnitCost": 30
      }
    ]
  }
}

✅ Releasing a captured authorization hold

{
  "TerminalNumber": 1001,
  "ApiName": "test2025",
  "Amount": 200,
  "Token": "4cf8e168-261e-4613-8d20-000332986b24",
  "CardExpirationMMYY": "1225",
  "ExternalUniqTranId": "h7rZ3#קV3Tp4!76-kLb0wUeG3zC",
  "ExternalUniqUniqTranIdResponse": false,
  "NumOfPayments": 1,
  "Advanced": {
    "ApprovalNumber": 204394904,
    "MTI": 420
  }
}

✅ Credit charge (direct interface)

{
  "TerminalNumber": 1001,
  "ApiName": "test2025",
  "Amount": 200,
  "CardNumber": "4580000000000000",
  "CardExpirationMMYY": "0628",
  "CVV2": "569",
  "ExternalUniqTranId": "h7rZs#4V3Tp!7kLb0wUeG3zC",
  "ExternalUniqUniqTranIdResponse": false,
  "NumOfPayments": 1
}

✅ Credit charge + Document generation

{
  "TerminalNumber": 1001,
  "ApiName": "test2025",
  "Amount": 200,
  "CardNumber": "4580000000000000",
  "CardExpirationMMYY": "0628",
  "CVV2": "569",
  "ExternalUniqTranId": "h7rZs#4V3Tp!7kLb0wUeG3zC",
  "ExternalUniqUniqTranIdResponse": false,
  "NumOfPayments": 1,
  "Document": {
    "DocumentTypeToCreate": "TaxInvoiceAndReceipt",
    "Name": "בדיקה",
    "TaxId": "040617640",
    "Email": "t@t.com",
    "IsSendByEmail": false,
    "IsVatFree": false,
    "Products": [
      {
        "Description": "מוצר בדיקה",
        "Quantity": 1,
        "UnitCost": 200
      }
    ]
  }
}