---
title: "PurplePay Card Processing"
slug: "purplepay"
updated: 2026-02-27T08:03:26Z
published: 2026-02-27T08:03:26Z
canonical: "docs.apcopay.com/purplepay"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apcopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PurplePay Card Processing

## Supported Transaction Types

- [ ] Authorisation `AUTH`
- [ ] Capture `CAPT`
- [x] Purchase `PURC`
- [ ] Refund `PARTIALREFUND`
- [ ] Void `GENERALVOID`
- [ ] Payouts `ORIGINALCREDIT`
- [ ] Recurring `PURC`

## Integrations Supported

**Deposit - Authorisation / Purchase**

- [x] Hosted Payment Page
- [x] Direct Connect ( server-to-server)

## Supported Wallet

- [ ] GooglePay
- [ ] Applepay

## Currencies & Countries Supported

| Title | Description |
| --- | --- |
| **Currencies Supported** | Various |

## 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**

| Description | Hosted Payment Page |
| --- | --- |
| **Transaction Type** | "TransactionType": "PURC" |
| **Force Transaction Routing** | "Routing": { "ForceBank": "PVISA" } |
| **Client Details** | "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" } |
| **Test Indicator** | "isTest": true |

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

```json
{
  "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)

| Description | Direct Connect |
| --- | --- |
| **Transaction Type** | "TransactionType": "PURC" |
| **Force Transaction Routing** | "Routing": { "ForceBank": "PVISA" } |
| **Client Details** | "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" } |
| **Card Details** | "PaymentCredentials": { "PaymentSource": "Card", "CardType": "VISA", "CardNumber": "4544445544554454", "Cvv2": "123", "ExpMonth": "03", "ExpYear": "2027", "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.

```json
 {
    "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"
    }
}
```