Vepay - Банк 131. API для денежных переводов

Начало работы

Формат запросов

Каждый запрос должен быть подписан.

Как выпустить ключ и подписать запрос, можно посмотреть здесь.

Все данные в запросах к Банку 131 и уведомлениях от Банка передаются методами POST или GET по протоколу HTTP. Параметры сообщения упаковываются в JSON-объект.

Аутентификация

В заголовках запросов к Банку необходимо передавать данные для идентификации: идентификатор вашего проекта и подпись запроса.

Название	Обязательность	Тип данных	Описание
X-PARTNER-PROJECT	+	string	Идентификатор проекта. Если в запросе используется промокурс валюты, нужно указать идентификатор (id) проекта соответствующего промокурса
X-PARTNER-SIGN	+	string	Подпись запроса

Пример запроса с аутентификацией

curl -X POST \
https://demo.bank131.ru/api/v1/session/create \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
    // тело запроса
}'

Адреса серверов

Для тестирования: https://demo.bank131.ru

Для реальных операций: https://proxy.bank131.ru

Сессии и транзакции

Платежная сессия

В рамках платежной сессии session проходят все операции в API. Одна платежная сессия может объединять несколько операций, например, платеж и возврат.

Статусы платежной сессии (status)

created — сессия создана, ожидает старта или отмены;
in_progress — в обработке;
accepted — успешно завершена;
cancelled — отменена;
error — в процессе работы произошла непредвиденная ошибка.

Статус error не является финальным. Обратитесь в поддержку Банка 131 и дождитесь финального статуса транзакции.

Статусы выплаты (status)

in_progress — в обработке.
pending — ожидает вашего подтверждения (session/confirm) или отмены (session/cancel).
succeeded — выплата прошла успешно.
failed — выплата не прошла из-за ошибки.

Промокурсы

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

При проведении транзакции по промокурсу в аутентификации в X-PARTNER-PROJECT передается идентификатор (id) соответствующего промокурса.

Сценарий проведения платежа

Отправьте запрос, используя метод session/multi/init. В ответе вы получите информацию о платежной сессии, в рамках которой будут проходить все последующие операции.
Дождитесь от Банка 131 вебхука action_required. Банк отправляет вам этот вебхук в случае, когда для продолжения операции вам или вашим пользователям нужно совершить какие-то действия. Например, пользователю необходимо пройти аутентификацию по 3D Secure при платеже банковской картой.
Дождитесь от Банка 131 вебхука payment_finished с результатом проведения операции.

Методы

`session/multi/init`

Метод предназначен для старта перевода.

Адрес для отправки запроса

/api/v1/session/multi/init

Параметры запроса

Название	Обязательность	Тип	Описание
payment_options	-	object	Параметры рекуррентного платежа
payment_details_multi	+	array	Параметры платежа
payout_details_multi	-	array	Описание способа получения выплаты
amount_details	+	object	Детали суммы
amounts	+	object	Сумма и валюта оплаты/выплаты и курс
source	+	object	Данные об оплате (эквайринг)
amount	+	int	Сумма оплаты в минорных значениях (копейках). Для передачи 100 рублей укажите 1000
currency	+	string	Валюта оплаты в формате ISO 4217. Регистр не важен. Всегда: rub
amount	+	int	Сумма выплаты в минорных значениях (копейках). Для выплаты 100 рублей укажите 1000
currency	+	string	Валюта выплаты в формате ISO 4217. Регистр не важен
rate	+	object	Данные о курсах валют. Если передается промокурс, нужно указать его идентификатор в X-PARTNER-PROJECT
	+	decimal	Курс для этой операции. Формат: 4 знака после запятой. Курс рассчитывается как RUB/валюта получения
from_currency	+	string	Валюта оплаты в формате ISO 4217. Регистр не важен. Всегда: rub
to_currency	+	string	Валюта выплаты в формате ISO 4217. Регистр не важен
provider_rate	+	object	Данные о курсах валют на стороне провайдера (Банк СНГ)
rate	+	decimal	Курс для этой операции. Формат: 4 знака после запятой. Курс рассчитывается как RUB/валюта получения
from_currency	+	string	Валюта расчета с банком СНГ в формате ISO 4217. Регистр не важен. Всегда: rub
to_currency	+	string	Валюта выплаты в формате ISO 4217. Регистр не важен
participant_details	+	object	Информация об отправителе и получателе
payment_metadata	+	object	Флаг сценария конвертации на стороне банка СНГ
provider_tx_id	+	string	Идентификатор операции на стороне банка СНГ (будет передан Банком 131 в параметре `transfer-to-card.transfer`). Обязателен для сценария конвертации на стороне банка СНГ

Пример запроса

Пример

curl -X POST \
https://demo.bank131.ru/api/v1/session/multi/init \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
  "payment_options": {
    "recurrent": true,
    "return_url": "https://www.131.ru/"
  },
  "payment_details_multi": [
    {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "4242424242424242",
          "expiration_year": "22",
          "security_code": "123",
          "expiration_month": "01"
        }
      }
    }
  ],
  "payout_details_multi": [
    {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "5058270610441098"
        }
      }
    }
  ],
  "amounts": {
    "source": {
      "amount": 100000,
      "currency": "rub"
    },
    "rate": {
      "rate": "9.2222",
      "from_currency": "rub",
      "to_currency": "tjs"
    },
    "provider_rate": {
      "rate": "8.22",
      "from_currency": "rub",
      "to_currency": "tjs"
    }
  },
  "amount_details": {
    "amount": 10843,
    "currency": "tjs"
  },
  "participant_details": {
    "sender": {
      "citizenship_country_iso3": "RUS",
      "first_name": "Ольга",
      "last_name": "Пахмутова",
      "middle_name": "Семёновна",
      "country_iso3": "TUR",
      "state": "",
      "city": "Уренгой",
      "postal_code": "",
      "street": "Конаковская",
      "building": "1",
      "flat": "",
      "date_of_birth": "1998-03-15",
      "identity_document": {
        "id_type": "Паспорт гражданина Российской Федерации",
        "id_number": "8008 579120",
        "issue_date": "2020-03-01",
        "division_code": "",
        "issued_by": "ОВД ПО Кировскому району"
      },
      "source_of_money": "",
      "description": "",
      "contacts": {
        "phone": {
          "full_number": "+79376151530",
          "country_iso3": "RUS",
          "operator_code": "937",
          "short_number": "6151530"
        },
        "email": ""
      }
    },
    "recipient": {
      "first_name": "Maksim",
      "last_name": "Pahmutov",
      "middle_name": "Semenovich",
      "date_of_birth": "2000-11-08",
      "contacts": {
        "phone": {
          "full_number": "+43523452345"
        },
        "email": ""
      }
    }
  },
  "payment_metadata": {
    "provider_tx_id": "test1"
  },
  "customer": {
    "reference": "lucky"
  }
}'

Пример ответа

Пример

{
  "status": "ok",
  "session": {
    "id": "ps_5988",
    "status": "in_progress",
    "created_at": "2024-07-02T12:13:23.692217Z",
    "updated_at": "2024-07-02T12:13:24.871574Z",
    "payments": [
      {
        "id": "po_2040",
        "status": "in_progress",
        "created_at": "2024-07-02T12:13:24.894376Z",
        "customer": {
          "reference": "lucky"
        },
        "payment_method": {
          "type": "card",
          "card": {
            "brand": "mir",
            "last4": "1098",
            "country_iso3": "TJK"
          }
        },
        "amount_details": {
          "amount": 10843,
          "currency": "tjs"
        },
        "amounts": {
          "gross": {
            "amount": 10843,
            "currency": "tjs"
          }
        },
        "paymentMetadata": {},
        "participant_details": {
          "sender": {
            "full_name": "Ольга Пахмутова Семёновна",
            "first_name": "Ольга",
            "last_name": "Пахмутова",
            "middle_name": "Семёновна",
            "country_iso3": "TUR",
            "city": "Уренгой",
            "postal_code": "",
            "building": "1",
            "date_of_birth": "1998-03-15",
            "street": "Конаковская",
            "state": "",
            "identity_document": {
              "id_type": "Паспорт гражданина Российской Федерации",
              "id_number": "8008 579120",
              "issue_date": "2020-03-01",
              "division_code": "",
              "issued_by": "ОВД ПО Кировскому району"
            },
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "phone": {
                "full_number": "+79376151530",
                "country_iso3": "RUS",
                "operator_code": "937",
                "short_number": "6151530"
              },
              "email": ""
            }
          },
          "recipient": {
            "full_name": "Maksim Pahmutov Semenovich",
            "first_name": "Maksim",
            "last_name": "Pahmutov",
            "middle_name": "Semenovich",
            "date_of_birth": "2000-11-08",
            "contacts": {
              "phone": {
                "full_number": "+43523452345"
              },
              "email": ""
            }
          }
        }
      }
    ],
    "acquiring_payments": [
      {
        "id": "pm_3345",
        "status": "in_progress",
        "created_at": "2024-07-02T12:13:24.894294Z",
        "customer": {
          "reference": "lucky"
        },
        "payment_details": {
          "type": "card",
          "card": {
            "brand": "visa",
            "last4": "4242",
            "country_iso3": "GBR"
          }
        },
        "amount_details": {
          "amount": 10843,
          "currency": "tjs"
        },
        "amounts": {
          "gross": {
            "amount": 10843,
            "currency": "tjs"
          }
        },
        "participant_details": {
          "sender": {
            "full_name": "Ольга Пахмутова Семёновна",
            "first_name": "Ольга",
            "last_name": "Пахмутова",
            "middle_name": "Семёновна",
            "country_iso3": "TUR",
            "city": "Уренгой",
            "postal_code": "",
            "building": "1",
            "date_of_birth": "1998-03-15",
            "street": "Конаковская",
            "state": "",
            "identity_document": {
              "id_type": "Паспорт гражданина Российской Федерации",
              "id_number": "8008 579120",
              "issue_date": "2020-03-01",
              "division_code": "",
              "issued_by": "ОВД ПО Кировскому району"
            },
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "phone": {
                "full_number": "+79376151530",
                "country_iso3": "RUS",
                "operator_code": "937",
                "short_number": "6151530"
              },
              "email": ""
            }
          },
          "recipient": {
            "full_name": "Maksim Pahmutov Semenovich",
            "first_name": "Maksim",
            "last_name": "Pahmutov",
            "middle_name": "Semenovich",
            "date_of_birth": "2000-11-08",
            "contacts": {
              "phone": {
                "full_number": "+43523452345"
              },
              "email": ""
            }
          }
        }
      }
    ]
  }
}

`session/cancel`

Метод предназначен для отмены платежа. Подробнее смотрите здесь.

`session/status`

Метод предназначен для получения информации о сессии. Подробнее смотрите здесь.

Рекуррентные платежи

Токен для рекуррентных платежей

Вам нужно провести один успешный платеж с указанием сохранить данные банковской карты. В ответ на такой платеж вернется токен. Токен можно сохранить и проводить с ним следующие платежи.

Как получить токен при создании платежной сессии

Передайте в запросе recurrent=true (в объекте payment_options).

Это можно сделать при создании платежной сессии или в любом запросе на проведение платежа.

Если такой платеж пройдет успешно, вам вернется токен, по которому этот платеж можно повторить.

В этом случае вам нужно получить согласие пользователя на своей стороне — заранее.

Статусы токена

Когда вы создаете токен, он становится активным (is_active: true) — по нему можно проводить платежи.

Если токен неактивен (is_active: false), платеж не пройдет, вернется ошибка.

Как узнать статус токена

Отправьте запрос token/info. В поле type передайте значение recurrent_token, в поле recurrent_token.token — токен, статус которого нужно узнать.

В ответе будет получен info с датой, до которой действует токен (finished_at), и его статусом (is_active). Дата окончания действия токена finished_at никак не проверяется на стороне Банка — токен останется активным и после даты, указанной в этом параметре. Если is_active: true, значит, по этому токену можно проводить платежи.

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

Как отключить токен

Если вы больше не хотите использовать токен для платежей (например, пользователь отключил автоплатеж), отправьте запрос recurrent/disable.

В ответе будет получен recurrent. Если is_active: false, значит, токен отключен, по нему больше нельзя проводить платежи.

После отключения токена в параметре даты окончания действия токена finished_at может появиться дата, относящаяся к 2000 году — она ни на что не влияет, можно не обращать на неё внимание.

Пример запроса при работе с рекуррентами

Пользователь ввел данные карты и хочет их сохранить.

Пример

curl -X POST \
https://proxy-qa.bank131.ru/api/v1/session/multi/init \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-H 'Content-Type: application/json' \
-d '{
  "payment_details_multi": [
    {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "4762085995973998",
          "expiration_month": "12",
          "expiration_year": "24",
          "security_code": "111"
        }
      }
    }
  ],
  "payout_details_multi": [
    {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "5058270610441098"
        }
      },
      "country": "UZB"
    }
  ],
  "amounts": {
    "source": {
      "amount": 100000,
      "currency": "rub"
    },
    "rate": {
      "rate": "9.2222",
      "from_currency": "rub",
      "to_currency": "tjs"
    },
    "provider_rate": {
      "rate": "8.22",
      "from_currency": "rub",
      "to_currency": "tjs"
    }
  },
  "amount_details": {
    "amount": 10843,
    "currency": "tjs"
  },
  "participant_details": {
    "sender": {
      "citizenship_country_iso3": "RUS",
      "last_name": "Пахмутова",
      "first_name": "Ольга",
      "middle_name": "Семёновна",
      "address": {
        "country_iso3": "TUR",
        "state": "",
        "city": "Уренгой",
        "street": "Конаковская",
        "building": "1",
        "flat": "",
        "postal_code": ""
      },
      "date_of_birth": "1998-03-15",
      "identity_document": {
        "id_type": "Паспорт гражданина Российской Федерации",
        "id_number": "8008 579120",
        "issue_date": "2020-03-01",
        "id_expiration_date": "2030-03-01",
        "division_code": "",
        "issued_by": "ОВД ПО Кировскому району"
      },
      "source_of_money": "",
      "description": "",
      "contacts": {
        "phone": {
          "full_number": "+79376151530"
        },
        "email": ""
      }
    },
    "recipient": {
      "first_name": "Maksim",
      "last_name": "Pahmutov",
      "middle_name": "Semenovich",
      "citizenship_country_iso3": "RUS",
      "date_of_birth": "2000-11-08",
      "contacts": {
        "phone": {
          "full_number": "+43523452345"
        },
        "email": ""
      }
    }
  },
  "payment_metadata": {
    "provider_tx_id": "test1"
  },
  "customer": {
    "reference": "lucky"
  },
  "payment_options": {
    "return_url": "https://131.ru",
    "recurrent": true
  }
}'

Пример ответа

Пример

{
  "status": "ok",
  "session": {
    "id": "ps_6078",
    "status": "in_progress",
    "created_at": "2024-07-15T09:16:24.980262Z",
    "updated_at": "2024-07-15T09:16:25.603369Z",
    "payments": [
      {
        "id": "po_2079",
        "status": "in_progress",
        "created_at": "2024-07-15T09:16:25.620320Z",
        "customer": {
          "reference": "lucky"
        },
        "payment_method": {
          "type": "card",
          "card": {
            "brand": "mir",
            "last4": "1098",
            "country_iso3": "TJK"
          }
        },
        "amount_details": {
          "amount": 10843,
          "currency": "tjs"
        },
        "amounts": {
          "gross": {
            "amount": 10843,
            "currency": "tjs"
          }
        },
        "paymentMetadata": {},
        "participant_details": {
          "sender": {
            "full_name": "Ольга Пахмутова Семёновна",
            "first_name": "Ольга",
            "last_name": "Пахмутова",
            "middle_name": "Семёновна",
            "date_of_birth": "1998-03-15",
            "identity_document": {
              "id_type": "Паспорт гражданина Российской Федерации",
              "id_number": "8008 579120",
              "issue_date": "2020-03-01",
              "division_code": "",
              "issued_by": "ОВД ПО Кировскому району",
              "id_expiration_date": "2030-03-01"
            },
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "phone": {
                "full_number": "+79376151530"
              },
              "email": ""
            }
          },
          "recipient": {
            "full_name": "Maksim Pahmutov Semenovich",
            "first_name": "Maksim",
            "last_name": "Pahmutov",
            "middle_name": "Semenovich",
            "date_of_birth": "2000-11-08",
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "phone": {
                "full_number": "+43523452345"
              },
              "email": ""
            }
          }
        }
      }
    ],
    "acquiring_payments": [
      {
        "id": "pm_3427",
        "status": "in_progress",
        "created_at": "2024-07-15T09:16:25.620237Z",
        "customer": {
          "reference": "lucky"
        },
        "payment_details": {
          "type": "card",
          "card": {
            "brand": "visa",
            "last4": "3998",
            "country_iso3": "RUS"
          }
        },
        "amount_details": {
          "amount": 10843,
          "currency": "tjs"
        },
        "amounts": {
          "gross": {
            "amount": 10843,
            "currency": "tjs"
          }
        },
        "participant_details": {
          "sender": {
            "full_name": "Ольга Пахмутова Семёновна",
            "first_name": "Ольга",
            "last_name": "Пахмутова",
            "middle_name": "Семёновна",
            "date_of_birth": "1998-03-15",
            "identity_document": {
              "id_type": "Паспорт гражданина Российской Федерации",
              "id_number": "8008 579120",
              "issue_date": "2020-03-01",
              "division_code": "",
              "issued_by": "ОВД ПО Кировскому району",
              "id_expiration_date": "2030-03-01"
            },
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "phone": {
                "full_number": "+79376151530"
              },
              "email": ""
            }
          },
          "recipient": {
            "full_name": "Maksim Pahmutov Semenovich",
            "first_name": "Maksim",
            "last_name": "Pahmutov",
            "middle_name": "Semenovich",
            "date_of_birth": "2000-11-08",
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "phone": {
                "full_number": "+43523452345"
              },
              "email": ""
            }
          }
        },
        "payment_options": {
          "return_url": "https://131.ru",
          "recurrent": true
        }
      }
    ]
  }
}

Вебхук `payment_finished`

В вебхуке присутствует объект recurrent. В этом объекте параметр recurrent.token необходимо запомнить и использовать для последующих переводов.

Описание объекта можно найти здесь.

Пример вебхука `payment_finished`

Пример

{
  "session": {
    "acquiring_payments": [
      {
        "amount_details": {
          "amount": 10843,
          "currency": "TJS"
        },
        "amounts": {
          "gross": {
            "amount": 10843,
            "currency": "TJS"
          },
          "net": {
            "amount": 10843,
            "currency": "TJS"
          }
        },
        "created_at": "2024-07-15T09:16:25.620237Z",
        "customer": {
          "reference": "lucky"
        },
        "finished_at": "2024-07-15T09:22:53.998961Z",
        "id": "pm_3427",
        "participant_details": {
          "recipient": {
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "email": "",
              "phone": {
                "full_number": "+43523452345"
              }
            },
            "date_of_birth": "2000-11-08",
            "first_name": "Maksim",
            "full_name": "Maksim Pahmutov Semenovich",
            "last_name": "Pahmutov",
            "middle_name": "Semenovich"
          },
          "sender": {
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "email": "",
              "phone": {
                "full_number": "+79376151530"
              }
            },
            "date_of_birth": "1998-03-15",
            "first_name": "Ольга",
            "full_name": "Ольга Пахмутова Семёновна",
            "identity_document": {
              "division_code": "",
              "id_expiration_date": "2030-03-01",
              "id_number": "8008 579120",
              "id_type": "Паспорт гражданина Российской Федерации",
              "issue_date": "2020-03-01",
              "issued_by": "ОВД ПО Кировскому району"
            },
            "last_name": "Пахмутова",
            "middle_name": "Семёновна"
          }
        },
        "payment_details": {
          "card": {
            "brand": "visa",
            "country_iso3": "RUS",
            "last4": "3998"
          },
          "type": "card"
        },
        "payment_options": {
          "recurrent": true,
          "return_url": "https://131.ru"
        },
        "recurrent": {
          "created_at": "2024-07-15T12:22:53+03:00",
          "finished_at": "2025-01-01T00:00:00+03:00",
          "is_active": true,
          "token": "163a9bc0d0a7fd49581fad8dbfc7ed25166192dc65ebeca917b7fceefbfc1664",
          "type": "recurrent_token"
        },
        "status": "succeeded"
      }
    ],
    "actions": {
      "capture": "2024-07-15T09:22:51.910197Z",
      "confirm": "2024-07-15T09:16:26.309494Z"
    },
    "created_at": "2024-07-15T09:16:24.980262Z",
    "id": "ps_6078",
    "payments": [
      {
        "amount_details": {
          "amount": 10843,
          "currency": "TJS"
        },
        "amounts": {
          "gross": {
            "amount": 10843,
            "currency": "TJS"
          },
          "net": {
            "amount": 10843,
            "currency": "TJS"
          }
        },
        "created_at": "2024-07-15T09:16:25.620320Z",
        "customer": {
          "reference": "lucky"
        },
        "finished_at": "2024-07-15T09:22:52.187441Z",
        "id": "po_2079",
        "participant_details": {
          "recipient": {
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "email": "",
              "phone": {
                "full_number": "+43523452345"
              }
            },
            "date_of_birth": "2000-11-08",
            "first_name": "Maksim",
            "full_name": "Maksim Pahmutov Semenovich",
            "last_name": "Pahmutov",
            "middle_name": "Semenovich"
          },
          "sender": {
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "email": "",
              "phone": {
                "full_number": "+79376151530"
              }
            },
            "date_of_birth": "1998-03-15",
            "first_name": "Ольга",
            "full_name": "Ольга Пахмутова Семёновна",
            "identity_document": {
              "division_code": "",
              "id_expiration_date": "2030-03-01",
              "id_number": "8008 579120",
              "id_type": "Паспорт гражданина Российской Федерации",
              "issue_date": "2020-03-01",
              "issued_by": "ОВД ПО Кировскому району"
            },
            "last_name": "Пахмутова",
            "middle_name": "Семёновна"
          }
        },
        "payment_method": {
          "card": {
            "brand": "mir",
            "country_iso3": "TJK",
            "last4": "1098"
          },
          "type": "card"
        },
        "paymentMetadata": {},
        "status": "succeeded"
      }
    ],
    "status": "accepted",
    "updated_at": "2024-07-15T09:22:54.206106Z"
  },
  "type": "payment_finished"
}

Для последующих платежей можно вместо данных карты передавать token из объекта recurrent.

В этом случае в объекте payment_options передавать recurrent: true необходимости нет.

Дождитесь от Банка 131 вебхука action_required для прохождения пользователем аутентификации по 3D Secure. После прохождения аутентификации дождитесь вебхука payment_finished со всей информацией, включая срок жизни токена.

Пример вебхука `payment_finished` с параметрами рекуррентного платежа

Пример

{
  "session": {
    "acquiring_payments": [
      {
        "amount_details": {
          "amount": 10843,
          "currency": "TJS"
        },
        "amounts": {
          "gross": {
            "amount": 10843,
            "currency": "TJS"
          },
          "net": {
            "amount": 10843,
            "currency": "TJS"
          }
        },
        "created_at": "2024-07-15T09:35:00.112338Z",
        "customer": {
          "reference": "lucky"
        },
        "finished_at": "2024-07-15T09:36:43.910553Z",
        "id": "pm_3432",
        "participant_details": {
          "recipient": {
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "email": "",
              "phone": {
                "full_number": "+43523452345"
              }
            },
            "date_of_birth": "2000-11-08",
            "first_name": "Maksim",
            "full_name": "Maksim Pahmutov Semenovich",
            "last_name": "Pahmutov",
            "middle_name": "Semenovich"
          },
          "sender": {
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "email": "",
              "phone": {
                "full_number": "+79376151530"
              }
            },
            "date_of_birth": "1998-03-15",
            "first_name": "Ольга",
            "full_name": "Ольга Пахмутова Семёновна",
            "identity_document": {
              "division_code": "",
              "id_expiration_date": "2030-03-01",
              "id_number": "8008 579120",
              "id_type": "Паспорт гражданина Российской Федерации",
              "issue_date": "2020-03-01",
              "issued_by": "ОВД ПО Кировскому району"
            },
            "last_name": "Пахмутова",
            "middle_name": "Семёновна"
          }
        },
        "payment_details": {
          "card": {
            "brand": "visa",
            "country_iso3": "RUS",
            "last4": "3998"
          },
          "type": "card"
        },
        "payment_options": {
          "recurrent": false,
          "return_url": "https://131.ru"
        },
        "recurrent": {
          "created_at": "2024-07-15T12:22:53+03:00",
          "finished_at": "2025-01-01T00:00:00+03:00",
          "is_active": true,
          "token": "163a9bc0d0a7fd49581fad8dbfc7ed25166192dc65ebeca917b7fceefbfc1664",
          "type": "recurrent_token"
        },
        "status": "succeeded"
      }
    ],
    "actions": {
      "capture": "2024-07-15T09:36:42.539653Z",
      "confirm": "2024-07-15T09:35:00.829226Z"
    },
    "created_at": "2024-07-15T09:34:59.658885Z",
    "id": "ps_6086",
    "payments": [
      {
        "amount_details": {
          "amount": 10843,
          "currency": "TJS"
        },
        "amounts": {
          "gross": {
            "amount": 10843,
            "currency": "TJS"
          },
          "net": {
            "amount": 10843,
            "currency": "TJS"
          }
        },
        "created_at": "2024-07-15T09:35:00.112421Z",
        "customer": {
          "reference": "lucky"
        },
        "finished_at": "2024-07-15T09:36:42.814184Z",
        "id": "po_2083",
        "participant_details": {
          "recipient": {
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "email": "",
              "phone": {
                "full_number": "+43523452345"
              }
            },
            "date_of_birth": "2000-11-08",
            "first_name": "Maksim",
            "full_name": "Maksim Pahmutov Semenovich",
            "last_name": "Pahmutov",
            "middle_name": "Semenovich"
          },
          "sender": {
            "citizenship_country_iso3": "RUS",
            "contacts": {
              "email": "",
              "phone": {
                "full_number": "+79376151530"
              }
            },
            "date_of_birth": "1998-03-15",
            "first_name": "Ольга",
            "full_name": "Ольга Пахмутова Семёновна",
            "identity_document": {
              "division_code": "",
              "id_expiration_date": "2030-03-01",
              "id_number": "8008 579120",
              "id_type": "Паспорт гражданина Российской Федерации",
              "issue_date": "2020-03-01",
              "issued_by": "ОВД ПО Кировскому району"
            },
            "last_name": "Пахмутова",
            "middle_name": "Семёновна"
          }
        },
        "payment_method": {
          "card": {
            "brand": "mir",
            "country_iso3": "TJK",
            "last4": "1098"
          },
          "type": "card"
        },
        "paymentMetadata": {},
        "status": "succeeded"
      }
    ],
    "status": "accepted",
    "updated_at": "2024-07-15T09:36:44.121546Z"
  },
  "type": "payment_finished"
}

Начало работы​

Формат запросов​

Аутентификация​​

Пример запроса с аутентификацией​

Адреса серверов​​

Сессии и транзакции​

Платежная сессия​

Статусы платежной сессии (status)​

Статусы выплаты (status)​​

Промокурсы​

Сценарий проведения платежа​

Методы​

session/multi/init​

Адрес для отправки запроса​

Параметры запроса​

Пример запроса​

Пример ответа​

session/cancel​

session/status​

Рекуррентные платежи​

Токен для рекуррентных платежей​

Как получить токен при создании платежной сессии​

Статусы токена​

Как узнать статус токена​

Как отключить токен​

Пример запроса при работе с рекуррентами​

Пример ответа​

Вебхук payment_finished​

Пример вебхука payment_finished​

Пример вебхука payment_finished с параметрами рекуррентного платежа​

Схема взаимодействия по API​

Начало работы

Формат запросов

Аутентификация

Пример запроса с аутентификацией

Адреса серверов

Сессии и транзакции

Платежная сессия

Статусы платежной сессии (status)

Статусы выплаты (status)

Промокурсы

Сценарий проведения платежа

Методы

`session/multi/init`

Адрес для отправки запроса

Параметры запроса

Пример запроса

Пример ответа

`session/cancel`

`session/status`

Рекуррентные платежи

Токен для рекуррентных платежей

Как получить токен при создании платежной сессии

Статусы токена

Как узнать статус токена

Как отключить токен

Пример запроса при работе с рекуррентами

Пример ответа

Вебхук `payment_finished`

Пример вебхука `payment_finished`

Пример вебхука `payment_finished` с параметрами рекуррентного платежа

Схема взаимодействия по API