- 19 Feb 2025
- 3 Minutes to read
- Print
- DarkLight
Wamo Card Processing
- Updated on 19 Feb 2025
- 3 Minutes to read
- Print
- DarkLight
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 |