---
title: "Monetix Card Processing"
slug: "monetix-card-processing"
updated: 2026-02-27T08:13:07Z
published: 2026-02-27T08:13:07Z
canonical: "docs.apcopay.com/monetix-card-processing"
---

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

# Monetix Card Processing

## Supported Transaction Types

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

## Integrations Supported

**Deposit - Authorisation / Purchase**

- [x] [Hosted Payment Page](https://apcopay.redoc.ly/#operation/CreateaHostedPaymentPageToken)
- [x] [Direct Connect ( server-to-server)](https://apcopay.redoc.ly/#operation/PaymentOperationAUTHPURC)

**Capture, Void, Refunds, Payouts, Recurring**

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

## Supported Wallet

- [ ] GooglePay
- [ ] Applepay

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

If you are using our **Hosted Payment Page**

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | "Routing": { "ForceBank": "MONETIXCARDS" } |
| **Client Details** | "Client": { "FirstName": "Apco", "LastName": "Test", "Email": "apcotest@test.com", "Street": "1,Street", "City": "Marsa", "ZIPCode": "MRS3000", "Country": "MT", "State": "Rabat", "MobileNo": "20100000000", "IPAddress": "192.168.0.1", "ClientAccount": "1234" } |
| **Test Indicator** | "isTest”: true |

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

```json
{
  "TransactionType": "PURC",
  "Amount": "5.00",
  "Currency": "KZT",
  "IsTest": true,
  "OrderReference": "MonetixCards Direct Deposit",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
   "FailRedirectionURL": "https://www.yourURLhere.com/Redirect",
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "Email": "apcotest@test.com",
    "Street": "1,Street",
    "City": "Marsa",
    "ZIPCode": "MRS3000",
    "Country": "MT",
    "State": "Rabat",
    "MobileNo": "20100000000",
    "IPAddress": "192.168.0.1",
    "ClientAccount": "1234"
  },
  "Routing": {
    "ForceBank": "MONETIXCARDS"
  }
}
```

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

| Description | Direct Connect |
| --- | --- |
| **Force Transaction Routing** | "Routing": { "ForceBank": "MONETIXCARDS" |
| **Client Details** | "Client": { "FirstName": "Apco", "LastName": "Test", "Email": "apcotest@test.com", "Street": "1,Street", "City": "Marsa", "ZIPCode": "MRS3000", "Country": "MT", "State": "Rabat", "MobileNo": "20100000000", "IPAddress": "192.168.0.1", "ClientAccount": "1234" } |
| **Card Details** | "PaymentCredentials": { "PaymentSource": "Card", "CardType": "VISA", "CardNumber": "4242424242424242", "CardHolderName": "Frictionless Processed", "ExpMonth": "12", "ExpYear": "2030", "CvV2": "666" } |
| **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",
  "Amount": "5.00",
  "Currency": "EUR",
  "IsTest": true,
  "OrderReference": "MonetixCards Direct Deposit",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "PaymentCredentials": {
    "PaymentSource": "Card",
    "CardType": "VISA",
    "CardNumber": "4242424242424242",
    "CardHolderName": "Frictionless Processed",
    "ExpMonth": "12",
    "ExpYear": "2030",
    "CvV2": "666"
  },
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "Email": "apcotest@test.com",
    "Street": "1,Street",
    "City": "Marsa",
    "ZIPCode": "MRS3000",
    "Country": "MLT",
    "State": "Rabat",
    "MobileNo": "20100000000",
    "IPAddress": "192.168.0.1",
    "ClientAccount": "1234"
  },
  "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": "MONETIXCARDS"
  }
}
```

### Requesting a Capture

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.

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

### Requesting a Payout

Using our direct integration, 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 | Full Card PAN |
| --- | --- | --- |
| **Force Transaction Routing** | *Not required* | "Routing": { "ForceBank": "MONETIXCARDS" } |
| **Client** | Client": { "FirstName": "Apco", "LastName": "Test", "Email": "apcotest@test.com", "Street": "1,Street", "City": "Marsa", "ZIPCode": "MRS3000", "Country": "MT", "State": "Rabat", "MobileNo": "20100000000", "IPAddress": "192.168.0.1", "ClientAccount": "1234" } | Client": { "FirstName": "Apco", "LastName": "Test", "Email": "apcotest@test.com", "Street": "1,Street", "City": "Marsa", "ZIPCode": "MRS3000", "Country": "MT", "State": "Rabat", "MobileNo": "20100000000", "IPAddress": "192.168.0.1", "ClientAccount": "1234" } |
| **Transaction or Payment Reference** | "PspId" : "970308", "PaymentMethodData": { "Gender": "male" } | }, "PaymentDestination": { "PaymentMethod": "Card", "CardType": "VISA", "CardNumber": "4242424242424242", "CardHolderName": "Apco Test", "ExpMonth": "12", "ExpYear": "2040", "CvV2":"123" } |
| **Test Indicator** | "isTest”: true | "isTest”: true |

**Sample Payout Request using the PSP ID**

```json
{
  "TransactionType": "ORIGINALCREDIT",
  "Amount": "5.00",
  "Currency": "KZT",
  "OrderReference": "MonetixCards payout",
  "ClientAccount": "testing",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "FailRedirectionURL": "",
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "Email": "apcotest@test.com",
    "Street": "1,Street",
    "City": "Marsa",
    "ZIPCode": "MRS3000",
    "Country": "MT",
    "State": "Rabat",
    "MobileNo": "20100000000",
    "IPAddress": "192.168.0.1",
    "ClientAccount": "1234"
  },
  "PspId" : "970308",
  "PaymentMethodData": {
    "Gender": "male"
  },
  "Routing": {
    "ForceBank": "MONETIXCARDS"
  },
  "IsTest": "True"
}
```

**Sample Payout Request using the FullPan**

```json
{
  "TransactionType": "ORIGINALCREDIT",
  "Amount": "5.00",
  "Currency": "KZT",
  "OrderReference": "MonetixCards payout",
  "ClientAccount": "testing",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "FailRedirectionURL": "",
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "Email": "apcotest@test.com",
    "Street": "1,Street",
    "City": "Marsa",
    "ZIPCode": "MRS3000",
    "Country": "MT",
    "State": "Rabat",
    "MobileNo": "20100000000",
    "IPAddress": "192.168.0.1",
    "ClientAccount": "1234"
  },
   "PaymentMethodData": {
    "Gender": "male"
  },
  "PaymentDestination": {
    "PaymentMethod": "Card",
    "CardType": "VISA",
    "CardNumber": "4242424242424242",
    "CardHolderName": "Apco Test",
    "ExpMonth": "12",
    "ExpYear": "2040",
    "CvV2":"123"
  },
  "Routing": {
    "ForceBank": "MONETIXCARDS"
  },
  "IsTest": "True"
}
```

**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](/v1/docs/test-card-numbers).