PurplePay Card Processing

Supported Transaction Types

• Authorisation AUTH

• Capture CAPT

• Purchase PURC

• Refund PARTIALREFUND

• Void GENERALVOID  

• Payouts ORIGINALCREDIT

• Recurring PURC

Integrations Supported

Deposit - Authorisation / Purchase

• Hosted Payment Page

• Direct Connect ( server-to-server)

Currencies & Countries Supported

Additional tags to process Deposits

You must include the following JSON Attributes in the payload. These attributes inform us to proceed with the redirection to PurplePay to finalise the payment process.

If you are using our Hosted Payment Page

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

{
  "TransactionType": "PURC",
  "Amount": "10",
  "Currency": "EUR",
  "Language": "en",
  "OrderReference": "PURPLEPAY",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "FailRedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "IsTest": "True",
  "Routing": {
    "ForceBank": "PVISA"
  },
  "Client": {
    "ClientAccount": "APCOPAY TEST",
    "FirstName": "Apco",
    "LastName": "Test",
    "Email": "support@apcolabs.tech",
    "City": "City",
    "ZIPCode": "Zip Code",
    "Country": "MLT",
    "MobileNo": "0035612345678",
    "IPAddress": "127.0.0.1",
    "Street": "House No Street",
    "DateOfBirth": "1977-12-31"
  }
}

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

Sample requests using Direct Connect can be viewed here.

 {
    "TransactionType": "PURC",
    "Currency": "EUR",
    "Amount": 1.00,
    "OrderReference": "Order12324",
    "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
    "Language": "en",
    "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
    "CallBackURL": "https://www.yourURLhere.com/callback",
    "FailRedirectionURL": "https://www.yourURLhere.com/FailRedirect",
    "IsTest": true,
     "Routing":{
     "ForceBank": "PVISA"
  },
    "Client": {
        "Email": "joe.bloggs@testjb.com",
        "ClientAccount": "CliAcc01002",
        "FirstName": "Joe",
        "LastName": "Smith",
        "Country": "MLT",
        "MobileNo": "0044123456789",
        "Street": "High Street",
        "City": "Valletta",
        "ZIPCode": "VLT1234",
        "State": "Valletta",
        "IPAddress": "214.21.134.79"
    },
    "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"
    },
    "PaymentCredentials": {
        "PaymentSource": "Card",
        "CardType": "VISA",
        "CardNumber": "4544445544554454",
        "CvV2": "123",
        "ExpMonth": "12",
        "ExpYear": "2028",
        "CardHolderName": "Frictionless Processed"
    }
}