Платёжная форма

Метод запроса

POST

URL запроса

/v2/merchant/invoices

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

Название	Формат	Описание
extId	string	Идентификатор транзакции клиента
paymentMethods	string[]	Платежные методы доступные на форме ( Card, Sbp, SberPay, TPay, CrossBorder, QrNspk, Account, Acq )
currency	string(3-4)	Код валюты ISO 4217 (RUB, UZS и т.д.)
amount	decimal	Сумма
clientId (опционально)	string	Идентификатор клиента в системе мерчанта. Для работы антифрода.
callbackUrl (опционально)	string(1-255)	Адрес колбэка для транзакции
successUrl (опционально)	string(1-255)	Ссылка для редиректа после успешной оплаты ордера
failureUrl (опционально)	string(1-255)	Ссылка для редиректа в случае отмены ордера

• Card - оплата по номеру карты

• SBP - оплата по номеру телефона (СБП)

• InternalCard - внутрибанковский перевод по номеру карты (Сбер-Сбер, Альфа-Альфа и т.д.)

• InternalSbp - внутрибанковский перевод по номеру телефона (Сбер-Сбер, Альфа-Альфа и т.д.)

• Account - оплата по номеру счёта

• SberPay - оплата по номеру счёта, с дипликом в приложение Сбербанка, с заполненной суммой и реквизитами

• TPay - по номеру карты, с диплинком в приложение ТБанка, с заполненной суммой и реквизитами

• CrossBorder - оплата через трансграничный перевод по номеру телефона

• QrNspk - оплата по QR / ссылке, с редиректом в приложение банка

• Acq - оплата с помощью эквайринга (доступно не для всех ГЕО, уточняйте в службе поддержки)

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

CURL

curl --request POST \
  --url https://{{domain}}/v2/merchant/invoices \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'X-Signature: {{sign}}' \
  -d '{
  "extId": "123456789",  
  "callbackUrl": "https://webhook.site/#!/view/151a4e3c",
  "currency": "RUB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/failure", 
  "paymentMethods": [ "Sbp", "Card", "QrNspk", "Account", "SberPay", "TPay", "CrossBorder" ],
  "clientId": "54321"
}'

PHP + GuzzleHttp

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

Название	Формат	Описание
orderId	string(1-255)	Идентификатор ордера
paymentPageUrl	string(1-255)	Ссылка на платёжную форму

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

{
    "orderId": "624d4abd-b48e-4e5c-8d4a-4b16185a0326",
    "paymentPageUrl": "https://form.paywaygate.com/624d4abd-b48e-4e5c-8d4a-4b16185a0326"
}