Epay Card Processing

Supported Transaction Types

• Authorisation

• Capture

• Purchase

• Refund*

• Void

*Direct Connect only

Integrations Supported

Deposit:

• Hosted Payment Page

• Direct Connect ( server-to-server)

Refund:

• Hosted Payment Page

• Direct Connect ( server-to-server)

Additional Parameters Required for Deposit

Depending on the integration type being used, these are the additional parameters required

Sample Request via Hosted Payment Page

{
  "TransactionType": "PURC",
  "Amount": "1.00",
  "Currency": "USD",
  "OrderReference": "order1234",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https:/https://www.yourURLhere.com/Listener",
  "FailRedirectionURL": "https://yourURLhere.com/FailRedirect/",
  "IsTest": "True",
  "Routing": {
    "ForceBank": "EPAY"
  },
  "Client": {
    "Email": "apcotest@test.com",
    "FirstName": "APCO",
    "LastName": "Test",
    "City": "Valletta",
    "IPAddress": "214.21.134.79",
    "ClientAccount": "testing",
    "ZIPCode": "1234",
    "Country": "USA",
    "Street": "Street1",
    "MobileNo": "35699777766"
  }
}

Sample Request via Direct Connect

{
  "TransactionType": "PURC",
  "Amount": "100",
  "Currency": "USD",
  "OrderReference": "123456",
  "PaymentCredentials": {
    "PaymentSource": "Card",
    "CardNumber": 5351772561457936,
    "CvV2": "483",
    "ExpMonth": "05",
    "ExpYear": "2029",
    "CardHolderName": "Cardholder Test"
  },
  "Client": {
    "ClientAccount": "APCOPAY TEST",
    "FirstName": "John",
    "LastName": "Doe",
    "Email": "apcopayintegrations@apcopay.com",
    "City": "Fakecity",
    "IPAddress": "127.0.0.1"
  },
  "Routing": {
    "ForceBank": "EPAY"
  },
  "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"
  },
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https:/https://www.yourURLhere.com/Listener",
  "IsTest": "True"
} 

Additional Parameters Required for Refund

Below are the additional tag/s required to process a refund.

Sample Refund request:

 {
  "TransactionType": "PARTIALREFUND",
  "Amount": "1.10",
  "Currency": "USD",
  "OrderReference": "order 1234",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "Country" : "MLT", 
  "IsTest": "True",
  "ClientAccount": "CLI102134511",
  "PspID":"4124743"
}

Test card Numbers

3D Payment Test Cards