Freedom Pay

Info

POST

https://api.freedompay.kg/v5/merchant/invoice/info

Request

Body Params multipart/form-data

customer

string

required

This parameter is displayed in the response to invoice/init - invoice_methods.qr.

Example:

kzobd2vgp17214143761774775392946

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kg/v5/merchant/invoice/info' \
--form 'customer="kzobd2vgp17214143761774775392946"'

Responses

🟢200Success

application/xml

Body

amount

number

required

Invoice amount in pg_currency.

Example: 10

order_id

string

required

Invoice identifier in the merchant system.

Example: 00102

status

string

required

Shows the result of the query.

Status Description:

ok: Request was successful.

error: Request failed.

invoice_status

string

required

Invoice status.

Status Description:

new: New invoice.

process: Waiting for the payer or payment system.

ok: Invoice paid successfully.

failed: Invoice payment error.

invoice_id

integer

required

The unique identifier of the payment transaction in {{project}} serves as the key for all further work with the transaction.

Displayed only on invoice_status - ok, failed.

card_pan

string

required

Masked card number (part of the digits of the card number are hidden).

Example: 5483-18XX-XXXX-0293

Displayed only on invoice_status - ok, failed.

error_code

integer

required

Error code ID.

error_description

string

required

Text description of the error.

description

string

required

Description of the product or service.

Example: Invoice.

currency

string

required

The currency in which the amount is indicated.

Example: KZT

Displayed only on invoice_status - ok, failed.

string <date-time>

required

Date and time of the request. Format: YYYY-MM-DDThh:mm:ss±hh:mm.

Example

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <amount>0</amount>
  <order_id>string</order_id>
  <status>string</status>
  <invoice_status>string</invoice_status>
  <invoice_id>0</invoice_id>
  <card_pan>string</card_pan>
  <error_code>0</error_code>
  <error_description>string</error_description>
  <description>string</description>
  <currency>string</currency>
  <dt>2019-08-24T14:15:22Z</dt>
</root>

Modified at 2025-02-03 10:08:06

Init

Pay