---
title: "Mpay Card Processing"
slug: "mpay-cards"
updated: 2026-02-27T08:12:14Z
published: 2026-02-27T08:12:14Z
canonical: "docs.apcopay.com/mpay-cards"
---

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

# Mpay Card Processing

## Supported Transaction Types

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

## Integrations Supported

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

## Supported Wallet

- [ ] GooglePay
- [ ] Applepay

## Currencies & Countries Supported

| Title | Description |
| --- | --- |
| **Currencies Supported** | TRY |
| **Countries Supported** | - Turkey - |

## Additional attributes to process Mpay Cards

You must include the following JSON Attributes to the payload. These attributes inform us to proceed with the redirection to Mpay to finalize the payment process.

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

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | “Routing”:{ "ForceBank": "MPAY” } |
| **Client Details** | "Client": { "FirstName": "Apco", "LastName": "Test", "Email": "test@gmail.com", "City": "Valletta", "IPAddress": "214.21.134.79" } |
| **Test Indicator** | "isTest”: true |

Sample requests using our Hosted Payment Page can be viewed below:

```json
{
  "TransactionType": "PURC",
  "Amount": 150,
  "Currency": "TRY",
  "OrderReference": "MPAY TEST",
  "RedirectionURL": "https://yourURLhere.com/Redirect/",
  "CallBackURL": "https://yourURLhere.com/Listener",
  "FailRedirectionURL": "https://yourURLhere.com/FailRedirect/",
  "IsTest": true,
  "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
  "Routing": {
    "ForceBank": "MPAY"
  },
  "Client": {
    "FirstName": "Apco",
    "LastName": "Test",
    "ClientAccount": "APCOPAY TEST",
    "Email": "johndoe@mail.com",
    "City": "Valletta",
    "IPAddress": "214.21.134.79"
  }
}
```

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

| Description | Direct Connect |
| --- | --- |
| **Transaction Type** | "TransactionType": "AUTH" or "PURC" |
| **Force Transaction Routing** | "Routing":{ "ForceBank": "MPAY” } |
| **Client Details** | "Client": { "Email": "test@gmail.com", "FirstName": "Apco", "LastName": "Test", "ClientAccount": "testing", "City": "Virtu", "IPAddress": "1.1.1.1" } |
| **Card Details** | "PaymentCredentials": { "PaymentSource": "Card", "CardType": "MASTERCARD", "CardNumber": "5351772561457936", "CvV2": "123", "ExpMonth": "02", "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 below.

```json
 {
  "TransactionType": "PURC",
  "Currency": "TRY",
  "Amount": "150.00",
  "OrderReference": "MPAY TEST",
  "UniqueReference" : "7ed0363e-ae73-4564-a798-3e51379f863c",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/callback",
  "FailRedirectionURL": "https://www.yourURLhere.com/FailRedirect",
  "IsTest": true,
  "Routing": {
    "ForceBank": "MPAY"
  },
  "Client" : {
    "Email" : "testing@mpay.com",
    "ClientAccount": "testing",
    "FirstName": "Apco",
    "LastName": "Test",
    "City" : "Istanbul",
    "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" : "MASTERCARD",
    "CardNumber": "5351772561457936",
    "CvV2": "123",
    "ExpMonth": "05",
    "ExpYear": "2025",
    "CardHolderName": "Frictionless Processed"
  }
}
```

**Test Credentials**

**Test Card**

| Details |  |
| --- | --- |
| TR ID | 41545968462 |
| DOB | 22.07.2001 |
| Card No | 4230 9142 2895 2608 |
| Exp Date | 02/29 |
| CVV | 737 |