History of changes

Gazprombank has been added to the list of supported banks for pre-selection when paying by click.

Added signing documentationrequestscallback notificationsusing the HMAC-SHA512 algorithm.

In the sectionRequest Authentication and Signing (HMAC)addedHMAC signature verification and generation form (x-access-signature).

Updated examples of HMAC signature verification code on the merchant side in the sectionAlert signature (HMAC).

Added payment page methodpayin-ecom-mobilefor Kazakhstan (KZ, currencyKZT) in an H2C scenario via a payment widget (see.Kazakhstan — Mobile Commerce (Mobile ECOM)). Payments are not supported.

Status guides have been updated.

Updated parameter descriptionlifetime: lifetime of the request in seconds. The maximum lifetime is 10 minutes. If the time is not specified, the default value is set to 10 minutes. (integer) (300 <= X <= 600)

list of banks for pre-selectionaddedOzon Bank (ozonbank) for methodsbp-p2p.

Kazakhstan (KZ, currencyKZT):

In the sectionRequest Authentication and Signing (RSA)addedform for checking and generating an RSA signature (x-access-signature).

The documentation has been transferred to the new domain.

The documentation structure has been improved (seehome page).

Updated and updatedreference books.

Updated code examples in sectionIntegration examples.

Sections addedBefore you start, Basic ConceptsQuick start.

Addedglossary.

P2P documentation for Kazakhstan (KZ, currencyKZT):

New bankbankvtbfor pre-selection when paying by click.

New payment methodpayin-account-numberfor H2C integration. Available for currencyRUB.

New payment methodaccount-numberfor H2H integration. Available for currencyRUB.

H2C Integration Documentation for Nigeria (NGN). Available methods:payin-wallet-link, payin-account-number, payin-ussd.

H2C Integration Documentation for Kenya (KES). Available method:payin-mobile-money.

H2C Integration Documentation for South Africa (ZAR). Available method:payin-eft-link.

New payment methodpayin-qr-link-p2pfor H2C integration. Available for currencyRUB.

New payment methodqr-link-p2pfor H2H integration. Available for currencyRUB.

"ALFA-BANK" has been added to the list of supported banks for pre-selection when paying by click.

New payment methodpayin-qr-link-p2pfor H2C integration. Available for currencyKGS.

New payment methodqr-link-p2pfor H2H integration. Available for currencyKGS.

"ALFA-BANK" has been added to the list of supported banks for pre-selection when paying by click.

New payment methodpayin-qr-link-p2pfor H2C integration. Available for currencyKGS.

New payment methodqr-link-p2pfor H2H integration. Available for currencyKGS.

New payment methodpayin-p2p-card-internationalfor H2C integration. Available for currencyRUB.

New payment methodinternational-card-p2pfor H2H integration. Available for currencyRUB.

New geos Kenya (KES), Nigeria (NGN), South Africa (ZAR).

New payment methodsussd, wallet-linkfor H2H integration. Available for currencies:NGN.

New payment methodmobile-moneyfor H2H integration. Available for currencies:KES.

New payment methodeft-linkfor H2H integration. Available for currencies:ZAR.

Updated parameter descriptionlifetime: lifetime of the request in seconds. Maximum lifetime - 10 minutes. If no time is specified, the default value is 10 minutes. (integer) (300 <= X <= 600)

For geo Azerbaijan (currency AZN), a number of fields have become mandatory for payments. Required fields:customer:first_name, customer:last_name

New geo Tajikistan, Kyrgyzstan, Azerbaijan.

New payment and payout methodphone-p2pfor H2H integration. Available for currencies:KGS, AZN, TJS.

New payment methodpayin-p2p-phonefor H2C integration. Available for currencies:KGS, AZN, TJS.

New payment methodmobile-p2pfor H2H integration. Method available for currencyRUB

New optional parameterextra_paramfor H2H and H2C integrations.

New payment methodmobile-p2pfor H2H and H2C integrations. Method available for currencyRUB

For currencyRUBECOM payments available

New payment methodsbp-qrfor H2H and H2C integrations. Method available for currencyRUB

New geo "Korea" for payments and disbursements by account number (account-number) for H2H integration

New field addedpayment_info:initial_amountin the callback and in the body of the response to a request for information about the application. The field value displays the order amount specified when it was created.

For Argentina geo (ARS currency), a number of fields have become optional. Optional fields:identification_data:document_type, identification_data:document_number, receiver:account_type

Describes the authentication flow when receiving a callback with statusprocessing:awaiting_redirect_resultfor ECOM payments with H2H integration

Processing ECOM payments for currencyUZS

New payment methodcard-ecomfor H2H and H2C integrations. Method available for valtaKZT

Cosmetic improvements to documentation (logo, guest page rework, etc.)

Information about the country to which the bank belongs is added to the response of the API method that returns information about the application. And also in an informative callback with the found details

New geo "Argentina" for payments by account number (account-number) for H2H integration

Parametersenderin the body of the request to create an h2h payment request is no longer required

Integration instructions for each GEO are placed in a separate section

JavaScript code examples. Examples for creating applications, obtaining a list of banks, etc. Also an example of a web server for processing callbacks with digital signature verification

Possibility to pre-select the bank from which the client will pay for the application on our payment form. Pre-selection of a bank is most relevant for payment methods "Payment by click" and "Cross-border transfer"

New geo "Uzbekistan" for payments by card number (card-p2p) for both H2H and H2C integrations

A new field has been added to the response of the API method that returns a list of supported bankscountry_code, which contains the code of the country to which the bank belongs. More details in the section "Get a list of banks"

A new method for payment through the details of neighboring countries for H2H and H2C integrations. The names of the methods can be found in the sections "Payment methods" for H2H integration and "Widget methods" for H2C integration

Added a page with the history of its documentation changes

Sending details in callbacks during h2c integration. Details are displayed blurred "2202**4545"

Dark theme and light theme to choose from

Always open navigation menu

PHP code examples are available in the online documentation

Pre-selecting a payment method when creating an application for h2c integration

Documentation for h2c integration

Breakdown of documentation by sections

Bank information for applications for payment by methodsbp-p2p. In the body of the response by handleapi/v1/bank/alladditional field is returnedis_sbp_bank

Algorithm for converting request body to numbers. signatures

When creating a p2p order for payment, the link to PP is returned immediately.

Instructions for creating a payment page for p2p payment.

Receiving information about the blocked balance in the cash register balance handle.

Phone number validation. Now the phone number should be in the format+7XXXXXXXXXX.

When requesting information about a payment request, an object was addedpayment_info, which contains payment information.

The word "proct" has been changed to the word "cash" to reduce confusion.

The domain of our API has been changed to the real one.

Fixed example of creating a digital signature. The example provided an incorrect header name.

Maximum lifespan (lifetime) requests for payment reduced to 10 min.

The example of a request to create a payment request has been corrected. The example specified an incorrect field name.

fieldscustomer.first_namecustomer.last_namebecame optional when creating requests for payment and disbursement

Changed status descriptionsdispute:no_paymentdispute:payout_timeout

Adding a changelog file

Documentation version. It appears at the beginning of the documentation. Versioning will be based on semantic versioning.

Last name and username. The fields are required when creating requests for both payment and disbursement.

Fieldbank_code. This field is required to be filled out if a payment request is created using the "sbp-p2p" method. The documentation provides instructions for obtaining bank codes.

API handle for getting available banks for p2p payment. The merchant can use it to understand the details of which banks are currently available:/api/v1/payment/p2p/bank/available

API handle to get a list of all banks. The merchant can use it to receive bank symbols and to create payments/payouts. Not to be confused with "bank code"

Status codes (status_description). Added status codes that will be sent in case of errors, or in cases where the merchant needs to intervene.

Fieldbank_idamended tobank_symbol. The documentation contains instructions for obtaining an up-to-date list of banks and their symbols.

The names of application types have changed. Fieldpurchaseamended topayin. Fieldsaleamended topayout

The backbone of the documentation