PayOut Papara (TRY) h2h¶

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

The request contains certain fields:¶

Field	Description
`merchant`	unique merchant ID;
`method`	payout method, an integer number 50 – Payout Papara;
`payout_id`	outgoing payment number in the merchant’s system;
`account`	Papara account number;
`full_name`	first name, last name of the client. Maximum length 30 characters; (Only Turkish and Latin characters are available);
`amount`	transaction amount in the TRY currency only, separator character is a point “.”;
`currency`	transaction currency in TRY only;
`sign`	digital signature with the merchant’s key. Available fields are: “merchant”, “method”, “payout_id”, “account”, “full_name”, “amount”, and “currency”. It is hashed using the MD5 method (for more details, read the “Digital signature in requests” section).

POST /merchant/api/payout_send

https://<provided url>
/merchant/api/payout_send

Example:

application/json

{
    "merchant" : "9J1JAWS99MJPT",
    "method" : 150,
    "payout_id" : "000005",
    "account" : "5300111122223333",
    "full_name" : "JOHN SMITH",
    "pix_key" : "73859120463",
    "amount" : "102.80",
    "currency" : "TRY",
    "sign" : "XXXXXXXXXXXXXXXX"
}

The response contains certain fields:¶

Field	Description
`status`	transaction status: `Success` – the payment is completed successfully (final status) `Pending` – the payment is new or is in line for processing. The Pending status requires an additional request (for more details, read the section “Payment Status Request (Payout)”) `Blocked` – payment declined (final status) `Error` – received data error. The response contains a signature with an empty key (the status is not final and is the basis for finding out the reason for this status);
`code`	transaction status code;
`payout_id`	outgoing payment number in the merchant’s system;
`description`	status description;
`sign`	digital signature with the merchant’s key.

Example of the response – Success status:

application/json

{
    "status" : "Success",
    "code" : "0",
    "payout_id" : "000005",
    "description" : "Payment successful. Status final",
    "sign" : "XXXXXXXXXXXXXXXX"
}

Example of the response – Pending status

application/json

{
    "status" : "Pending",
    "code" : "40",
    "payout_id" : 000005,
    "description" : "Payment in order",
    "sign" : "XXXXXXXXXXXXXXXX"
}

Example of the response – Error status:

application/json

{
    "status" : "Error",
    "code" : "99",
    "payout_id" : "",
    "description" : "Sign error",
    "sign" : "XXXXXXXXXXXXXXXX"
}

Final Status (Callback)¶

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

For more information, read the Callbacks section.