Skip to main content

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.

info

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.

The steps depend on whether or not you use our widget.

  1. Send a token request to generate a public token. The token is used to initialize the widget for safely entering card details.

  2. 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.

  3. Start the payout in one of the following ways:

  4. 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.

  5. Confirm (session/confirm) or cancel (session/cancel) the payout.

    To enable automatic confirmation, contact you manager at Bank 131.

  6. Wait for a payment_finished webhook with the payout results. If the status is succeeded, the payout was successful.

Ask AI