Запрос на получение курса валют

Далее представлена информация, необходимая для создания и отправки запроса на получение курса валют.

HTTP-метод запроса POST
Формат тела запроса JSON
Конечная точка /v2/customer/validate
Табл. 1. Параметры запроса на получение курса валют

strictly required — параметр обязательно должен присутствовать в начальном запросе.
Объект Параметр Описание

general
object
strictly required

project_id
integer
strictly required

 Идентификатор проекта, полученный от Flashpay при интеграции.

Пример: 1234

payment_id
string
strictly required

 Идентификатор платежа, уникальный в рамках проекта.

Пример: payment_47

signature
string
strictly required

 Подпись запроса, составленная после определения всех параметров запроса.

customer
object
strictly required

id
string
strictly required

 Идентификатор пользователя, уникальный в рамках проекта.

Пример: customer_123

card
object
strictly required

pan
string
strictly required

 Номер банковской карты пользователя.

Пример: 1234567890123456

payment
object
strictly required

amount
integer
strictly required

 Сумма выплаты в дробных единицах валюты без десятичного разделителя (точки или запятой) и пробелов за исключением случаев, когда у валюты нет дробной части.

Если у валюты нет дробных единиц (то есть количество разрядов дробных единиц равно нулю), то в этом параметре нужно указывать сумму в основных единицах валюты.

Пример: 100,00 RUB передается как 10000

currency
string
strictly required

 Код валюты выплаты в формате ISO-4217 alpha-3.

Пример: RUB

by_method
string
strictly required

 Идентификатор платежного метода. Передавайте значение card в этом параметре.

Пример: card

Вот пример тела запроса на получение курса валют:

Рис. 1. Пример тела запроса на получение курса валют
{
    "general": {
        "project_id": 1234,
        "payment_id": "payment_47",
        "signature": "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=="
    },
    "customer": {
        "id": "customer_123"
    },
    "card": {
        "pan": "1234567890123456"
    }
    "payment": {
        "amount": 10000,
        "currency": "RUB",
        "by_method": "card"
    }
}

Ответ с информацией о курсе валют

Получив ваш запрос, платежная платформа Flashpay отправит вам синхронный ответ с информацией о курсе валют.

Рис. 2. Пример тела ответа на запрос на получение курса валют
{
    "project_id": 1234,
    "status": "success",
    "request_id": "e0d123123ab4678ec2e"
    "payment_id": "payment_47",
    "code": "1",
    "operation": {
        "sum_initial": {
            "amount": 10000,
            "currency": "RUB"
        },
        "sum_converted": {
            "amount": 5900,
            "currency": "TRY"
        },
        "exchange_rate": 0.59,
        "exchange_rate_description": "Курс конвертации RUB/TRY 0.59"
    }
}