iCard Card Processing

Supported Transaction Types

• Authorisation AUTH

• Capture CAPT

• Purchase PURC

• Refund PARTIALREFUND

• Void GENERALVOID

• Payouts ORIGINALCREDIT

• Recurring AUTH / PURC

Integrations Supported

Deposit - Authorisation / Purchase

• Hosted Payment Page

• Direct Connect ( server-to-server)

Capture, Void, Refunds, Payouts, Recurring

• Hosted Payment Page

• Direct Connect ( server-to-server)

Currencies & Countries Supported

Additional attributes to process Deposits

You must include the following JSON Attributes to the payload. These attributes inform us to proceed with the redirection to iCard to finalize the payment process.

if you are using our Hosted Payment Page

Sample requests using our Hosted Payment Page can be viewed here.

 {
  "TransactionType": "AUTH",
  "Amount": 10.00,
  "Currency": "EUR",
  "OrderReference": "Order4523",
  "UniqueReference": "e0a65b67-6723-4ed4-bcdc-168f242f8df9",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "FailRedirectionURL": "https://yourURLhere.com/FailRedirect/"
  "Routing": {
    "ForceBank": "ICARD"
  },
  "Client": {
    "Email": "apcotest@gmail.com",
    "FirstName": "Apco",
    "LastName": "Test",
    "Country": "MLT",
    "City": "Virtu",
    "ClientAccount": "testing",
    "IPAddress": "1.1.1.1"
  },
  "IsTest": true
}

If you are using our direct connect solution (server-to-server)

Sample requests using Direct Connect can be viewed here.

 {
  "TransactionType": "PURC",
  "Amount": 10.23,
  "Currency": "EUR",
  "IsTest": true,
  "OrderReference": "123",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "FailRedirectionURL": "https://yourURLhere.com/FailRedirect/",
  "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "PaymentCredentials": {
    "PaymentSource": "Card",
    "CardType": "VISA",
    "CardNumber": "4000000000001018",
    "CardHolderName": "Frictionless Processed",
    "ExpMonth": "12",
    "ExpYear": "2030",
    "CvV2": "666"
  },
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "Email": "apcotest@test.com",
    "Street": "1,Street",
    "City": "Marsa",
    "IPAddress": "1.1.1.1",
    "ZIPCode": "MRS3000",
    "Country": "MLT",
    "State": "Rabat",
    "MobileNo": "+20100000000"
  },
   "BrowserDetails": {
    "UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
    "JavaEnabled": true,
    "ScreenColorDepth": "1",
    "ScreenWidth": "1080",
    "ScreenHeight": "840",
    "TimeZone": "2",
    "AcceptHeader": "application/json",
    "BrowserLanguage": "en"
  },
  "Routing": {
    "ForceBank": "ICARD"
  }
}

Requesting a Capture

If you wish to Capture a transaction of type Authorisation, below are the mandatory fields.

sample request for processing a capture request.

{
"TransactionType": "CAPT",
"Amount": 10.00,
"CallBackURL": "https://www.yourURLhere.com/Listener",
"IsTest": true,
"UniqueReference": "6514441d-8abe-4d7b-9e0c-3aa386333b34",
"PspID":"839791"
}

Requesting a Payout

Using our direct integration, below are the mandatory fields required to process a payout. We currently support three options for payout:

• via a PSP ID

• via a Card Token

• via a full Card PAN details

Sample Payout Request using the PSP ID

{
  "TransactionType": "ORIGINALCREDIT",
  "Amount": 1.00,
  "Currency": "EUR",
  "OrderReference": "Order42323",
  "UniqueReference": "e0a65b67-6723-4ed4-bcdc-168f242f8df9",
  "ClientAccount": "testing",
  "CallBackURL": "https://api.dev.apspglobal.com/technicalsupporttool-fe/Listener",
  "RedirectionURL": "https://api.dev.apspglobal.com/technicalsupporttool-fe/Redirect/",
  "FailRedirectionURL": "https://www.yourURLhere.com/Redirect/failed",
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "Email": "apcotest@test.com",
    "Street": "1,Street",
    "City": "Marsa",
    "IPAddress": "1.1.1.1",
    "ZIPCode": "MRS3000",
    "Country": "MLT",
    "MobileNo": "+20100000000"
  },
  "IsTest": true,
  "PSPID": "823205"
}

Requesting a Recurring transaction

The mandatory fields are required to process a recurring transaction using our direct connect integration. Note that we use a transaction reference as payment credentials since a recurring transaction is linked to an original deposit.

Sample Request of a Recurring transaction

 {
  "TransactionType": "PURC",
  "Currency": "EUR",
  "Amount": 10.12,
  "OrderReference": "Order2323",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "FailRedirectionURL": "https://www.yourURLhere.com/Redirect?page=failed",
  "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
  "Language": "en",
  "IsTest": true,
  "PspId": "840510",
  "PaymentCredentials": {
    "PaymentSource": "TransactionReference"
  },
  "Client": {
    "Email": "apcotest@gmail.com",
    "FirstName": "Apco",
    "LastName": "Test",
    "MobileNo": "77777777",
    "ZIPCode": "RBT2640",
    "Street": "Church Street",
    "Country": "MLT",
    "City": "Virtu",
    "State": "Rabat",
    "ClientAccount": "testing"
  }
}

Test Credentials

Test Card details below. You must use a future expiry date and use “Frictionless Processed” as the cardholder name. For more test information on different card use cases here.