Contents x
    Mpay Payment Options
    • 19 Feb 2025
    • 4 Minutes to read
    • Print
    • Dark
      Light
    Contents

    Mpay Payment Options

    • Updated on 19 Feb 2025
    • 4 Minutes to read
    • Print
    • Dark
      Light
    Article summary

    List of Supported Payment Options

    Name

    Deposit

    Withdrawal

    EFT

    ✅

    ✅

    Papara

    ✅

    ✅

    Payfix

    ✅

    ✅

    Mefete

    ✅

    ✅

    Parazula

    ✅

    ✅

    PopyWallet

    ✅

    ✅

    Payco

    ✅

    ✅

    Supported Transaction Types

    • Authorisation

    • Capture

    • Purchase

    • Withdrawal*

    • Void

    • as per 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

    •  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 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”, “PAYFIX”, “MEFETE”, “PARAZULA”, “QR”, “PAYCO”, "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
}

    PAYFIX

    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": "PAYFIX”,

    "WalletId”:”1232232”,

    “WalletHoldersName”:”Joe Bloggs”

    },

    Test Indicator (required in Sandbox Environment only)

    "isTest”: true 

     {
  "TransactionType": "ORIGINALCREDIT",
  "Currency": "TRY",
  "Amount": "100.00",
  "OrderReference": "MPAYPAYOUT",
  "Routing": {
    "ForcePayment": "MPAYPM"
  },
  "PaymentDestination": {
    "PaymentMethodData": {
      "PaymentMethod": "PAYFIX",
      "WalletId":"82145814585",
      "WalletHoldersName":"Armanc Oztunc"
    }
  },
  "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
}

    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
}

    PARAZULA

    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": "PARAZULA”,

    "ParazulaAccountNumber”:”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": {
"PaymentMethod": "AlternativePaymentMethods",    
"PaymentMethodData": {
      "ClientIdentificationNumber": "30757664200",
      "PaymentMethod": "PARAZULA",
      "ParazulaAccountNumber":"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
}

    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
}

    PAYCO

    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

    "PaymentMethodData": {

    "PaymentMethod": "PAYCO”,

    "PaycoAccountNumber”:”1231231231”

    },

    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": "PAYCO",
  "PaycoAccountNumber":"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.

    Was this article helpful?
    What's Next