Mpay Payment Options

Prev Next

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

  •  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”, “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.