Перейти к содержанию

Трансграничные карточные переводы

Для трансграничных переводов используйте один из типов транзакций, перечисленных ниже. Уточните у менеджера или службы технической поддержки, какой тип подходит для вашего магазина.

Чтобы предварительно получить информацию о расчёте комиссий для перевода через /p2ps, выполните запрос проверки возможности P2P-перевода.

Выплата

Отправьте POST запрос на https://gateway.bepaid.by/transactions/payouts со следующими параметрами:
object
amount
обязательный
 bigInteger
Стоимость в минимальных денежных единицах. Например, 32.45 должна быть отправлена как 3245.
currency
обязательный
 string
Валюта в ISO-4217 формате, например USD.
description
обязательный
 string (255)
Описание выплаты.
tracking_id
обязательный
 string (255)
Идентификатор транзакции в системе торговца.
notification_url
 string
URL, на который будут приходить уведомления. Формат запроса уведомления аналогичен формату ответа транзакции.
object
number
обязательный
 string (19)
Номер карты.
holder
обязательный
 string (32)
Имя владельца карты.
object
Данные отправителя.
birth_date
обязательный
 string
Дата рождения отправителя в формате ISO 8601 YYYY-MM-DD.
object
Данные получателя перевода.
first_name
обязательный
 string (30)
Имя получателя.
last_name
обязательный
 string (30)
Фамилия получателя.
object
Данные отправителя
first_name
обязательный
 string (30)
Имя отправителя.
last_name
обязательный
 string (30)
Фамилия отправителя.
country
обязательный
 string
Страна отправителя в формате ISO 3166-1 alpha-2.
city
обязательный
 string (60)
Город отправителя.
state
 string
Штат или регион отправителя. Подробнее здесь.
zip
обязательный
 string
Почтовый индекс отправителя.
address
обязательный
 string (255)
Адрес отправителя.
object
Cекция, содержащая дополнительную информацию о транзакции.
object
Информация об идентификационном документе отправителя.
document_type
 string (50)
Тип идентификационного документа. Возможные значения параметра указаны здесь.
document_number
обязательный
 string (50)
Номер идентификационного документа.
Пример запроса 
{
    "request": {
        "amount": 100,
        "currency": "BYN",
        "description": "перевод",
        "tracking_id": "tracking_id_000",
        "sender_billing_address": {
            "first_name": "John", 
            "last_name": "Doe", 
            "country": "GB",
            "city": "London",
            "state": "Greater London",
            "zip": "SW1A 1AA",
            "address": "104 1st Street"
        },
        "sender": {
            "birth_date": "1990-10-20"
        },              
        "recipient_credit_card": {
            "number": "4200000000000000",
            "holder": "Alex Smith"
        },
        "recipient_billing_address": {
            "first_name": "Alex",
            "last_name": "Smith"
        },
        "additional_data": {
          "customer_id_data": {
            "document_number": "11111111" 
          }
        }             
    }
}

P2P-перевод

Отправьте POST запрос на https://gateway.bepaid.by/transactions/p2ps со следующими параметрами:
object
amount
обязательный
 bigInteger
Сумма перевода в минимальных денежных единицах. Например, 32.45 должна быть отправлена как 3245.
currency
обязательный
 string
Валюта в ISO-4217 формате, например USD.
description
обязательный
 string (255)
Описание перевода.
tracking_id
обязательный
 string (255)
Идентификатор транзакции в системе торговца.
notification_url
 string
URL, на который будут приходить уведомления. Формат запроса уведомления аналогичен формату ответа транзакции.
object
Секция параметров карты отправителя.
number
обязательный
 string
Номер карты отправителя.
exp_month
обязательный
 string (2)
Месяц окончания срока действия карты отправителя, представленный одной или двумя цифрами (например, 01).
exp_year
обязательный
 string (4)
Год окончания срока действия карты отправителя, представленный четырьмя цифрами (например, 2028).
holder
обязательный
 string (35)
Имя владельца карты отправителя.
object
number
обязательный
 string (19)
Номер карты.
holder
обязательный
 string (32)
Имя владельца карты.
object
Данные отправителя.
birth_date
обязательный
 string
Дата рождения отправителя в формате ISO 8601 YYYY-MM-DD.
object
Данные получателя перевода.
first_name
обязательный
 string (30)
Имя получателя.
last_name
обязательный
 string (30)
Фамилия получателя.
object
Данные отправителя.
first_name
обязательный
 string (30)
Имя отправителя.
last_name
обязательный
 string (30)
Фамилия отправителя.
country
обязательный
 string
Страна отправителя в формате ISO 3166-1 alpha-2.
city
обязательный
 string (60)
Город отправителя.
state
 string
Штат или регион отправителя. Подробнее здесь.
zip
обязательный
 string
Почтовый индекс отправителя.
address
обязательный
 string (255)
Адрес отправителя.
object
Cекция, содержащая дополнительную информацию о транзакции.
object
Информация об идентификационном документе отправителя.
document_type
 string (50)
Тип идентификационного документа. Возможные значения параметра указаны здесь.
document_number
обязательный
 string (50)
Номер идентификационного документа.
Пример запроса 
{
    "request": {              
        "amount": 500,
        "currency": "BYN",              
        "description": "Test transaction p2ps ",
        "tracking_id": "tracking_id_01",
        "credit_card": {
            "number": "4012000000003010",
            "exp_month": "10",
            "exp_year": "2028",
            "holder": "JOHN DOE"
        },
        "sender_billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "GB",
            "city": "London",
            "state": "Greater London",
            "zip": "SW1A 1AA",
            "address": "104 First Street"
        },
        "customer": {
          "birth_date": "1990-10-20" 
        },
        "recipient_card": {
            "number": "4012000000003101",
            "holder": "Alex Smith"
        },
        "recipient_billing_address": {
            "first_name": "Alex", 
            "last_name": "Smith" 
        },
        "additional_data": {
          "customer_id_data": {
            "document_number": "11111111"
          }
        }  
    }
}

Проверка возможности P2P-перевода

Отправьте POST запрос на https://gateway.bepaid.by/p2p-restrictions со следующими параметрами:
object
amount
обязательный
 bigInteger
Стоимость в минимальных денежных единицах. Например, 32.45 должна быть отправлена как 3245.
currency
обязательный
 string
Валюта в ISO-4217 формате, например USD.
object
Секция параметров карты отправителя.
number
обязательный
 string
Номер карты отправителя.
exp_month
обязательный
 string (2)
Месяц окончания срока действия карты отправителя, представленный одной или двумя цифрами (например, 01).
exp_year
обязательный
 string (4)
Год окончания срока действия карты отправителя, представленный четырьмя цифрами (например, 2028).
holder
обязательный
 string (35)
Имя владельца карты отправителя.
object
number
обязательный
 string (19)
Номер карты.
holder
обязательный
 string (32)
Имя владельца карты.
Пример запроса 
{
    "request": {              
        "amount": 500,
        "currency": "BYN",            
        "credit_card": {
            "number": "4012000000003010",
            "exp_month": "10",
            "exp_year": "2028",
            "holder": "JOHN DOE"
        },              
        "recipient_card": {
            "number": "4012000000003101",
            "holder": "Alex Smith"
        }               
    }
}