---
title: "Mpay - Payment Options"
slug: "mpay-po"
updated: 2025-08-20T11:21:56Z
published: 2025-08-20T11:21:56Z
canonical: "docs.apcopay.com/mpay-po"
---

> ## 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 Payment Options

**List of Supported Payment Options**

| **Name** | Deposit | Withdrawal |
| --- | --- | --- |
| EFT | ✅ | ✅ |
| Papara | ✅ | ✅ |
| Paratim (MEFETE) | ✅ | ✅ |
| PopyWallet | ✅ | ✅ |
| Parolapara | ✅ | ✅ |

## Supported Transaction Types

- [ ] Authorisation
- [ ] Capture
- [x] Purchase
- [x] Withdrawal*
- [ ] Void

- as per the table above.

## Integrations Supported

For the Deposit flow:

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

For the Withdrawal flow:

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

## Currencies & Countries Supported

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

## Additional attributes to process Mpay-Payment Options

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

**Deposit**

Refer to our API Reference Document [here](https://apcopay.redoc.ly/#tag/Hosted-Payment-Page) to create a Hosted Payment Page, use the below mandatory fields to process a deposit.

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | "Routing":{ "ForcePayment": "MPAYPM” } |
| **Client Information** | "Client": { "FirstName": "Mestan", "LastName": "Gökhan Güven", "ClientAccount": "APCOPAY TEST", } |
| **Payment Method Data** | "PaymentMethodData": { "ClientIdentificationNumber" : "25490183248" "PaymentMethod": "*Enter one of the methods below*”** }, |
| **Test Indicator** (required in Sandbox Environment only) | "isTest": true |

****Available methods:** “EFT”, “PAPARA”, “MEFETE” (Paratim), “QR”, "POPY”, “PAROLAPARA”.

A sample request can be found below

```json
{
  "TransactionType": "PURC",
  "Amount": "150.00",
  "Currency": "TRY",
  "OrderReference": "MPAYPM TEST",
  "UniqueReference": "3a9f50f7-2deb-4dbf-a186-d58641s36665",
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "FailRedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "Language": "en",
  "Routing": {
    "ForcePayment": "MPAYPM"
  },
  "Client": {
    "FirstName": "Mestan",
    "LastName": "Gökhan Güven",
    "ClientAccount": "APCOPAY TEST",
    "IPAddress": "20.101.159.120",
    "Email": "johndoe@mail.com",
    "City": "Valletta"
  },
  "PaymentMethodData": {
    "ClientIdentificationNumber": "20036565816",
    "PaymentMethod": "EFT"
  },
  "IsTest": true
}
```

**Withdrawals**

Withdrawals are processed via Direct Connect. The API reference to request a payout can be found [here](https://apcopay.redoc.ly/#operation/PaymentOperationAUTHPURC).

**EFT**

Below are the mandatory fields required to process a payout for EFT.

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | "Routing":{ "ForcePayment": "MPAYPM” } |
| **Client Information** | "Client": { "FirstName": "Mestan", "LastName": "Gökhan Güven", "ClientAccount": "APCOPAY TEST" } |
| **Payment Method Data** | "PaymentMethodData": { "PaymentMethod": "EFT” "BankIdentifierCode”:”VALLMTMT”, "Iban":"MTXXXXXXXXXXXXX" }, |
| **Test Indicator** (required in Sandbox Environment only) | "isTest": true |

A sample request can be found here:

```json
  {
  "TransactionType": "ORIGINALCREDIT",
  "Currency": "TRY",
  "Amount": "100.00",
  "OrderReference": "MPAYPAYOUT",
  "Routing": {
    "ForcePayment": "MPAYPM"
  },
  "PaymentDestination": {
    "PaymentMethodData": {
      "PaymentMethod": "EFT",
      "BankIdentifierCode": "1",
      "Iban": "TRXX XXXX XXXX XXXX XXXX XXXX XX"
    }
  },
  "Client": {
    "Email": "apcopay@test.com",
    "ClientAccount": "aoPayout",
    "FirstName": "ARMANÇ",
    "LastName": "ÖZTUNÇ",
    "City": "Istanbul",
    "IPAddress": "214.21.134.79"
  },
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "UniqueReference": "3a9f50f7-2deb-4dbf-a186-d58641s36665",
  "IsTest": true
}
```

**PAPARA**

Below are the mandatory fields required to process a payout for PAPARA.

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | “Routing”:{ "ForcePayment": "MPAYPM” } |
| **Client Information** | "Client": { "FirstName": "Mestan", "LastName": "Gökhan Güven", "ClientAccount": "APCOPAY TEST" } |
| **Payment Method Data** | "PaymentMethodData": { "PaymentMethod": "PAPARA”, "PaparaAccountNumber”:”1231232” }, |
| **Test Indicator** (required in Sandbox Environment only) | "isTest”: true |

```json
 {
  "TransactionType": "ORIGINALCREDIT",
  "Currency": "TRY",
  "Amount": "100.00",
  "OrderReference": "MPAYPAYOUT",
  "Routing": {
    "ForcePayment": "MPAYPM"
  },
  "PaymentDestination": {
    "PaymentMethodData": {
      "PaymentMethod": "PAPARA",
      "PaparaAccountNumber": "123456"
    }
  },
  "Client": {
    "Email": "apcopay@test.com",
    "ClientAccount": "aoPayout",
    "FirstName": "ARMANÇ",
    "LastName": "ÖZTUNÇ",
    "City": "Istanbul",
    "IPAddress": "214.21.134.79"
  },
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "UniqueReference": "3a9f50f7-2deb-4dbf-a186-d58641s36665",
  "IsTest": true
}
```

**Paratim (MEFETE)**

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | “Routing”:{ "ForcePayment": "MPAYPM” } |
| **Client Information** | "Client": { "FirstName": "Mestan", "LastName": "Gökhan Güven", "ClientAccount": "APCOPAY TEST" } |
| **Payment Method Data** | "PaymentMethodData": { "PaymentMethod": "MEFETE”, "MefeteAccountNumber”:”1232232”, “ClientIdentificationNumber”:”20036565816” }, |
| **Test Indicator** (required in Sandbox Environment only) | "isTest”: true |

```json
 {
  "TransactionType": "ORIGINALCREDIT",
  "Currency": "TRY",
  "Amount": "100.00",
  "OrderReference": "MPAYPAYOUT",
  "Routing": {
    "ForcePayment": "MPAYPM"
  },
  "PaymentDestination": {
    "PaymentMethodData": {
      "PaymentMethod": "MEFETE",
      "ClientIdentificationNumber": "30757664200",
      "MefeteAccountNumber": "6416432060"
    }
  },
  "Client": {
    "Email": "apcopay@test.com",
    "ClientAccount": "aoPayout",
    "FirstName": "ARMANÇ",
    "LastName": "ÖZTUNÇ",
    "City": "Istanbul",
    "IPAddress": "214.21.134.79"
  },
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "UniqueReference": "3a9f50f7-2deb-4dbf-a186-d58641s36665",
  "IsTest": true
}
```

**POPY**

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | “Routing”:{ "ForcePayment": "MPAYPM” } |
| **Client Information** | "Client": { "FirstName": "Mestan", "LastName": "Gökhan Güven", "ClientAccount": "APCOPAY TEST", "Email": "[test@apcopay.com](mailto:test@apcopay.com)", "City": "Marsa", "IPAddress": "1.1.1.1" } |
| **Payment Method Data** | "PaymentDestination": { "PaymentMethod": "AlternativePaymentMethods", "PaymentMethodData": { "PaymentMethod": "POPY", "PopyIban":"123456" } }, |
| **Test Indicator** (required in Sandbox Environment only) | "isTest”: true |

```json
 {
  "TransactionType": "ORIGINALCREDIT",
  "Currency": "TRY",
  "Amount": "100.00",
  "OrderReference": "MPAYPAYOUT",
  "Routing": {
    "ForcePayment": "MPAYPM"
  },
"PaymentDestination": {
"PaymentMethod": "AlternativePaymentMethods",    
  "PaymentMethodData": {
      "PaymentMethod": "POPY",
      "PopyIban":"123456"
    }
  },
  "Client": {
    "Email": "apcopay@test.com",
    "ClientAccount": "aoPayout",
    "FirstName": "ARMANÇ",
    "LastName": "ÖZTUNÇ",
    "City": "Istanbul",
    "IPAddress": "214.21.134.79"
  },
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "UniqueReference": "3a9f50f7-2deb-4dbf-a186-d58641s36665",
  "IsTest": true
}
```

**PAROLAPARA**

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | “Routing”:{ "ForcePayment": "MPAYPM” } |
| **Client Information** | "Client": { "FirstName": "Mestan", "LastName": "GÃÂÃÂÃÂÃÂ¶khan", "ClientAccount": "APCOPAY TEST", "IPAddress": "20.101.159.120", "Email": "[johndoe@mail.com](mailto:johndoe@mail.com)", "City": "Valletta" } |
| **Payment Method Data** | "PaymentMethodData": { "PaymentMethod": "PAROLAPARA", "ClientIdentificationNumber": "124555" } |
| **Test Indicator** (required in Sandbox Environment only) | "isTest”: true |

```json
 {
  "TransactionType": "ORIGINALCREDIT",
  "Currency": "TRY",
  "Amount": "100.00",
  "OrderReference": "MPAYPAYOUT",
  "Routing": {
    "ForcePayment": "MPAYPM"
  },
  "PaymentDestination": {
    "PaymentMethodData": {
      "ClientIdentificationNumber": "30757664200",
      "PaymentMethod": "PAROLAPARA",
      "ParolaparaAccountNumber":"123456"
    }
  },
  "Client": {
    "Email": "apcopay@test.com",
    "ClientAccount": "aoPayout",
    "FirstName": "ARMANÃÂ",
    "LastName": "ÃÂZTUNÃÂ",
    "City": "Istanbul",
    "IPAddress": "214.21.134.79"
  },
  "RedirectionURL": "https://www.yourURLhere.com/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/Listener",
  "IsTest": "True"
}
```

**Testing your integration**

Unfortunately, test payments cannot be processed in the Test environment. Testing will need to be conducted in the production environment. Please contact our [support](/v1/docs/contacting-apcopay) team for assistance with this process.
