Automatic documentation for interacting with the API:

Notification of transfer

A notification is sent if:

• The URL for notifications in your personal account was specified;
• An incoming transfer was received from a user;

Request format

The notification is sent as an HTTP request to the address specified in the user's personal account, in the following format:

• Method - POST; Each notification parameter is specified as a key/value pair as a POST request parameter;
• Character encoding is UTF‑8.
• MIME-type — "application/json".

Notification Options

Example of the response received:

{

                "status": true,

                "order_id": "9ad36faf-7087-4c3c-8acf-aed478df9463",

                "invoice_id": "j4h878hd9h5h",

                "buyer_email": "quickpay@test.test",

                "amount": "100",

                "currency": "USD",

                "user_tag": "test",

                "sha1_hash": "4457df6dcfbff359f0b8cb2bb7e7dc75c717a334",

              }

            

Response format

• A notification is considered accepted if the recipient responded to the request with HTTP 200 OK code (notification is sent every 5 seconds for 10 minutes).

Calculating a hash

• Step 1.

  Generate a string from notification parameters in UTF‑8 encoding (where notification_secret is a secret word for checking notifications). If the parameter is missing or None, it must be excluded.

• Term format

                    order_id&invoice_id&buyer_email&amount&user_tag&currency&secret_key
                  

  An example in which the account secret key is "secret key"

                      9ad36faf-7087-4c3c-8acf-aed478df9463&j4h878hd9h5h&quickpay@test.test&100&test&USD&secret key

• Step 2.

  Calculate the SHA-1 hash value from the received string.

• Step 3.

  Format the resulting output in HEX-encoded form.

• Result

  As a result, after 3 steps, the parameter "sha1_hash" is obtained

                    53ed2efa057066f747efc51252e1f29cf2d156cc