Трансгран (номер карты)

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

POST

URL запроса

/v2/merchant/transactions/cross-border-card

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

Название	Формат	Описание
extId	string	Идентификатор транзакции клиента
currency	string(3-4)	Код валюты ISO 4217 (RUB, UZS и т.д.)
amount	decimal(20, 2)	Сумма (Максимум 2 знака после точки)
maxAmountIncrement (опционально)	int	Дельта, на которую может быть увеличена сумма
callbackUrl (опционально)	string(1-255)	Адрес колбэка для транзакции

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

CURL

curl --request POST \
  --url https://{{domain}}/v2/merchant/transactions/cross-border-card \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'X-Signature: {{sign}}' \
  -d '{
  "extId": "123456789",
  "callbackUrl": "https://webhook.site/#!/view/151a4e3c",
  "currency": "RUB",
  "amount": 100,
  "maxAmountIncrement": 5
}'

PHP + GuzzleHttp

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

Название	Формат	Описание
id	int	Номер транзакции
cardNumber	string(1-255)	Номер карты для оплаты
owner	string(1-255)	Владелец карты
bankName	string(1-255)	Название банка
countryName	string(1-255)	Название страны
amount	decimal	Сумма транзакции
amountInUsdt	decimal	Сумма транзакции в USDT
commissionInUsdt	decimal	Коммисия в USDT
totalAmountInUsdt	decimal	Сумма транзакции c учётом коммиссии в USDT (amountInUsdt - commissionInUsdt)
currency	string(3,4)	Код валюты ISO 4217 (RUB, UZS и т.д.)
currencyRate	decimal	Курс валюты
expiresAt	string(1-255)	Срок действия транзакции (15 min)
extId	string(1-255)	Идентификатор транзакции в вашей системе
paymentMethod	string(1-255)	Метод проведения транзакции
tinkoffPayUrl	string(1-255)	Ссылка для оплаты. Только если клиент будет платить с ТБанка (Тинькофф банк)

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

{
  "id": 1556,
  "cardNumber": "4111111111111111",
  "owner": "asd",
  "bankName": "АПРА",
  "countryName": "Абхазия",
  "amount": 5000,
  "amountInUsdt": 53.9,
  "commissionInUsdt": 5.39,
  "totalAmountInUsdt": 48.51,
  "currency": "RUB",
  "currencyRate": 92.77,
  "expiresAt": "2024-08-30T01:15:13",
  "extId": "testExtId",
  "paymentMethod": "CrossBorder",
  "tinkoffPayUrl": "https://paylink.com/evwZrnIrF6RHdAcP8"
}