platega | API
  • API DOCS
    • Аутентификация запроса
    • Callback
    • Создание ссылки на оплату
    • Проверка статуса оплаты платежа
Powered by GitBook
On this page
  1. API DOCS

Создание ссылки на оплату

Создание ссылки на оплату

POST /app.platega.io/transaction/process

Данный эндпоинт шлет запрос нашему API на создание транзакции.

Ниже вы сможете ознакомиться:

  • с заголовками, которые нужно передать для осуществления запроса

  • со списком доступных методов оплат для транзакции

  • с примерами запроса и ответами от него

  • реализацией на различных языках программирования

Заголовки запроса

Name
Value

Content-Type

application/json

X-MerchantId

<MerchantId>

X-Secret

<Api Key>

Список доступных методов оплат

Название метода оплаты
Значение (передается в запрос)

СБП (P2P)

1 - поиск только реквизитов банков РФ

СБП / QR

2 - НСПК / QR

ALL (P2P CARD / P2P СБП / P2P Трасгран)

3 - "супер метод", поиск по всем P2P методам

KZT (P2P) 🇰🇿

5 - реквизиты банков Казахстана

UZS (P2P) 🇺🇿

6 - реквизиты банков Узбекистана

Трансгран SBP (рекомендуется)

7 - реквизиты СБП банков Абхазии / Узбекистана

Трансгран любая CARD P2P (рекомендуется)

8 - реквизиты карт банков Абахазии / Узбекистана

ALL_RU (P2P CARD / P2P СБП)

9- реквизиты сбп / карт РФ банков

CardRu

10 - реквизиты только банковских карт РФ

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

{
  "paymentMethod": 2, // метод оплаты
  "id": "3fa85f64-5717-4562-b3fc-2c963f66aza6", // айди транзакции (в формате UUID)
  "paymentDetails": {
    "amount": 970, // сумма платежа 
    "currency": "RUB" // валюта
  },
  "description": "test", // назначение платежа
  "return": "https://google.com" // редирект url при успешном платеже
  "failedUrl": "https://yourdomain/fail" // редирект при не успешном платеже
  "payload": { // дополнительное поле для инциализации информации в вашей системе
    "order_id": 11122 
  }
}

Принцип формирования тела запроса для QR / СБП и P2P метода не отличаются друг от друга. Единственное различие в передаче поля paymentMethod нужной цифры, которая указывает на нужный метод оплаты. В случае с QR / СБП мы всегда передаем цифру 2. Все остальные методы, включая метод 1, 2 - 9, связанны с P2P методами

Ответы

{
  "paymentMethod": "SBPQR",
  "transactionId": "3fa85f64-5717-4562-b3fc-2c463f66afa6",
  "redirect": "https://pay.platega.io?qrsbp",
  "return": "https://google.com",
  "paymentDetails": "100 RUB",
  "status": "PENDING",
  "expiresIn": "00:15:00",
  "merchantId": "1a021d91-9b26-4762-b303-5d4aac74e921",
  "usdtRate": 93.45 // курс по которому происходит конвертация в USDT в момент оплаты
}
{
  "paymentMethod": null,
  "transactionId": "3fa85f64-5717-4562-b4fc-2c163f66afa6",
  "redirect": "https://pay.platega.io?id=3fa85f64-5717-4562-b4fc-2c163f66afa6&mh=1a021d91-9b26-4762-b303-5d4aac74e927",
  "return": "https://google.com",
  "paymentDetails": "2000 RUB",
  "status": "PENDING",
  "expiresIn": "00:15:00",
  "merchantId": "1a021d91-9b26-4762-b303-5d4aac74e927",
  "usdtRate": 93.45
}


{
  "statusCode": 400,
  "message": "No available requisites"

} // Данный статус код и сообщение говорят нам о том, что система не смогла найти реквизитов на подходяшую сумму. Для исправления ситуации попробуйте еще раз запросить реквизиты на другую сумму.Советуем запрашивать реквизиты на суммы 1001, 2002, 3001
{
  "statusCode": 400,
  "message": "Transaction 3fa85f64-5717-4562-b3fc-2c963f66afa6 already exists."
} // данный статус код и сообщение говорят нам о том, что транзакция с таким айди уже сушествует в системе. Для исправления ситуации измените айди транзакции и сформируйте запрос по новой

PreviousCallbackNextПроверка статуса оплаты платежа

Last updated 2 days ago