Request
Body Params multipart/form-data
Payment ID in the merchant system. It is recommended to keep this field unique.
Merchant ID in {{project}} issued upon connection.
Payment amount in currency.
Description of the product or service. Displayed to the buyer during the payment process.
Invoicing method. Values are separated by commas. Possible values: qr.
The currency in which the amount is indicated. KZT
URL to check the possibility of payment. Called before the payment
URL for reporting the result of the payment. Called after payment on success or failure. Required if not set in the store settings.
Request samples
curl --location --request POST 'https://api.freedompay.kg/v5/merchant/invoice/init' \
--form 'order_id="00102"' \
--form 'merchant_id=""' \
--form 'amount="10"' \
--form 'description="Ticket"' \
--form 'invoice_method="qr"' \
--form 'currency="KZT"' \
--form 'check_url=""' \
--form 'result_url=""' \
--form 'request_method="POST"'
Responses
application/xml Shows the result of the query.ok: Request was successful.
process: Waiting for the payer or payment system.
ok: Invoice paid successfully.
failed: Invoice payment error.
incomplete: Invoice expired.
Text description of the error.
The unique identifier of the payment transaction in {{project}} serves as the key for all further work with the transaction.
The object contains the billing methods requested by the merchant.
URL to redirect the user in the form of a QR. Passed in base64 format. Date and time of the request. Format: YYYY-MM-DDThh:mm:ss±hh:mm.
<?xml version="1.0" encoding="UTF-8"?>
<root>
<status>string</status>
<invoice_status>string</invoice_status>
<error_code>0</error_code>
<error_description>string</error_description>
<invoice_id>0</invoice_id>
<invoice_methods>
<qr>string</qr>
</invoice_methods>
<dt>2019-08-24T14:15:22Z</dt>
</root>
Modified at 2025-02-03 10:08:06
