Skip to main content

Payouts in a foreign currency

To enable payouts in a foreign currency, sign an agreement with Bank 131.

warning

If you enabled automatic confirmation earlier, disable it to see the amount in rubles to be debited that is returned in a ready_to_confirm webhook. To do this, contact your account manager at Bank 131.

When sending a request, specify the amount in the required currency.

Request example
curl -X POST \
  https://demo.bank131.ru/api/v1/session/start/payout \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "session_id": "ps_3230",
    "payment_method": {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "2200********4940"
        }
      }
    },
    "participant_details": {
      "recipient": {
        "full_name": "Ivanov Ivan Ivanovich"
      }
    },
    "amount_details": {
      "amount": 10000,
      "currency": "usd"
    },
    "metadata": "good"
  }'

Bank 131 will convert the amount at the exchange rate specified in your agreement and debit the ruble equivalent from your account. The recipient will receive the payment in Russian rubles.

Webhook example
curl -X POST \
  https://partner.ru \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "ready_to_confirm",
    "session": {
      "id": "ps_3230",
      "status": "in_progress",
      "created_at": "2025-05-27T02:03:00.000000Z",
      "updated_at": "2025-05-27T02:03:00.000000Z",
      "next_action": "confirm",
      "payments": [{
        "id": "po_2025",
        "status": "pending",
        "created_at": "2025-05-27T02:03:00.000000Z",
        "payment_method": {
          "type": "card",
          "card": {
            "last4": "4940",
            "brand": "mir",
            "bin": "220024",
            "country_iso3": "RUS"
          }
        },
        "participant_details": {
          "recipient": {
            "full_name": "Ivanov Ivan Ivanovich"
          }
        },
        "amount_details": {
          "amount": 800000,
          "currency": "rub"
        },
        "metadata": "good"
      }]
    }
  }'

You can make a payout in a foreign currency in one of the following ways:





Ask AI