Skip to content

PayOut EFT (TRY) h2h

The request contains certain fields:

Field Description
merchant unique merchant ID;
method payout method, an integer number
59 – Payout EFT;
payout_id outgoing payment number in the merchant’s system;
account User's account number (Account number is the last 16 digit of IBAN);
customs_iban User's bank account's IBAN 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, customs_iban, 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:

Example of the request

application/json

{
    "merchant" : "9J1JAWS99MJPT",
    "method" : 59,
    "payout_id" : "000005",
    "account" : "5300111122223333",
    "customs_iban" : "TR330006100519786...",
    "full_name" : "JOHN SMITH",
    "amount" : "102.80",
    "currency" : "TRY",
    "sign" : "XXXXXXXXXXXXXXXXXX"
}

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:

Example of the response

application/json

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

Example of the response – Pending status

Example of the response

application/json

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

Example of the response – Error status:

Example of the response

application/json

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

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.