Wamo Card Processing
  • 19 Feb 2025
  • 3 Minutes to read
  • Dark
    Light

Wamo Card Processing

  • Dark
    Light

Article summary

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

Title

Description

Currencies Supported

EUR

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 Wamo to finalize the payment process.

if you are using our Hosted Payment Page

Description

Hosted Payment Page

Force Transaction Routing

“Routing”:{

"ForceBank": "WAMO”

Client Details

"Client": {

"Email": "test@gmail.com",

"FirstName": "Apco",

"LastName": "Test",

"MobileNo": "7777777",

"Street": "Church Street",

"City": "Virtu",

"State": "Rabat",

"ZIPCode": "RBT2640",

"Country": "MLT",

“IPAddress": "1.1.1.1"

}

Test Indicator

"isTest”: true

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

 {
  "TransactionType": "AUTH",
  "Amount": "1.00",
  "Currency": "EUR",
  "OrderReference": "Order23232",
  "UniqueReference": "00a00569-7b7d-43fa-a5d0-4aeb673c5a25",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "Routing": {
    "ForceBank": "WAMO"
  },
  "Client": {
    "Email": "apcotest@gmail.com",
    "FirstName": "Apco",
    "LastName": "Test",
    "MobileNo": "77777777",
    "ZIPCode": "RBT2640",
    "Street": "Church Street",
    "Country": "MLT",
    "City": "Virtu",
    "State": "Rabat",
    "ClientAccount": "testing"
  },
  "IsTest": true,
  "ExtraParameter": "AddDataTEST"
}

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

Description

Direct Connect

Force Transaction Routing

“Routing”:{

"ForceBank": "WAMO”

Client Details

"Client": {

"Email": "test@gmail.com",

"FirstName": "Apco",

"LastName": "Test",

"MobileNo": "7777777",

"Street": "Church Street",

"City": "Virtu",

"State": "Rabat",

"ZIPCode": "RBT2640",

"Country": "MLT",

“IPAddress": "1.1.1.1"

}

Card Details

"PaymentCredentials": {

"PaymentSource": "Card",

"CardNumber": "5351772561457936",

"CvV2": "483",

"ExpMonth": "05",

"ExpYear": "2029",

"CardHolderName": "Joe Smith"

},

Browser details

"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"

}

Test Indicator

"isTest”: true

Sample requests using Direct Connect can be viewed here.

 {
  "TransactionType": "PURC",
  "Amount": 1.1,
  "Currency": "EUR",
  "IsTest": true,
  "OrderReference": "123",
  "UniqueReference": "00a00569-7b7d-43fa-a5d0-4aeb673c5a25",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "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": "WAMO"
  }
}

Requesting a Capture or Void

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

Description

Direct Connect

Transaction Reference

"PspID": "342342”

sample request for processing a capture request.

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

Requesting a Payout (Direct Connect)

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

Description

PSP ID

Card Token

Full Card PAN

Force Transaction Routing

Not required

"Routing": {

"ForceBank": "WAMO"

},

"Routing": {

"ForceBank": "WAMO"

},

Client

"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"

},

"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"

},

"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"

},

Transaction or Payment Reference

"PspID": "342342”

"PaymentDestination": { "PaymentMethod": "CardToken", "CardToken": "c840e58e-519d-409a-b525-297fadf60733"

},

"PaymentDestination": {

"PaymentMethod": "Card",

"CardType": "VISA",

"CardNumber": "4000000000001018", "CardHolderName": "Apco Test",

"ExpMonth": "12",

"ExpYear": "2040",

"CvV2":"123"

},

Test Indicator

"isTest”: true

"isTest”: true

"isTest”: True

Sample Payout Request using the PSPID

{
  "TransactionType": "ORIGINALCREDIT",
  "Amount": "10.00",
  "Currency": "EUR",
  "OrderReference": "Order123123",
  "UniqueReference": "00a00569-7b7d-43fa-a5d0-4aeb673c5a25",
  "ClientAccount": "testing",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "RedirectionURL": "https://www.yourURLhere.com/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

Using our direct connect integration, below are the mandatory fields required for processing a recurring transaction. Notice that we are using a transaction reference as a payment credentials since a recurring transaction is linked to the original deposit.

Description

Direct Connect

Payment Credentials

"PaymentCredentials": {

"PaymentSource": "TransactionReference"

},

Client

"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"

},

Transaction Reference

"PspID": "342342”

Test Indicator

"isTest”: true

Sample Request of a Recurring transaction

 {
  "TransactionType": "PURC",
  "Currency": "EUR",
  "Amount": "5.1",
  "OrderReference": "Order3423432",
  "UniqueReference": "e0a65b67-6723-4ed4-bcdc-168f242f8df9",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "FailRedirectionURL": "https://www.yourURLhere.com/Redirect?page=failed",
  "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.

Card Details

5123456789012346

4000000000001018

4888524251678924



Was this article helpful?