You can send a payment as single request, with no interim steps (if you can do it without them). You will shortly get the payment result in response.
This option can work if:
- you have the PCI DSS certificate
- you don't use the payment form widget
Here, a payment with immediate capture is described. More about payments with later capture
How to enable
For such payments, there is a special method,
session/init/payment/sync. Inform the Bank 131 manager that you want to use it.
In this case, you will not receive webhooks from Bank 131. You can learn the transaction status with the request
How to perform a payment
Send the request
In the field
payment_method.type, specify the value
card. In the object
BankCard, specify user bank card details. In the field
payment_options.return_url, specify the address to which the user should be redirected after the payment is processed (it is required).
The payment result will be returned in response to the request in the field
succeeded— the payment has completed successfully
failed— the payment has not gone through because of an error
pending— the user needs to go through 3D Secure verification.
Payment request example
curl --location --request POST 'https://proxy.bank131.ru/api/v1/session/init/payment/sync' \
--header 'Content-Type: application/json' \
--header 'X-PARTNER-SIGN: sign' \
--header 'X-PARTNER-PROJECT: project' \
If a result is not returned
Sometimes, the final payment status is not returned in response to a request. For instance, if a payment is being processed for a very long time or the user card requires 3D Secure.
Too long payment
If payment processing lasts more than 40 seconds, the intermediate payment status,
in_progress, will be included in the response.
To learn the final payment status, send the request
3D Secure card
If a user card requires 3D Secure, redirection details will be returned in response to the request. Redirect the user to
After that, send the request
session/status to learn the final payment status.