List of Supported Payment Options
Name | Deposit | Withdrawal |
|---|---|---|
EFT | ✅ | ✅ |
Papara | ✅ | ✅ |
Paratim | ✅ | ✅ |
PopyWallet | ✅ | ✅ |
Supported Transaction Types
Authorisation
Capture
Purchase
Withdrawal*
Void
as per the table above.
Integrations Supported
For the Deposit flow:
Hosted Payment Page
Direct Connect ( server-to-server)
For the Withdrawal flow:
Hosted Payment Page
Direct Connect ( server-to-server)
Currencies & Countries Supported
Title | Description |
|---|---|
Currencies Supported | TRY |
Countries Supported |
|
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 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”.
A sample request can be found below
{
"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.
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:
{
"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 |
{
"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 |
{
"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", "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 |
{
"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
}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 team for assistance with this process.