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

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

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 - оплата по номеру телефона (СБП) - 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

$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{domain}}/v2/merchant/invoices', [
    'headers' => [
        'Authorization' => 'Bearer {{your_api_token}}',
        'X-Signature'   => '{{sign}}'
    ],
    'body' => "{\n  \"extId\": \"123456789\",\n  \"currency\": \"RUB\"\n,"paymentMethods":[\"Card\",\"SBP\",\"SberPay\",\"TPay\",\"CrossBorder\"]\n}"
]);

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

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

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

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