PAPARA (TRY)¶

Description: Secure deposit service for Papara transactions using Turkish Lira (TRY) currency only. Papara is a Turkish “Electronic Money Institution” and payment services company licensed in 2015. It is an Interbank Card Center, Mastercard, and Visa member and has acquired a community of over 22 million users.

Important

For the Papara method, the amount received in callbacks should be considered and accepted as final. The amount sent in the original request is not final, as the credited amount may be adjusted.

Initial request¶

The request contains certain fields:¶

Field	Description
`merchant`	unique merchant ID;
`order`	transaction number in the merchant system;
`amount`	transaction amount in the currency, separator character is a point “.”;
`currency`	transaction currency, may take TRY;
`first_name`	customer’s name. Maximum length is 30 characters (Only latin chars are available);
`last_name`	customer’s surname (Only latin chars are available);
`payment_url`	url address of the site in whose favor the payment is made;
`country`	customer’s country in the ISO 3166-1 alpha-2 format;
`ip`	customer's IP address;
`item_name`	goods name.

The fields process_url, success_url, fail_url (where the client will be redirected after the payment will be redirected to after the payment is made) do not have to be passed. These data are automatically taken from merchant settings in your personal cabinet.

Important

The query strings must contain only the Turkish alphabet, Latin letters, and numbers.

GET /payment/form

https://<provided url>
/payment/form

Example:

application/json

{
  "merchant": "M1VJDHSI6DYXS",
  "order": "0001",
  "amount": "16",
  "currency": "TRY",
  "first_name": "IVAN",
  "last_name": "IVANOV",
  "payment_url": "https://test.com",
  "country": "TR",
  "ip": "212.10.20.75",
  "item_name": "Samsung TV"
}

Redirect¶

HTTP Status Code: 302 Found

Description: If the request is valid and all required parameters are provided correctly, the server responds with an HTTP 302 Found status code, performing URL redirection. The redirection URL is dynamically generated and corresponds to the specific payment session created for the transaction.

Customer redirection after making a payment¶

Warning

Direction of the buyer to success_url or fail_url is only informational and CAN NOT confirm the success or rejection of payment!

After making a payment, the customer is redirected to success_url or fail_url.

Final Status (Callback)¶

The callback mechanism is used to notify the merchant that the transaction has received a final status (for example, from “Pending” to “Success”).

It is described in detail in the Callbacks section.