Перейти к основному содержимому

Создание выплаты

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

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

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

ПолеТипОписаниеПример
paymentIdUUIDv4ID заявки в вашей системе11111111-1111-1111-1111-111111111111
client.idUUIDv4ID клиента в вашей системе22222222-2222-2222-2222-222222222222
client.ipstringIP адрес клиента90.0.12.111
client.emailstringemail адрес клиента[email protected]
client.tinstring (обязательно для PIX_OUT_* методов)ИННbrazil TIN number
amountnumberСумма платежа1000
countrystringКод страны платежа (ISO 3166-1 alpha-2)RU
paymentMethodstringНазвание платежного методаCard
trafficTypestringТип трафика (ALL / FTD / STD)ALL
bankIdnumber (optional)Используется для метода СБП31
payoutDetails.ccNostring (optional)Номер карты4627342642639018
payoutDetails.ccHolderNamestring (optional)Имя владельца с картыJohn Doe
payoutDetails.ccExpirationMonthstring (optional)Месяц истечения срока карты09
payoutDetails.ccExpirationYearstring (optional)Год истечения срока карты26
payoutDetails.phoneNumberstring (optional)Номер телефона для СБП79999999999
payoutDetails.payeeNamestring (optional)Имя получателя для метода СБПИванов Иван
payoutDetails.bankAccountNostring (optional)Номер банковского счета457575757457457
postbackUrlstringURL на который мы отправил вам POST вебхукhttps://...

Поля объекта payoutDetails формируются в зависимости от выбранного клиентом платежного метода:

  • Card - ccNo, ccHolderName, ccExpirationMonth и ccExpirationYear - обязательны.
  • SBP - phoneNumber - обязателен.
  • BankAccount - bankAccountNo - обязателен.

Пример запроса (метод Card)

curl --request POST \
--url 'https://api.transavex.com/api/v1/payout/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]"
},
"amount": 8000,
"country": "RU",
"paymentMethod": "Card",
"trafficType": "ALL",
"payoutDetails": {
"ccNo": "4627342642639018",
"ccHolderName": "John Doe",
"ccExpirationMonth": "09",
"ccExpirationYear": "26"
}
}'

Пример запроса (метод SBP)

curl --request POST \
--url 'https://api.transavex.com/api/v1/payout/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]"
},
"amount": 8000,
"country": "RU",
"paymentMethod": "SBP",
"trafficType": "ALL",
"bankId": 31,
"payoutDetails": {
"phoneNumber": "9999999999",
"payeeName": "Иванов Иван"
}
}'

Пример запроса (метод PIX_OUT_CPF)

curl --request POST \
--url 'https://api.transavex.com/api/v1/payout/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": "553030000721",
"tin": "some TIN number"
},
"amount": 100,
"country": "BR",
"paymentMethod": "PIX_OUT_CPF",
"trafficType": "ALL"
}'

Пример запроса (метод PIX_OUT_EMAIL)

curl --request POST \
--url 'https://api.transavex.com/api/v1/payout/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": "553030000721"
},
"amount": 100,
"country": "BR",
"paymentMethod": "PIX_OUT_EMAIL",
"trafficType": "ALL"
}'

Пример запроса (метод PIX_OUT_PHONE)

curl --request POST \
--url 'https://api.transavex.com/api/v1/payout/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": "553030000721"
},
"amount": 100,
"country": "BR",
"paymentMethod": "PIX_OUT_PHONE",
"trafficType": "ALL"
}'

Пример запроса (метод PIX_OUT_EVP)

curl --request POST \
--url 'https://api.transavex.com/api/v1/payout/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": "553030000721"
},
"amount": 100,
"country": "BR",
"paymentMethod": "PIX_OUT_EVP",
"trafficType": "ALL",
"payoutDetails": {
"evp": "evp string from bank"
}
}'

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

{
"id": "8594c7b6-373c-4baa-a5ee-b5b5bf462d85",
"status": "In progress"
}