Standard payout and payment scenarios
The information below will help you understand how to generally perform payouts and payments via API. It includes the main steps, but depending on the selected transaction method or conditions you might need to complete additional actions.
Find the detailed scenarios for each particular case in the Payouts and Payments sections, respectively.
When working with bank cards, you have to comply with the PCI DSS standard, but the scope of the requirements depends on the way you perform a payout/payment. If you use our widget, you will have to comply with fewer requirements as Bank 131 will protect card data on its own.
If you fully comply with the PCI DSS standard, you may perform payouts directly by card number and/or using a token/our widget, and perform payments directly by card and/or using our widget.
You can decide whether you want to get webhooks. If they are disabled, you will have to send a session/status
request each time to understand the next step and transaction results.
- Payouts
- Payments
The steps depend on whether or not you use our widget.
- With our widget
- Without our widget
-
Send a token request to generate a public token. The token is used to initialize the widget for safely entering card details.
-
Initialize the widget using the received token. After the payer provides their card details, the widget will return you tokenized card details.
Save the tokenized card details for future payouts.
-
Start the payout in one of the following ways:
- send a
session/create
request and then asession/start/payout
request with the session identifier and payout details—the recommended option - start a session and the payout simultaneously (
session/init/payout
)
- send a
-
Wait for a
ready_to_confirm
webhook from the Bank, indicating that it is ready to perform the payout and is waiting for your confirmation. -
Confirm (
session/confirm
) or cancel (session/cancel
) the payout.To enable automatic confirmation, contact you manager at Bank 131.
-
Wait for a
payment_finished
webhook with the payout results. If the status issucceeded
, the payout was successful.
-
Start the payout in one of the following ways:
- send a
session/create
request and then asession/start/payout
request with the session identifier and payout details—the recommended option - start a session and the payout simultaneously (
session/init/payout
)
- send a
-
Wait for a
ready_to_confirm
webhook from the Bank, indicating that it is ready to perform the payout and is waiting for your confirmation. -
Confirm (
session/confirm
) or cancel (session/cancel
) the payout.To enable automatic confirmation, contact you manager at Bank 131.
-
Wait for a
payment_finished
webhook with the payout results. If the status issucceeded
, the payout was successful.
The steps depend on whether or not you use our widget.
- With our widget
- Without our widget
-
Create a payment session (
session/create
). In the response you will get the session identifier. -
Send a token request to generate a public token. The token is used to initialize the widget for safely entering card details.
-
Initialize the widget using the received token.
-
Wait for a
ready_to_confirm
webhook from the Bank, indicating that it is ready to perform the payment and is waiting for your confirmation. -
Confirm (
session/confirm
) or cancel (session/cancel
) the payment.To enable automatic confirmation, contact you manager at Bank 131.
-
Wait for a
ready_to_capture
webhook. It means the required amount is held on the bank card successfully. Capture the full amount or a part of it (session/capture
), or cancel the payment (session/cancel
).Skip this step if delayed capture payments are not enabled for you. In this case, the funds will be put on hold and captured automatically.
-
Wait for a
payment_finished
webhook with the payment results. If the status issucceeded
, the payment was successful.
-
Start the payment in one of the following ways:
- send a
session/create
request and then asession/start/payment
request with the session identifier and payment details—the recommended option - start a session and the payment simultaneously (
session/init/payment
)
- send a
-
Wait for a
ready_to_confirm
webhook from the Bank, indicating that it is ready to perform the payment and is waiting for your confirmation. -
Confirm (
session/confirm
) or cancel (session/cancel
) the payment.To enable automatic confirmation, contact you manager at Bank 131.
-
If you get an
action_required
webhook from Bank 131, this means that you will need to take an additional action to perform the payment. For instance, the payer might need to go through 3D Secure. Send the HTTP 200 OK code in response and redirect the payer to the address for 3D Secure. -
Wait for a
ready_to_capture
webhook. It means the required amount is held on the bank card successfully. Capture the full amount or a part of it (session/capture
), or cancel the payment (session/cancel
).Skip this step if delayed capture payments are not enabled for you. In this case, the funds will be put on hold and captured automatically.
-
Wait for a
payment_finished
webhook with the payment results. If the status issucceeded
, the payment was successful.