Request Parameters

Parameter Type Description
card_number integer(19) Visa/MC card number mandatory
cvv2 integer(4) Card CVV2/CVC2 code
expiry_date integer(4) Card expiry date in format MMYY
client_ip integer(15) Client IP
comment string(1024) Merchant comment on reversal reason UTF-8
order_id string(1024) Order ID which is generated by merchant.
merchant_id integer(12) Merchant unique ID. Generated by FONDY during merchant registration.
order_desc string(1024) Order description. Generated by merchant in UTF-8.
signature string(40) Order signature. Required to verify merchant request consistency and authenticity. Signature generation algorithm please see at Signature generation for request and response
amount integer(12) Order amount in cents without separator
currency string(3) Order currency. Supported values (UAH, RUB, USD, EUR, GBP)
date_from string(10) Settlement date in fromat DD.MM.YYYY
date_to string(10) Settlement date in fromat DD.MM.YYYY
version string(10) Protocol version.
response_url string(2048) Merchant site URL, where customer will be redirected after payment completion.
server_callback_url string(2048) Merchant site URL, where host-to-host callback will be send after payment completion.
payment_systems string(1024) Payment systems which can be used for payment by customer at FONDY payment page. Systems must be separated by a comma or semicolon.
default_payment_system string(25) Payment system which will be shown to customer at FONDY payment page first.
lifetime integer(6) Order lifetime in seconds. After this time, the order will be given the status of 'expired' if the client has not paid it
merchant_data string(2048) Any arbitrary set of data that a merchant wants to get back in the response to response_url or/and server_callback_url, and also in reports
preauth string(1) Parameter supported only for Visa/MasterCard payment method N — amount is debited from the customer's card immediately and settled to the merchant account, in accordance with the rules of settlements. Y — amount holded on the customer card and not charged until the merchant sends a 'capture' request to confirm
sender_email string(254) Customer email
delayed string(1) Delayed order flag. Y — allows customer to pay the order during period sent by merchant in lifetime parameter. Merchant must expect several host-to-host callbacks and browser redirects at the same order. Customer will have possibility to try to pay the same order_id, if previous attempt failed N — after payment is declined order_id customer will be redirected to merchant site to recreate the order. In this case only one callback will be sent to server_callback_url
lang string(2) Payment page language. Supported values (ru,uk,en,lv,fr,cs)
product_id string(1024) Merchant product or service id
required_rectoken string(1) Flag which indicates whether FONDY must return card token — token to access card funds without cardholder interaction
verification string(1) If Y order will be automatically reversed by FONDY after successful approval
verification_type string(25) amount - amount submitted from merchant will be hold on card code - amount submitted from merchant will be hold on card. Also cardholder have to enter 4-characters code to pass verification
rectoken string(40) Card token — token to access card funds without cardholder interaction
receiver_rectoken string(40) Card token — token to credit card without transfering full card number
design_id integer(6) ID of design which is set in merchant portal
subscription string(1) Y - enable scheduled payments N - by default, disable scheduled payments
subscription_callback_url string(2048) Merchant site URL, where host-to-host callback will be send after scheduled payment completion