protopaysAPI

m2tjs

В ответе приходит checkoutUrl. Плательщик открывает ссылку, указывает телефон, код из SMS и карту. Номер телефона трейдера в ответе мерчанту не отдаётся.

После отправки карты статус остаётся pending, пока платёж не закроется отдельно.

Создание

POSTfunction b(){let a="https://api.protopays.io/";return"string"!=typeof a?"":a.trim().replace(/\/$/,"")}/v1/payments
json
{
  "orderId": "m2tjs-order-001",
  "amount": "1000",
  "currency": "RUB",
  "callbackUri": "https://example.com/hooks/protopays",
  "method": "m2tjs"
}

В create поля карты не принимаются. В ответе: status=pending, checkoutUrl, m2tjs.phase.

Фазы m2tjs.phase

  • awaiting_payer_phone — ждём телефон на странице оплаты
  • awaiting_payer_otp — ждём код из SMS
  • awaiting_payer_details — ждём карту
  • autopay_queued / autopay_running — идёт автоматическая оплата
  • autopay_submitted — данные отправлены, статус всё ещё pending
  • autopay_failed — автоматическая попытка не удалась, платёж pending до истечения
  • expired — время сессии вышло

Карта

  • Полный номер карты и CVV только на странице оплаты. В API мерчанта — последние 4 цифры.
  • CVV хранится коротко и затем удаляется.
  • Телефон трейдера в ответе create нет.