Перейти к основному содержимому

Сценарий без использования виджета токенизации карты

Этот сценарий описывает отправку денежного перевода, если вы приняли решение получать и хранить данные банковских карт на своей стороне (необходимо выполнять дополнительные требования стандарта PCI DSS).

Шаг 1. Предварительный расчет курса (опционально)​

Перед стартом перевода вы можете запросить курс конвертации валюты с помощью метода calculate.

Конвертация может проходить по прямому или обратному курсу. Возможность запроса прямого или обратного курса может зависеть от направления и валюты перевода.

В ответ на запрос будет отправлен актуальный курс валюты, итоговая сумма списания и выплаты. Указанный курс не резервируется, является справочным и может измениться. Резервирование курса происходит после старта мультисессии.

Примеры запросов
curl -X POST \
  https://demo.bank131.ru/api/v1/calculate   \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "amounts": {
      "source": {
        "amount": 357912,
        "currency": "RUB"
      },
      "destination": {
        "amount": null,
        "currency": "TRY"
      }
    }
  }'
Примеры ответов
{
  "amounts": {
    "source": {
      "amount": 357913,
      "currency": "RUB"
    },
    "destination": {
      "amount": 131426,
      "currency": "TRY"
    },
    "transfer_fee": {
      "amount": 0,
      "currency": "RUB"
    },
    "sms_fee": {
      "amount": 0,
      "currency": "RUB"
    },
    "payment": {
      "amount": 5400,
      "currency": "RUB"
    }
  },
  "exchanges": {
    "source": {
      "amount": 357912,
      "currency": "RUB"
    },
    "destination": {
      "amount": null,
      "currency": "TRY"
    },
    "rate": {
      "fx_rate": 2.7233,
      "quantity": 1
    }
  }
}

Шаг 2. Старт перевода​

Отправьте запрос на старт перевода с помощью метода session/multi/init. После старта мультисессии будут произведены проверки отправителя и возможности выплаты получателю, рассчитан и зарезервирован итоговый курс валюты с сумой списания и выплаты.

Курс операции резервируется не более чем на 5 минут. При попытке провести операцию по истечении этого времени, сессия завершится ошибкой rate_has_changed.

Примеры запросов
curl -X POST \
  https://demo.bank131.ru/api/v2/session/multi/init   \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "payment_list": [{
      "amount_details": { // Дублируется в payout_list, суммы и валюта должны совпасть
        "amount": 37700,
        "currency": "TJS"
      },
      "customer": {
        "reference": "lucky"
      },
      "participant_details": {
        "sender": {
          "citizenship_country_iso3": "TRY",
          "first_name": "Ольга",
          "last_name": "Зайцева",
          "middle_name": "Александровна",
          "country_iso3": "RUS",
          "state": "Московская область",
          "city": "Уренгой",
          "postal_code": "119900",
          "street": "Конаковская",
          "building": "99",
          "flat": "1",
          "date_of_birth": "1998-03-15",
          "identity_document": {
            "id_type": "Паспорт иностранного гражданина",
            "id_number": "8008 579120",
            "issue_date": "2020-03-01"
          },
          "contacts": {
            "phone": {
              "full_number": "+992910011020",
              "country_iso3": "TJK",
              "operator_code": "937",
              "short_number": "6151530"
            },
            "email": "sender@test.com"
          }
        }
      },
      "payment_options": {
        "return_url": "https://www.131.ru/"
      },
      "payment_details": {
          "type": "card",
          "card": {
            "type": "bank_card",
            "bank_card": {
              "number": "4111111111111111"
            }
          }
      }
    }],
    "payout_list": [{ // Дублируется в payment_list, суммы и валюта должны совпасть
      "amount_details": {
        "amount": 37700,
        "currency": "TJS"
      },
      "participant_details": {
        "recipient": {
          "first_name": "Sidor",
          "last_name": "Sidorov",
          "middle_name": "Sidorovich",
          "date_of_birth": "2000-11-08",
          "country_iso3": "TJK",
          "citizenship_country_iso3": "TJK",
          "contacts": {
            "phone": {
              "full_number": "+43523452345",
              "country_iso3": "TJK",
              "operator_code": "352",
              "short_number": "3452345"
            },
            "email": "recipient@test.tr"
          }
        }
      },
      "payout_details": {
        "type": "card",
        "card": {
          "type": "bank_card",
          "bank_card": {
            "number": "2204320396205389"
          }
        }
      }
    }]
  }'
Примеры ответов
{
  "status": "ok",
  "session": {
    "id": "ps_3808365",
    "status": "in_progress",
    "created_at": "2025-08-08T12:39:15.668563Z",
    "updated_at": "2025-08-08T12:39:16.388348Z",
    "payout_list": [{
      "id": "po_955259",
      "status": "in_progress",
      "created_at": "2025-08-08T12:39:16.439833Z",
      "payout_details": {
        "type": "card",
        "card": {
          "brand": "mir",
          "last4": "5389",
          "country_iso3": "RUS"
        }
      },
      "amount_details": {
        "amount": 37700,
        "currency": "TJS"
      },
      "amounts": {},
      "payment_metadata": {},
      "participant_details": {
        "recipient": {
          "full_name": "Sidor Sidorov Sidorovich",
          "first_name": "Sidor",
          "last_name": "Sidorov",
          "middle_name": "Sidorovich",
          "country_iso3": "TJK",
          "date_of_birth": "2000-11-08",
          "citizenship_country_iso3": "TJK",
          "contacts": {
            "phone": {
            "full_number": "+43523452345",
            "country_iso3": "TJK",
            "operator_code": "352",
            "short_number": "3452345"
            },
            "email": "recipient@test.tr"
          }
        }
      }
    }],
    "payment_list": [{
      "id": "pm_2765898",
      "status": "in_progress",
      "created_at": "2025-08-08T12:39:16.439730Z",
      "customer": {
        "reference": "lucky"
      },
      "payment_details": {
        "type": "card",
        "card": {
          "brand": "visa",
          "last4": "1111",
          "country_iso3": "POL"
        }
      },
      "amount_details": {
        "amount": 37700,
        "currency": "TJS"
      },
      "amounts": {},
      "participant_details": {
        "sender": {
          "full_name": "Ольга Зайцева Александровна",
          "first_name": "Ольга",
          "last_name": "Зайцева",
          "middle_name": "Александровна",
          "country_iso3": "RUS",
          "city": "Уренгой",
          "postal_code": "119900",
          "building": "99",
          "date_of_birth": "1998-03-15",
          "street": "Конаковская",
          "flat": "1",
          "state": "Московская область",
          "identity_document": {
            "id_type": "Паспорт иностранного гражданина",
            "id_number": "8008 579120",
            "issue_date": "2020-03-01"
          },
          "citizenship_country_iso3": "TRY",
          "contacts": {
            "phone": {
              "full_number": "+992910011020",
              "country_iso3": "TJK",
              "operator_code": "937",
              "short_number": "6151530"
            },
            "email": "sender@test.com"
          }
        }
      },
      "payment_options": {
        "return_url": "https://www.131.ru/",
        "recurrent": false
      }
    }]
  }
}

Дождитесь вебхука ready_to_confirm с информацией о готовности провести операцию по указанному курсу и итоговой суммой списания и выплаты.

В вебхуке в объекте confirm_information.exchanges будет передан актуальный курс валюты, итоговая сумма списания и выплаты.

Пример вебхука 
curl -X POST \
  https://partner.ru \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "status": "ok",
    "session": {
      "id": "ps_3808364",
      "status": "in_progress",
      "created_at": "2025-08-08T12:30:02.616632Z",
      "updated_at": "2025-08-08T12:30:04.489651Z",
      "payout_list": [{
        "id": "po_955258",
        "status": "pending",
        "created_at": "2025-08-08T12:30:03.401467Z",
        "payout_details": {
          "type": "card",
          "card": {
            "brand": "mir",
            "last4": "5389",
            "country_iso3": "RUS"
          }
        },
        "amount_details": {
          "amount": 37700,
          "currency": "TJS"
        },
        "participant_details": {
          "recipient": {
            "full_name": "Sidor Sidorov Sidorovich",
            "first_name": "Sidor",
            "last_name": "Sidorov",
            "middle_name": "Sidorovich",
            "country_iso3": "TJK",
            "date_of_birth": "2000-11-08",
            "citizenship_country_iso3": "TJK",
            "contacts": {
              "phone": {
                "full_number": "+43523452345",
                "country_iso3": "TJK",
                "operator_code": "352",
                "short_number": "3452345"
              },
              "email": "recipient@test.tr"
            }
          }
        }
      }],
      "payment_list": [{
        "id": "pm_2765897",
        "status": "pending",
        "created_at": "2025-08-08T12:30:03.401320Z",
        "customer": {
          "reference": "lucky"
        },
        "payment_details": {
          "type": "card",
          "card": {
            "brand": "visa",
            "last4": "1111",
            "country_iso3": "POL"
          }
        },
        "amount_details": {
          "amount": 37700,
          "currency": "TJS"
        },
        "participant_details": {
          "sender": {
            "full_name": "Ольга Зайцева Александровна",
            "first_name": "Ольга",
            "last_name": "Зайцева",
            "middle_name": "Александровна",
            "country_iso3": "RUS",
            "city": "Уренгой",
            "postal_code": "119900",
            "building": "99",
            "date_of_birth": "1998-03-15",
            "street": "Конаковская",
            "flat": "1",
            "state": "Московская область",
            "identity_document": {
              "id_type": "Паспорт иностранного гражданина",
              "id_number": "8008 579120",
              "issue_date": "2020-03-01"
            },
            "citizenship_country_iso3": "TRY",
            "contacts": {
              "phone": {
                "full_number": "+992910011020",
                "country_iso3": "TJK",
                "operator_code": "937",
                "short_number": "6151530"
              },
              "email": "sender@test.com"
            }
          }
        },
        "payment_options": {
          "return_url": "https://www.131.ru/",
          "recurrent": false
        }
      }],
      "next_action": "confirm"
    },
    "confirm_information": {
      "exchanges": [{
        "id": "pm_2765897",
        "source": {
          "amount": 37700,
          "currency": "TJS"
        },
        "destination": {
          "amount": 306237,
          "currency": "RUB"
        },
        "fx_rate": "8.123",
        "commission": {
          "amount": 306237,
          "currency": "RUB"
        }
      },
      {
        "id": "po_955258",
        "source": {
          "amount": 37700,
          "currency": "TJS"
        },
        "destination": {
          "amount": 306237,
          "currency": "RUB"
        },
        "fx_rate": "8.123",
        "commission": {
          "amount": 0,
          "currency": "RUB"
        }
      }]
    }
  }'

Шаг 3. Подтверждение перевода​

Проверьте данные перевода и подтвердите его методом session/confirm. На подтверждение сессии отводится не более 5 минут. Вы можете отменить перевод с методом session/cancel.

Пример запроса
curl -X POST \
  https://demo.bank131.ru/api/v2/session/confirm \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "session_id": "ps_3808364",
    "confirm_information": {
      "exchanges": [{
        "id": "pm_2765897",
        "source": {
          "amount": 37700,
          "currency": "TJS"
        },
        "destination": {
          "amount": 306237,
          "currency": "RUB"
        },
        "fx_rate": "8.123",
        "commission": {
          "amount": 0,
          "currency": "RUB"
        }
      },
      {
        "id": "po_955258",
        "source": {
          "amount": 37700,
          "currency": "TJS"
        },
        "destination": {
          "amount": 306237,
          "currency": "RUB"
        },
        "fx_rate": "8.123",
        "commission": {
          "amount": 0,
          "currency": "RUB"
        }
      }]
    }
  }'
Пример ответа
{
  "status": "ok",
  "session": {
    "id": "ps_3808364",
    "status": "in_progress",
    "created_at": "2025-08-08T12:30:02.616632Z",
    "updated_at": "2025-08-08T12:32:05.891206Z",
    "payments": [{
      "id": "po_955258",
      "status": "pending",
      "created_at": "2025-08-08T12:30:03.401467Z",
      "payment_method": {
        "type": "card",
        "card": {
          "brand": "mir",
          "last4": "5389",
          "country_iso3": "RUS"
        }
      },
      "amount_details": {
        "amount": 37700,
        "currency": "TJS"
      },
      "amounts": {},
      "payment_metadata": {},
      "participant_details": {
        "recipient": {
          "full_name": "Sidor Sidorov Sidorovich",
          "first_name": "Sidor",
          "last_name": "Sidorov",
          "middle_name": "Sidorovich",
          "country_iso3": "TJK",
          "date_of_birth": "2000-11-08",
          "citizenship_country_iso3": "TJK",
          "contacts": {
            "phone": {
              "full_number": "+43523452345",
              "country_iso3": "TJK",
              "operator_code": "352",
              "short_number": "3452345"
            },
            "email": "recipient@test.tr"
          }
        }
      }
    }],
    "acquiring_payments": [{
        "id": "pm_2765897",
        "status": "in_progress",
        "created_at": "2025-08-08T12:30:03.401320Z",
        "customer": {
          "reference": "lucky"
        },
        "payment_details": {
          "type": "card",
          "card": {
            "brand": "visa",
            "last4": "1111",
            "country_iso3": "POL"
          }
        },
        "amount_details": {
          "amount": 37700,
          "currency": "TJS"
        },
        "amounts": {},
        "participant_details": {
          "sender": {
            "full_name": "Ольга Зайцева Александровна",
            "first_name": "Ольга",
            "last_name": "Зайцева",
            "middle_name": "Александровна",
            "country_iso3": "RUS",
            "city": "Уренгой",
            "postal_code": "119900",
            "building": "99",
            "date_of_birth": "1998-03-15",
            "street": "Конаковская",
            "flat": "1",
            "state": "Московская область",
            "identity_document": {
              "id_type": "Паспорт иностранного гражданина",
              "id_number": "8008 579120",
              "issue_date": "2020-03-01"
            },
            "citizenship_country_iso3": "TRY",
            "contacts": {
              "phone": {
                "full_number": "+992910011020",
                "country_iso3": "TJK",
                "operator_code": "937",
                "short_number": "6151530"
              },
              "email": "sender@test.com"
            }
          }
        },
        "payment_options": {
          "return_url": "https://www.131.ru/",
          "recurrent": false
        }
    }],
    "actions": {
      "confirm": "2025-08-08T12:32:05.949621Z"
    }
  }
}

После подтверждения сессии у отправителя будут заморожены денежные средства для списания, необходимо подтвердить списание через 3D Secure:

  • Дождитесь вебхука action_required с ссылкой на прохождение 3D Secure и перенаправьте пользователя на прохождение 3D Secure.
  • После успешного прохождения 3D Secure произойдет заморозка денежных средств на карте отправителя.
Пример вебхука
curl -X POST \
  https://partner.ru \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "action_required",
    "session": {
      "id": "ps_3230",
      "status": "in_progress",
      "created_at": "2018-05-27T02:03:00.000000Z",
      "updated_at": "2018-05-27T02:03:00.000000Z",
      "payment_list": [{
        "id": "pm_131",
        "status": "pending",
        "created_at": "2018-05-27T02:03:00.000000Z",
        "customer": {
          "reference": "user@131.ru"
        },
        "payment_details": {
          "type": "card",
          "card": {
            "brand": "visa",
            "last4": "8801",
            "bin": "220220",
            "card_id": "05ee8cf7ee103444b384731d74b1b5c87fbb8f751fc3c452c9092fe1245bdc"
          }
        },
        "amount_details": {
          "amount": 15000,
          "currency": "rub"
        },
        "amounts": {
          "fee": {
            "merchant_fee": {
              "amount": 10,
              "currency": "RUB"
            }
          }
        },
        "customer_interaction": {
          "type": "redirect",
          "redirect": {
            "url": "https://bank131.ru?foo=bar",
            "base_url": "https://bank131.ru",
            "method": "POST",
            "qs": {
              "foo": "bar"
            },
            "params": {
              "PaReq": "sdfew^//asdhbv",
              "MD": "abc75daefnn"
            }
          }
        },
        "transaction_info": {
          "rrn": "425307614918",
          "auth_code": "057441"
        }
      }]
    }
  }'

Шаг 4. Отмена перевода (опционально)​

При необходимости вы можете отменить перевод с помощью метода session/cancel.

Пример запроса
curl -X POST \
  https://demo.bank131.ru/api/v2/session/cancel \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "session_id": "ps_3808365"
  }'
Пример ответа
{
  "status": "ok",
  "session": {
    "id": "ps_3809232",
    "status": "in_progress",
    "created_at": "2025-08-11T10:14:54.779728Z",
    "updated_at": "2025-08-11T10:14:58.370629Z",
    "payout_list": [{
      "id": "po_955280",
      "status": "pending",
      "created_at": "2025-08-11T10:14:55.586736Z",
      "payout_details": {
        "type": "card",
        "card": {
          "brand": "mir",
          "last4": "5389",
          "country_iso3": "RUS"
        }
      },
      "amount_details": {
        "amount": 37700,
        "currency": "TJS"
      },
      "participant_details": {
        "recipient": {
          "full_name": "Sidor Sidorov Sidorovich",
          "first_name": "Sidor",
          "last_name": "Sidorov",
          "middle_name": "Sidorovich",
          "citizenship_country_iso3": "TJK"
        }
      }
    }],
    "payment_list": [{
      "id": "pm_2766741",
      "status": "pending",
      "created_at": "2025-08-11T10:14:55.586645Z",
      "customer": {
        "reference": "lucky"
      },
      "payment_details": {
        "type": "card",
        "card": {
          "brand": "visa",
          "last4": "1111",
          "country_iso3": "POL"
        }
      },
      "amount_details": {
        "amount": 37700,
        "currency": "TJS"
      },
      "participant_details": {
        "sender": {
          "full_name": "Ольга Зайцева Александровна",
          "first_name": "Ольга",
          "last_name": "Зайцева",
          "middle_name": "Александровна",
          "country_iso3": "RUS",
          "city": "Уренгой",
          "postal_code": "119900",
          "building": "99",
          "date_of_birth": "1998-03-15",
          "street": "Конаковская",
          "flat": "1",
          "state": "Московская область",
          "identity_document": {
            "id_type": "Паспорт иностранного гражданина",
            "id_number": "8008 579120",
            "issue_date": "2020-03-01"
          },
          "citizenship_country_iso3": "TRY",
          "contacts": {
            "phone": {
              "full_number": "+992910011020"
            },
            "email": "sender@test.com"
          }
        }
      },
      "payment_options": {
        "return_url": "https://www.131.ru/",
        "recurrent": false
      }
    }]
  }
}

Дождитесь вебхука payment_finished cо значением status = cancelled. Сессия отменена, если требуется повторить перевод, создайте сессию заново.

Шаг 5. Выплата получателю​

Дождитесь вебхука payment_finished cо значением status = accepted. После выплаты с отправителя будет списана замороженная сумма.

Если в процессе выполнения перевода произойдет ошибка, в вебхуке payment_finished придет код ошибки. Посмотреть коды ошибок >

Пример вебхука
curl -X POST \
  https://partner.ru \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "payment_finished",
    "session": {
      "id": "ps_3230",
      "status": "accepted",
      "created_at": "2018-05-27T02:03:00.000000Z",
      "updated_at": "2018-05-27T02:03:00.000000Z",
      "payout_list": [{
        "id": "po_2018",
        "status": "succeeded",
        "created_at": "2018-05-27T02:03:00.000000Z",
        "customer": {
          "reference": "user123",
          "contacts": [{
            "email": "user@gmail.com"
          }]
        },
        "payout_details": {
          "type": "bank_account",
          "bank_account": {
            "system_type": "ru",
            "ru": {
              "bic": "*******02",
              "account": "****************5734",
              "full_name": "***",
              "description": "*****",
              "is_fast": false
            }
          }
        },
        "amount_details": {
          "amount": 10000,
          "currency": "rub"
        },
        "amounts": {
          "fee": {
            "merchant_fee": {
              "amount": 10,
              "currency": "RUB"
            }
          }
        },
        "fiscalization_details": {
          "professional_income_taxpayer": {
            "services": [{
              "name": "****",
              "amount_details": {
                "amount": "10000",
                "currency": "rub"
              },
              "quantity": 1
            }],
            "tax_reference": "*********628",
            "receipt": {
              "id": "**********",
              "link": "https://lknpd.nalog.ru/api/v1/receipt/*****/print"
            },
            "payer_type": "foreign",
            "payer_name": "******"
          }
        },
        "transaction_info": {
          "rrn": "425307614918",
          "auth_code": "057441"
        }
      }]
    }
  }'

Схема перевода​

Общая схема денежного перевода