Создание платежа

Для создания заявок на оплату используется следующий запрос:

POST https://api.transavex.com/api/v1/payin/create

В теле запроса необходимо передавать следующие поля

Поле	Тип	Описание	Пример
paymentId	UUIDv4	Уникальный идентификатор заявки в вашей системе	11111111-1111-1111-1111-111111111111
client.id	UUIDv4	Уникальный идентификатор клиента в вашей системе	22222222-2222-2222-2222-222222222222
client.ip	string	IP адрес клиента	90.0.12.111
client.email	string	email адрес клиента	[email protected]
client.phone	string (опционально)	Номер телефона клиента	79999999999
client.firstName	string (опционально)	Имя клиента	John
client.lastName	string (опционально)	Фамилия клиента	Doe
amount	number	Сумма платежа	1000
country	string	Код страны платежа (ISO 3166-1 alpha-2)	RU
paymentMethod	string	Название платежного метода	SBP
trafficType	string	Тип трафика (ALL / FTD / STD)	ALL
postbackUrl	string	URL на который мы отправим вам POST вебхук	https://...
bankId	number (опционально)	Используется для внутренних методов (альфа-альфа, сбер-сбер, ...) (Существует метод api/v1/bank/available?country=<alpha-2> для получения списка)	12
addRandomCents	boolean (опционально)	Добавлять ли случайную дробную часть?	true

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

curl --request POST \
--url 'https://api.transavex.com/api/v1/payin/create' \
--header 'Content-Type: application/json' \
--header 'X-Client-Id: {{token}}' \
--header 'X-Signature: {{signature}}' \
-d '{
    "paymentId": "11111111-1111-1111-1111-111111111111",
    "client": {
        "id": "22222222-2222-2222-2222-222222222222",
        "ip": "90.0.12.111",
        "email": "[email protected]",
        "phone": "79999999999",
        "firstName": "John",
        "lastName": "Doe"
    },
    "amount": 8000,
    "country": "RU",
    "paymentMethod": "Card",
    "trafficType": "ALL"
}'

Пример ответа для платежного метода Card / CrossBorderCard

{
    "status": "In progress",
    "id": "9c7ffb7b-6d81-4321-ae6f-515f7140d484",
    "expiresAt": "2025-05-16T18:05:23Z",
    "bankDetails": {
        "card": {
            "cardNumber": "2202206137337635",
            "cardHolderName": "Иван Иванов"
        },
        "bankName": "Альфа-банк"
    }
}

Пример ответа для платежного метода SBP / CrossBorderSBP

{
    "status": "In progress",
    "id": "9c7ffb7b-6d81-4321-ae6f-515f7140d484",
    "expiresAt": "2025-05-16T18:05:23Z",
    "bankDetails": {
        "phoneNumber": "79149000186",
        "bankName": "Альфа-банк",
        "payeeName": "Иван Иванов"
    }
}

Пример ответа для платежного метода QRNSPK/QRNSPKCrossBorder

Модель объекта qr:

{
    // Используйте либо ссылку, если она есть
    url?: string;
    // Либо код для генерации QR
    code?: string;
    // В зависимости от того, что придет
}

{
    "status": "In progress",
    "id": "9c7ffb7b-6d81-4321-ae6f-515f7140d484",
    "expiresAt": "2025-05-16T18:05:23Z",
    "bankDetails": {
        "qr": {
            "url": "...url to qr code...",
            "code": "...code to generate a qr image..."
        },
        "bankName": "CITIBANK",
        "bankId": 1123
    }
}

Пример ответа для платежного метода PIX

Модель объекта qr:

{
    // Код для генерации QR
    code?: string;
}

{
    "status": "In progress",
    "id": "9c7ffb7b-6d81-4321-ae6f-515f7140d484",
    "expiresAt": "2025-05-16T18:05:23Z",
    "bankDetails": {
        "qr": {
            "code": "...code to generate a qr image..."
        },
        "bankName": "Banco do Brasil",
        "bankId": 1123
    }
}