Bank Cards

For correct payouts setup, go to “Personal Account” – “Edit merchant”.

You can find the detailed description of these settings in the “Sign Up” section (paragraphs 8-11).

Payout request

The request contains certain fields:

Field	Description
merchant	unique merchant ID;
method	payout method, integer number: 1 - Visa/Mastercard UAH 8 - Mastercard USD - this method requires a mandatory field to be passed: "exp_date": "mm/yy", "full_name": "CARD HOLDER" 9 - Mastercard EUR 11 - Visa/Mastercard AZN 12 - Visa/Mastercard KZT - this method requires a mandatory field to be passed: "full_name": "CARD HOLDER" 16 - Visa/Mastercard UAH (Alternative) 17 - Visa/Mastercard AZN - this method requires a mandatory field to be passed: "exp_date": "mm/yy" 22 - Visa EUR (Alternative) - this method requires a mandatory field to be passed: "full_name": "CARD HOLDER" 23 - MasterCard EUR (Alternative) - this method requires a mandatory field to be passed: "full_name": "CARD HOLDER" 24 - Mobile KZT - this method requires a phone to be passed in field "account" (without "+" sign). This method requires a mandatory field to be passed: "full_name": "CARD HOLDER" 70 - Visa/Mastercard TST (Sandbox) - The sandbox is available in TST currency. If the card 4111111111111111 is used, the payment will always success. If any other card is used, the payment will fail. This allows you to test both successful and failed payment scenarios. 93 - Visa / MasterCard EUR (Alternative) - this method requires a mandatory field to be passed: "full_name": "CARD HOLDER" "customs_birthday": "25-05-1995" "customs_phone": "+35988222763" "customs_email": "test@gmail.com" "customs_address": "Avenue Marius Renard 21" "customs_city": "Anderlecht" "customs_state": "stuttgart" "customs_post_code": "02217" "customs_user_id": "123456789" "customs_country": "FR";
payout_id	outgoing payment number in the merchant’s system;
account	bank card number (Visa or Mastercard);
amount	transaction amount in the currency, separator character is a point “.”;
currency	transaction currency, must match with the field “method”: «UAH» for method 1 «USD» for method 8 «EUR» for method 9 «AZN» for method 11 «KZT» for method 12 «UAH» for method 16 (Alternative) «AZN» for method 17 «EUR» for method 22 (Alternative) «EUR» for method 23 (Alternative) «KZT» for method 24 (Mobile payments);
sign	digital signature with the merchant’s key. Available fields are: “merchant”, “method”, “payout_id”, “account”, “amount”, “currency” are used. 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

Examples of the request:

application/json

{
    "merchant" : "M1VJDHSI6DYXS",
    "method" : 1,
    "payout_id" : "000002",
    "account" : "5300111122223333",
    "amount" : "102.81",
    "currency" : "UAH",
    "full_name" : "JOHN SMITH",
    "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 the line for processing. The Pending status requires an additional request (for more details read the section “Payment Status Request (Payout)”). Blocked – The payment is canceled (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 of 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" : 000002,
    "description" : "Payment successful. Status final",
    "sign" : "XXXXXXXXXXXXXXXXXX"
}

Example of the response – Pending status:

application/json

{
    "status" : "Pending",
    "code" : "40",
    "payout_id" : 000002,
    "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 is used to notify the merchant the transaction has received a final status (for example, from “Pending” to “Success”).

For more information read the Callbacks section.