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

Верификация персональных данных держателей карт

Система позволяет отправить в запросах на транзакции параметры с персональными данными покупателя при необходимости сверки персональных данных в системе банка-эмитента платежной карты с персональными данными в системе торговца.

При активации для магазина сервиса верификации можно выбрать один из двух режимов:

  • Строгий режим: при ошибке проверки персональных данных, транзакция отклоняется. При этом транзакции присваивается код ошибки F.0996, а статус верификации будет иметь один из следующих кодов ошибок: F.0100, F.0101, F.0102;
  • Мягкий режим: некоторые ошибки верификации не влияют на успех транзакции, при этом информация и код ошибки (S.0001 или S.0002) будут доступны в секции vpd_verification.

Режим сервиса верификации выбирается в зависимости от требований законодательства РБ, применимых к сфере деятельности торговца.

Больше информации о кодах ошибок сервиса верификации персональных данных здесь.

Info

Для повышения вероятности успешной верификации для нерезидентов Беларуси рекомендуется передавать максимально полные данные о ФИО покупателя: фамилию, имя и отчество покупателя как в латинской транскрипции, так и на кириллице.

Интеграция через виджет

При интеграции с виджетом или платежной страницей bePaid создайте токен платежа или выполните запрос на формирование виджета с дополнительными параметрами из таблицы ниже:

object
условно обязательный
 object
Секция информации о покупателе.
external_id
 string (255)
Уникальный идентификатор покупателя в системе торговца.
birth_date
условно обязательный
 string
Дата рождения покупателя в формате ISO 8601 YYYY-MM-DD. Параметр обязателен только для резидентов Беларуси.
object
object
Секция, содержащая детальную информацию по платежу.
object
Информация об идентификационном документе покупателя.
document_type
условно обязательный
 string (50)
Тип идентификационного документа. Параметр обязателен только для нерезидентов Беларуси.
document_series
 string (20)
Серия идентификационного документа. Параметр не передаётся, если серия уже указана в значении параметра document_number.
document_number
условно обязательный
 string (50)
Номер идентификационного документа. Параметр обязателен только для нерезидентов Беларуси.
document_country
условно обязательный
 string (2)
Страна, которая выдала идентификационный документ в ISO 3166-1 alpha-2 формате. Параметр обязателен для нерезидентов Беларуси.
personal_number
условно обязательный
 string (50)
Личный номер, указанный в идентификационном документе. Параметр обязателен только для резидентов Беларуси.
object
Секция KYC данных покупателя.
object
Секция KYC данных покупателя.
phone
условно обязательный
 string (30)
Номер телефона покупателя. Обязателен для нерезидентов Беларуси. Значение должно начинаться с + и не должно содержать пробелов.
first_name
условно обязательный
 string (100)
Имя покупателя, указанное латинскими буквами. Параметр обязателен для нерезидентов Беларуси.
last_name
условно обязательный
 string (100)
Фамилия покупателя, указанная латинскими буквами. Параметр обязателен для нерезидентов Беларуси.
middle_name
 string (100)
Отчество покупателя, указанное латинскими буквами.
first_name_ru
условно обязательный
 string (100)
Имя покупателя на русском языке.
last_name_ru
условно обязательный
 string (100)
Фамилия покупателя на русском языке.
middle_name_ru
 string (100)
Отчество покупателя на русском языке.

Пример

Пример запроса на создание токена платежа 
{
  "checkout": {
    "test": true,
    "transaction_type": "payment",
    "settings": {
      "return_url": "http://127.0.0.1:4567/return",
      "success_url": "http://127.0.0.1:4567/success",
      "notification_url": "http://your_shop.com/notification"
    },
    "order": {
      "tracking_id": "your_unique_number",
      "currency": "BYN",
      "amount": 10000,
      "expired_at": "2025-11-29T05:33:38Z",
      "description": "description",
      "additional_data": {
        "customer_id_data": {            
          "personal_number": "30101990AB123CD4"
        }         
      }
    },
    "customer": {
      "external_id": "user-12345",
      "birth_date": "1990-01-01"
    }               
  }
}
Пример запроса на создание токена платежа 
{
  "checkout": {
    "test": true,
    "transaction_type": "payment",
    "settings": {
      "return_url": "http://127.0.0.1:4567/return",
      "success_url": "http://127.0.0.1:4567/success",
      "notification_url": "http://your_shop.com/notification"
    },
    "order": {
      "tracking_id": "your_unique_number",
      "currency": "BYN",
      "amount": 10000,
      "expired_at": "2025-11-29T05:33:38Z",
      "description": "description",
      "additional_data": {
        "customer_id_data": {
          "document_type": "passport",            
          "document_number": "12345678",
          "document_country": "GB"            
        },
        "kyc_answers": {
          "answers": {
            "first_name": "Ivan",
            "last_name": "Ivanov",
            "middle_name": "Ivanovich",
            "first_name_ru": "Иван",
            "last_name_ru": "Иванов",
            "middle_name_ru": "Иванович"             
          }
        }
      }
    },
    "customer": {
      "external_id": "user-12345"
    }              
  }
}

Платежи картами

Авторизация / Оплата

Запрос

Отправьте запрос авторизации или запрос оплаты со следующими дополнительными параметрами:
object
условно обязательный
 object
Секция информации о покупателе.
external_id
 string (255)
Уникальный идентификатор покупателя в системе торговца.
birth_date
условно обязательный
 string
Дата рождения покупателя в формате ISO 8601 YYYY-MM-DD. Параметр обязателен только для резидентов Беларуси.
object
Секция, содержащая детальную информацию по платежу.
object
Информация об идентификационном документе покупателя.
document_type
условно обязательный
 string (50)
Тип идентификационного документа. Параметр обязателен только для нерезидентов Беларуси.
document_series
 string (20)
Серия идентификационного документа. Параметр не передаётся, если серия уже указана в значении параметра document_number.
document_number
условно обязательный
 string (50)
Номер идентификационного документа. Параметр обязателен только для нерезидентов Беларуси.
document_country
условно обязательный
 string (2)
Страна, которая выдала идентификационный документ в ISO 3166-1 alpha-2 формате. Параметр обязателен для нерезидентов Беларуси.
personal_number
условно обязательный
 string (50)
Личный номер, указанный в идентификационном документе. Параметр обязателен только для резидентов Беларуси.
object
Секция KYC данных покупателя.
object
Секция KYC данных покупателя.
phone
условно обязательный
 string (30)
Номер телефона покупателя. Обязателен для нерезидентов Беларуси. Значение должно начинаться с + и не должно содержать пробелов.
first_name
условно обязательный
 string (100)
Имя покупателя, указанное латинскими буквами. Параметр обязателен для нерезидентов Беларуси.
last_name
условно обязательный
 string (100)
Фамилия покупателя, указанная латинскими буквами. Параметр обязателен для нерезидентов Беларуси.
middle_name
 string (100)
Отчество покупателя, указанное латинскими буквами.
first_name_ru
условно обязательный
 string (100)
Имя покупателя на русском языке.
last_name_ru
условно обязательный
 string (100)
Фамилия покупателя на русском языке.
middle_name_ru
 string (100)
Отчество покупателя на русском языке.

Примеры запросов на авторизацию/оплату

Info

Пример запроса для резидента Беларуси 
{
    "request": {
        "amount": 100,
        "currency": "BYN",
        "description": "Test transaction",
        "tracking_id": "your_unique_number",
        "language": "ru",
        "test": true,
        "credit_card": {
            "number": "4200000000000000",
            "verification_value": "123",
            "holder": "John Doe",
            "exp_month": "05",
            "exp_year": "2027"
        },
        "customer": {
            "external_id": "user-12345",
            "birth_date": "1990-01-01"
        },
        "additional_data": {
            "customer_id_data": {
               "personal_number": "30101990AB123CD4"
            }
        }
    }
}
Пример запроса для нерезидента Беларуси 
{
    "request": {
        "amount": 100,
        "currency": "BYN",
        "description": "Test transaction",
        "tracking_id": "your_unique_number",
        "language": "ru",
        "test": true,
        "credit_card": {
            "number": "4200000000000000",
            "verification_value": "123",
            "holder": "John Doe",
            "exp_month": "05",
            "exp_year": "2027"
        },
        "customer": {
            "external_id": "user-12345"
        },
        "additional_data": {
            "customer_id_data": {
                "document_type": "{Document type, passport}",
                "document_number": "{Document number, 1234567}",
                "document_country": "{Country that issued the document, GB}"
            },
            "kyc_answers": {
                "answers": {
                    "phone": "+375291234567",
                    "first_name": "Ivan",
                    "last_name": "Petrov",
                    "middle_name": "Ivanovich",
                    "first_name_ru": "Иван",
                    "last_name_ru": "Петров",
                    "middle_name_ru": "Иванович"                               
                }
            }
        }
    }
}

Ответ

Ответ будет содержать дополнительную секцию vpd_verification c результатом верификации персональных данных.
object
status
 string
Общий статус обработки транзакции
code
 string (6)
Код ошибки, F.0996, если транзакция не была подтверждена в VPD.
message
 string (255)
Сообщение с результатом запроса, соответствующее коду ошибки обработки транзакции (code).
friendly_message
 string (255)
Сообщение для покупателя с описанием кода ошибки из параметра code.
object
Объект данных проверки сервиса верификации персональных данных.
status
 string
Статус проверки VPD.
Возможные значения: pending, verified, rejected.
code
 string (6)
Код ошибки сервиса верификации персональных данных.
message
 string (255)
Описание ошибки, соответствующее vpd_verification.code.
friendly_message
 string (255)
Сообщение для покупателя с описанием кода ошибки из параметра vpd_verification.code.
provider_response
 object
Дополнительная информация, полученная сервисом верификации персональных данных от эмитента.

Authorization

Успешная верификация 
{
    "transaction": {
        "uid": "26d6f343-b36e-4306-b6a3-013e2b969ec2",
        "status": "successful",
        "amount": 100,
        "currency": "BYN",
        "description": "Test transaction",
        "type": "authorization",
        "payment_method_type": "credit_card",
        "tracking_id": "your_unique_number",
        "message": "Transaction is successful.",
        "test": true,
        "created_at": "2025-09-10T13:52:04.428Z",
        "updated_at": "2025-09-10T13:52:07.029Z",
        "paid_at": "2025-09-10T13:52:06.945Z",
        "expired_at": null,
        "recurring_type": null,
        "closed_at": null,
        "settled_at": null,
        "manually_corrected_at": null,
        "language": "en",
        "credit_card": {
            "holder": "John Doe",
            "stamp": "d1c853d9d6623ad497d6df0f90b92d19ae8393913b17198ac6006bdc2700485a",
            "brand": "visa",
            "last_4": "0000",
            "first_1": "4",
            "bin": "420000",
            "bin_8": "42000000",
            "issuer_country": "US",
            "issuer_name": "VISA Demo Bank",
            "product": "F",
            "exp_month": 5,
            "exp_year": 2027,
            "token_provider": null,
            "token": null
        },
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/26d6f343-b36e-4306-b6a3-013e2b969ec2/065724d397951ad8fcd066cdb7edd678b78f50fc8866c64cdb198993eb554dcb?language=en",
        "status_code": null,
        "gateway": {
            "iframe": true
        },
        "mute_notifications": null,
        "version": 4,
        "psp_settled_at": null,
        "registry_id": null,
        "three_ds_expired_at": null,
        "id": "26d6f343-b36e-4306-b6a3-013e2b969ec2",
        "additional_data": {
            "customer_id_data": {
                "document_type": "{Вид документа passport}",                              
                "document_number": "{Номер документа 1234567}",
                "document_country": "{Страна выдавшая документ BY}"
            },
            "kyc_answers": {                              
                "answers": {                                  
                    "phone": "+375291234567",
                    "first_name": "Ivan",
                    "last_name": "Petrov",
                    "middle_name": "Sergeevich",
                    "first_name_ru": "Иван",
                    "last_name_ru": "Петров",
                    "middle_name_ru": "Сергеевич"
                }
            }
        },
        "redirect_url": "https://gateway.bepaid.by/process/26d6f343-b36e-4306-b6a3-013e2b969ec2",
        "code": "S.0000",
        "friendly_message": "The transaction is successfully processed.",
        "vpd_verification": {
            "status": "verified"
        },        
        "smart_routing_verification": {
            "status": "successful"
        },
        "payment": {
            "auth_code": "654321",
            "bank_code": "05",
            "rrn": "999",
            "ref_id": "777888",
            "message": "Payment was approved",
            "amount": 100,
            "currency": "BYN",
            "billing_descriptor": "test descriptor",
            "gateway_id": 2505,
            "status": "successful"
        },
        "avs_cvc_verification": {
            "avs_verification": {
                "result_code": "1"
            },
            "cvc_verification": {
                "result_code": "1"
            }
        },
        "customer": {
            "ip": null,
            "email": "ivan.petrov@example.com",
            "device_id": null,
            "birth_date": "1990-01-01",
            "external_id": "user-12345"
        },
        "billing_address": {
            "first_name": null,
            "last_name": null,
            "address": "1st Street",
            "country": "US",
            "city": "Denver",
            "zip": "96002",
            "state": "CO",
            "phone": null
        }
    }
}
Неуспешная верификация 
{
    "uid": "ab8dd5da-3e28-4f28-8cf7-ac714f8fd2cb",
    "code": "F.0996",
    "friendly_message": "Транзакция не была подтверждена.",
    "message": "Транзакция не была подтверждена в VPD.",
    "status": "failed",
    "amount": 100,
    "currency": "USD",
    "description": "Test transaction",
    "type": "authorization",
    "payment_method": {
        "payment_method_type": "credit_card",
        "holder": "John Doe",
        "stamp": "d1c853d9d6623ad497d6df0f90b92d19ae8393913b17198ac6006bdc2700485a",
        "brand": "visa",
        "last_4": "0000",
        "first_1": "4",
        "bin": "420000",
        "bin_8": "42000000",
        "issuer_country": "US",
        "issuer_name": "VISA Demo Bank",
        "product": "F",
        "exp_month": 5,
        "exp_year": 2028,
        "token_provider": null,
        "token": null
    },
    "tracking_id": "your_unique_number",
    "test": true,
    "created_at": "2025-09-10T14:06:18.885Z",
    "updated_at": "2025-09-10T14:06:19.267Z",
    "paid_at": null,
    "expired_at": null,
    "recurring_type": null,
    "closed_at": null,
    "settled_at": null,
    "manually_corrected_at": null,
    "language": "en",
    "redirect_url": "https://gateway.bepaid.by/process/ab8dd5da-3e28-4f28-8cf7-ac714f8fd2cb",
    "status_code": null,
    "links": {
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/ab8dd5da-3e28-4f28-8cf7-ac714f8fd2cb/2b144de0d9ab776b9788b19192ead0548452ebdeb071a139a4532450fc637a0a?language=en"
    },
    "gateway": {
        "iframe": true
    },
    "mute_notifications": null,
    "version": 2,
    "psp_settled_at": null,
    "registry_id": null,
    "three_ds_expired_at": null,
    "customer": {
        "ip": "127.0.0.1",
        "email": "john@example.com",
        "device_id": null,
        "birth_date": null,
        "external_id": null,
        "first_name": "John",
        "last_name": "Doe",
        "address": "1st Street",
        "country": "US",
        "city": "Denver",
        "zip": "96002",
        "state": "CO",
        "phone": null
    },
        "vpd_verification": {
            "status": "rejected",
            "code": "F.0100",
            "message": "Customer verification failed.",
            "friendly_message": "Customer verification failed.",
            "provider_response": {
                "is_clientcard": 1,
                "is_bdcorrect": 0
        }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
    "transaction": {
        "auth_code": null,
        "bank_code": null,
        "rrn": null,
        "ref_id": null,
        "message": null,
        "amount": 100,
        "currency": "USD",
        "billing_descriptor": null,
        "gateway_id": 2483,
        "status": "incomplete"
    }
}

Выплата

Запрос

Отправьте запрос выплаты со следующими дополнительными параметрами:
object
условно обязательный
 object
Секция информации о получателе платежа.
birth_date
условно обязательный
 string
Дата рождения получателя платежа в формате ISO 8601 YYYY-MM-DD. Параметр обязателен только для резидентов Беларуси.
object
Секция, содержащая детальную информацию по платежу.
object
Информация об идентификационном документе покупателя.
document_type
условно обязательный
 string (50)
Тип идентификационного документа. Параметр обязателен только для нерезидентов Беларуси.
document_series
 string (20)
Серия идентификационного документа. Параметр не передаётся, если серия уже указана в значении параметра document_number.
document_number
условно обязательный
 string (50)
Номер идентификационного документа. Параметр обязателен только для нерезидентов Беларуси.
document_country
условно обязательный
 string (2)
Страна, которая выдала идентификационный документ в ISO 3166-1 alpha-2 формате. Параметр обязателен для нерезидентов Беларуси.
personal_number
условно обязательный
 string (50)
Личный номер, указанный в идентификационном документе. Параметр обязателен только для резидентов Беларуси.
object
Секция KYC данных покупателя.
object
Секция KYC данных покупателя.
phone
условно обязательный
 string (30)
Номер телефона покупателя. Обязателен для нерезидентов Беларуси. Значение должно начинаться с + и не должно содержать пробелов.
first_name
условно обязательный
 string (100)
Имя покупателя, указанное латинскими буквами. Параметр обязателен для нерезидентов Беларуси.
last_name
условно обязательный
 string (100)
Фамилия покупателя, указанная латинскими буквами. Параметр обязателен для нерезидентов Беларуси.
middle_name
 string (100)
Отчество покупателя, указанное латинскими буквами.
first_name_ru
условно обязательный
 string (100)
Имя покупателя на русском языке.
last_name_ru
условно обязательный
 string (100)
Фамилия покупателя на русском языке.
middle_name_ru
 string (100)
Отчество покупателя на русском языке.

Пример

Пример запроса 
{
    "request": {
        "amount": 100,
        "currency": "BYN",
        "description": "Test transaction",
        "tracking_id": "tracking_id_000",
        "recipient": {
            "birth_date": "1990-01-01",
            "phone": "+375291234567",
            "email": "ivan.petrov@example.com"
        },
        "recipient_billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "US",
            "city": "Denver",
            "state": "CO",
            "zip": "96002",
            "address": "1st Street",
            "phone": "+375291234567"
        },
        "recipient_credit_card": {
            "number": "5555555555554444",
            "holder": "John Doe",
            "exp_month": "12",
            "exp_year": "2027"
        },
        "additional_data": {
            "customer_id_data": {
                "personal_number": "30101990AB123CD4"
            }
        }
    }
}
Пример запроса 
{
    "request": {
        "amount": 100,
        "currency": "BYN",
        "description": "Test transaction",
        "tracking_id": "tracking_id_000",
        "recipient": {                        
            "phone": "+375291234567",
            "email": "ivan.petrov@example.com"
        },
        "recipient_billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "US",
            "city": "Denver",
            "state": "CO",
            "zip": "96002",
            "address": "1st Street",
            "phone": "+375291234567"
        },
        "recipient_credit_card": {
            "number": "5555555555554444",
            "holder": "John Doe",
            "exp_month": "12",
            "exp_year": "2027"
        },
        "additional_data": {
            "customer_id_data": {
                "document_type": "{Вид документа passport}",                    
                "document_number": "{Номер документа 1234567}",
                "document_country": "{Страна выдавшая документ GB}"
            },
            "kyc_answers": {
                "answers": {
                    "phone": "+375291234567",
                    "first_name": "Ivan",
                    "last_name": "Petrov",
                    "middle_name": "Ivanovich",
                    "first_name_ru": "Иван",
                    "last_name_ru": "Петров",
                    "middle_name_ru": "Иванович"                        
                }
            }
        }
    }
}

Ответ

Ответ будет содержать дополнительную секцию vpd_verification c результатом верификации персональных данных.

Успешная верификация 
{
    "transaction": {
        "uid": "26d6f343-b36e-4306-b6a3-013e2b969ec2",
        "status": "successful",
        "amount": 100,
        "currency": "BYN",
        "description": "Test transaction",
        "type": "payout",
        "payment_method_type": "credit_card",
        "tracking_id": "your_unique_number",
        "message": "Transaction is successful.",
        "test": true,
        "created_at": "2025-09-10T13:52:04.428Z",
        "updated_at": "2025-09-10T13:52:07.029Z",
        "paid_at": "2025-09-10T13:52:06.945Z",
        "expired_at": null,
        "recurring_type": null,
        "closed_at": null,
        "settled_at": null,
        "manually_corrected_at": null,
        "language": "en",
        "credit_card": {
            "holder": "John Doe",
            "stamp": "d1c853d9d6623ad497d6df0f90b92d19ae8393913b17198ac6006bdc2700485a",
            "brand": "visa",
            "last_4": "0000",
            "first_1": "4",
            "bin": "420000",
            "bin_8": "42000000",
            "issuer_country": "US",
            "issuer_name": "VISA Demo Bank",
            "product": "F",
            "exp_month": 5,
            "exp_year": 2027,
            "token_provider": null,
            "token": null
        },
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/26d6f343-b36e-4306-b6a3-013e2b969ec2/065724d397951ad8fcd066cdb7edd678b78f50fc8866c64cdb198993eb554dcb?language=en",
        "status_code": null,
        "gateway": {
            "iframe": true
        },
        "mute_notifications": null,
        "version": 4,
        "psp_settled_at": null,
        "registry_id": null,
        "three_ds_expired_at": null,
        "id": "26d6f343-b36e-4306-b6a3-013e2b969ec2",
        "additional_data": {
            "customer_id_data": {
                "document_type": "{Вид документа passport}",                              
                "document_number": "{Номер документа 1234567}",
                "document_country": "{Страна выдавшая документ BY}"
            },
            "kyc_answers": {                              
                "answers": {
                    "phone": "+375291234567",
                    "first_name": "Ivan",
                    "last_name": "Petrov",
                    "middle_name": "Sergeevich",
                    "first_name_ru": "Иван",
                    "last_name_ru": "Петров",
                    "middle_name_ru": "Сергеевич"                                  
                }
            }
        },
        "redirect_url": "https://gateway.bepaid.by/process/26d6f343-b36e-4306-b6a3-013e2b969ec2",
        "code": "S.0000",
        "friendly_message": "The transaction is successfully processed.",
        "vpd_verification": {
            "status": "verified"
        },        
        "smart_routing_verification": {
            "status": "successful"
        },
        "payment": {
            "auth_code": "654321",
            "bank_code": "05",
            "rrn": "999",
            "ref_id": "777888",
            "message": "Payment was approved",
            "amount": 100,
            "currency": "BYN",
            "billing_descriptor": "test descriptor",
            "gateway_id": 2505,
            "status": "successful"
        },
        "avs_cvc_verification": {
            "avs_verification": {
                "result_code": "1"
            },
            "cvc_verification": {
                "result_code": "1"
            }
        },
        "customer": {
            "ip": null,
            "email": "ivan.petrov@example.com",
            "device_id": null,
            "birth_date": "1990-01-01",
            "external_id": "user-12345"
        },
        "billing_address": {
            "first_name": null,
            "last_name": null,
            "address": "1st Street",
            "country": "US",
            "city": "Denver",
            "zip": "96002",
            "state": "CO",
            "phone": null
        }
    }
}

Значения document_type
Значение параметра document_type Описание параметра document_type
passport Паспорт
international_passport Заграничный паспорт
foreign_passport Паспорт иностранного гражданина
id_card Идентификационная карта (ID-карта)
driver_license Водительское удостоверение
residence_permit Вид на жительство иностранного гражданина (обычный)
residence_permit_refugee Вид на жительство беженца. (обычный)
residence_permit_bio_refugee Вид на жительство беженца (биометрический).
residence_permit_bio_stateless Вид на жительство лица без гражданства (биометрический)
temporary_residence_permit Разрешение на временное проживание
temporary_identity_card Удостоверение личности (временное удостоверение личности)
military_identity_card Удостоверение личности военнослужащего
military_id Военный билет
refugee_certificate Удостоверение беженца
temporary_asylum_certificate Свидетельство о предоставлении временного убежища
resettler_certificate Удостоверение переселенца или лица, ходатайствующего о статусе
travel_document_foreign Проездной документ иностранного гражданина
migration_card Миграционная карта
seafarer_passport Паспорт моряка / удостоверение личности моряка
diplomatic_certificate Удостоверение личности дипломатического/служебного представителя
return_certificate Свидетельство о возвращении на родину / справка на возвращение
other Иной документ, удостоверяющий личность

Тестирование

Для тестирования верификации, выполните один из запросов на этой странице, добавив параметр request.test со значением true. Для успешной верификации, используйте значения из таблицы.

Название параметра (в скобках – для выплат) Резидент Беларуси Нерезидент Беларуси
credit_card.number (recipient_credit_card.number) 9112395040140378 9112395040140378
credit_card.exp_month (recipient_credit_card.exp_month) любой любой
credit_card.exp_year (recipient_credit_card.exp_year) позже 2026 позже 2026
additional_data.customer_id_data.personal_number 3120590A001PB5 -
customer.birth_date (recipient.birth_date) 1990-01-01 -
additional_data.customer_id_data.document_number - AA1234567
additional_data.customer_id_data.document_type - passport
additional_data.customer_id_data.document_country - PL
additional_data.kyc_answers.answers.first_name - Ivan
additional_data.kyc_answers.answers.last_name - Ivanov

Запрос

Пример

Пример запроса на оплату 
{
    "request": {
        "amount": "100",
        "currency": "BYN",
        "test": true,
        "description": "Test transaction",
        "language": "ru",
        "notification_url": "https://notification-url",
        "credit_card": {
            "number": "9112395040140378",
            "verification_value": "123",
            "holder": "John Doe",
            "exp_month": "05",
            "exp_year": "2026"
        },
        "customer": {
            "external_id": "user-12345",
            "birth_date": "1990-01-01"
        },
        "additional_data": {
            "customer_id_data": {
                "personal_number": "30101990AB123CD4"
            }
        }
    }
}
Пример запроса на оплату 
{
    "request": {
        "amount": "100",
        "currency": "BYN",
        "test": true,
        "description": "Test transaction",
        "language": "ru",
        "notification_url": "https://notification-url",
        "credit_card": {
            "number": "9112395040140378",
            "verification_value": "123",
            "holder": "John Doe",
            "exp_month": "05",
            "exp_year": "2026"
        },
        "customer": {
            "external_id": "user-12345"
        },
        "additional_data": {
            "customer_id_data": {
                "document_number": "AA1234567",
                "document_type": "passport",
                "document_country": "PL"
            },
            "kyc_answers": {
                "answers": {
                    "first_name": "Ivan",
                    "last_name": "Ivanov"
                }
            }
        }
    }
}

Ответ

В случае ошибок верификации, в параметре transaction.code будет указан код обработки транзакции F.0996, а в параметре vpd_verification.code будет указан один из кодов ошибок сервиса верификации персональных данных.

1.Успешная верификация

Для запроса используйте данные покупателя из таблицы

Фрагмент ответа при успешной верификации 
{
    "transaction": {
        "uid": "26d6f343-b36e-4306-b6a3-013e2b969ec2",
        "status": "successful",
        ...
        "message": "Transaction is successful.",
        "test": true,
        "code": "S.0000",
        "friendly_message": "The transaction is successfully processed.",
        "vpd_verification": {
            "status": "verified"
        },
        "smart_routing_verification": {
            "status": "successful"
        }
    }
}

2. Статус верификации rejected: переданные данные покупателя не совпадают с данными в системе эмитента (строгий и мягкий режим)

Для получения данного ответа:

  • для резидентов Беларуси отправьте в запросе значение параметра birth_date, отличное от значения в таблице;
  • для нерезидентов Беларуси отправьте в запросе значение параметра document_number, отличное от значения в таблице.
Фрагмент запроса для получения статуса rejected: ошибка F.0100 
{
  "request": {
    "credit_card": {
            "number": "9112395040140378"
            },
    "customer": {
      "birth_date": "1991-02-02"
    },
    "additional_data": {
      "customer_id_data": {
        "personal_number": "30101990AB123CD4"
      }
    }
  }
}
Фрагмент ответа при статусе верификации rejected: переданные данные покупателя не совпадают с данными в системе эмитента 
{
    "transaction": {
        "uid": "ab8dd5da-3e28-4f28-8cf7-ac714f8fd2cb",
        "code": "F.0996",
        "friendly_message": "Транзакция не была подтверждена.",
        "message": "Транзакция не была подтверждена сервисом верификации VPD.",
        "status": "failed",
        "vpd_verification": {
            "status": "rejected",
            "code": "F.0100",
            "message": "Проверка клиента неуспешна.",
            "friendly_message": "Проверка клиента неуспешна.",
            "provider_response": {
                "is_clientcard": 1,
                "is_bdcorrect": 0
            }
        }
    }
}

3. Ошибка валидации параметров (строгий и мягкий режим)

Для получения данного ответа:

  • для резидентов Беларуси отправьте запрос без обязательного параметра personal_number;
  • для нерезидентов Беларуси отправьте запрос без обязательного параметра document_country.
Фрагмент запроса для получения ошибки валидации 
{
  "request": {
    "credit_card": {
            "number": "9112380131987184"
            },
    "customer": {
      "birth_date": "1991-01-01"
    },
    "additional_data": {
      "customer_id_data": {
        "personal_number": ""
      }
    }
  }
}
Фрагмент ответа при ошибке валидации, не отправлен один из обязательных параметров 
{
    "uid": "b3c81448-91ef-4d72-af47-c923f796a2fb",
    "code": "F.0996",
    "friendly_message": "Транзакция не была подтверждена сервисом верификации VPD.",
    "status": "failed",
    ...
    "message": "Транзакция не была подтверждена.",
    ...
    "vpd_verification": {
        "status": "rejected",
        "code": "F.0102",
        "message": "Неверные параметры запроса. Проверьте параметры транзакции или обратитесь к провайдеру платежных услуг.",
        "friendly_message": "Неверные параметры запроса. Обратитесь к продавцу для уточнения причины.",
        "provider_response": {
            "is_clientcard": 1,
            "is_bdcorrect": 0
        },
        "service_code": "vpd_rejected"
    },
    ...
}

4.Статус верификации rejected: cервис верификации VPD передаваемых данных не определен по bin карты (строгий режим)

Для воспроизведения данной ошибки используйте номер любой карты, эмитированной в Республике Беларусь, за исключением 9112395040140378. Например, 9112380131987184.

Фрагмент запроса для получения статуса rejected: ошибка F.0101 
{
    "request": {
        "amount": "100",
        "currency": "BYN",
        "test": true,
        "description": "Test transaction",
        "language": "ru",
        "notification_url": "https://notification-url",
        "credit_card": {
            "number": "9112380131987184",
            "verification_value": "123",
            "holder": "John Doe",
            "exp_month": "05",
            "exp_year": "2026"
        },
        "customer": {
            "external_id": "user-12345",
            "birth_date": "1990-01-01"
        },
        "additional_data": {
            "customer_id_data": {
                "personal_number": "30101990AB123CD4"
            }
        }
    }
}
Фрагмент ответа при статусе верификации rejected: cервис верификации VPD передаваемых данных не определен по bin карты 
{
    "transaction": {
        "uid": "ab8dd5da-3e28-4f28-8cf7-ac714f8fd2cb",
        "code": "F.0996",
        "friendly_message": "Транзакция не была подтверждена.",
        "message": "Транзакция не была подтверждена сервисом верификации VPD.",
        "status": "failed",
        "vpd_verification": {
            "status": "rejected",
            "code": "F.0101",
            "message": "Проверка клиента неуспешна. Сервис верификации VPD передаваемых данных не определен.",
            "friendly_message": "Проверка клиента неуспешна."
        }
    }
}

5.Статус транзакции successful, статус верификации skipped(мягкий режим)

Для воспроизведения данной ошибки используйте номер любой карты, эмитированной в Республике Беларусь, за исключением 9112395040140378. Например, 9112380131987184. Также на уровне магазина должен быть настроен мягкий режим сервиса верификации.

Пример запроса для получения ошибки верификации S.0001 
{
    "request": {
        "amount": 100,
        "description": "description",
        "currency": "BYN",
        "test": true,
        "credit_card": {
            "number": "9112380131987184",
            "exp_month": "03",
            "exp_year": "2027"
        },
        "customer": {
            "birth_date": "1991-01-01"
        },
        "additional_data": {
            "customer_id_data": {
                "personal_number": ""
            }
        }
    }
}
Пример ответа при статусе верификации skipped: cервис верификации VPD передаваемых данных не определен по bin карты, для магазина настроен мягкий режим сервиса верификации 
{
    "transaction": {
        "uid": "8644fe00-35f0-4e35-a148-5d8405e722d6",
        "status": "successful",
        "amount": 100,
        "currency": "BYN",
        "description": "description",
        "type": "payment",
        "payment_method_type": "credit_card",
        "tracking_id": null,
        "message": "Transaction is successful.",
        "test": true,
        "created_at": "2026-01-21T14:11:38.309Z",
        "updated_at": "2026-01-21T14:11:40.879Z",
        "paid_at": "2026-01-21T14:11:40.815Z",
        "expired_at": null,
        "recurring_type": "d_moto",
        "closed_at": null,
        "settled_at": null,
        "manually_corrected_at": null,
        "language": "en",
        "credit_card": {
            "holder": null,
            "stamp": "a34d9860a75986a749b685d8c91f0697d0699fd9d4c7afaaf265c9846ff6ad27",
            "brand": "belkart",
            "last_4": "7184",
            "first_1": "9",
            "bin": "911238",
            "bin_8": "91123801",
            "issuer_country": "BY",
            "issuer_name": "BELARUSBANK",
            "product": "BELKART",
            "exp_month": 3,
            "exp_year": 2027,
            "token_provider": null,
            "token": null
        },
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/8644fe00-35f0-4e35-a148-5d8405e722d6/2cccbd19079bd02335e03c87c6b6bd20a53a8069cbae3d37e790593a49d6de34?language=en",
        "status_code": null,
        "gateway": {
            "iframe": true
        },
        "mute_notifications": null,
        "version": 3,
        "psp_settled_at": null,
        "registry_id": null,
        "three_ds_expired_at": null,
        "id": "8644fe00-35f0-4e35-a148-5d8405e722d6",
        "additional_data": {
            "customer_id_data": {
                "personal_number": ""
            }
        },
        "vpd_verification": {
            "status": "skipped",
            "code": "S.0001",
            "message": "Проверка клиента пропущена, не найден внешний сервис верификации.",
            "friendly_message": "Проверка клиента пропущена, не найден внешний сервис верификации."
        },
        "redirect_url": "https://gateway.bepaid.by/process/8644fe00-35f0-4e35-a148-5d8405e722d6",
        "code": "S.0000",
        "friendly_message": "The transaction is successfully processed.",        
        "payment": {
            "auth_code": "654321",
            "bank_code": "05",
            "rrn": "999",
            "ref_id": "777888",
            "message": "Payment was approved",
            "amount": 100,
            "currency": "BYN",
            "billing_descriptor": "TEST GATEWAY BILLING DESCRIPTOR",
            "gateway_id": 3549,
            "status": "successful"
        },
        "avs_cvc_verification": {
            "avs_verification": {
                "result_code": "1"
            },
            "cvc_verification": {
                "result_code": "1"
            }
        },
        "customer": {
            "ip": null,
            "email": null,
            "device_id": null,
            "birth_date": "1991-01-01",
            "external_id": null
        },
        "billing_address": {
            "first_name": null,
            "last_name": null,
            "middle_name": null,
            "address": null,
            "country": null,
            "city": null,
            "zip": null,
            "state": null,
            "phone": null
        }
    }
}

Платежи ЕРИП

Для торговцев в сфере игорного бизнеса при оплате через ЕРИП необходимо передавать дополнительные параметры покупателя.

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

  • Страну, которая выдала идентификационный документ: additional_data.customer_id_data.document_country.
  • Идентификационный номер, указанный в документе: additional_data.customer_id_data.personal_number.

Примеры запросов для резидентов Беларуси:

Запрос на создание токена платежа 
{
  "checkout": {
    "test": true,
    "transaction_type": "payment",
    "settings": {
      "return_url": "http://127.0.0.1:4567/return",
      "success_url": "http://127.0.0.1:4567/success",
      "notification_url": "http://your_shop.com/notification"
    },
    "order": {
      "tracking_id": "your_unique_number",
      "currency": "BYN",
      "amount": 10000,
      "expired_at": "2025-11-29T05:33:38Z",
      "description": "description",
      "additional_data": {
        "customer_id_data": {
          "document_country": "BY",
          "personal_number": "0000000A000PB0"            
        }                    
      }
    }
  }
}
Запрос на создание платежного требования в ЕРИП 
{
  "request": {
    "amount": 1000,
    "currency": "BYN",
    "description": "Payment for Order#123",
    "email": "ivanpetrov@example.com",
    "ip": "127.0.0.1",
    "order_id": 123456789012,
    "tracking_id": "AB8923",
    "notification_url": "http://merchant.example.com",
    "customer": {
      "first_name": "Ivan",
      "middle_name": "Ivanovich",
      "last_name": "Petrov"
    },
    "payment_method": {
      "type": "erip",
      "account_number": "123",
      "service_no": "99999999"
    },
    "additional_data": {
      "customer_id_data": {
        "document_country": "BY",
        "personal_number": "0000000A000PB0"
      }
    }
  }
}

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

  • Страну, которая выдала идентификационный документ: additional_data.customer_id_data.document_country.
  • Дату рождения покупателя: customer.birth_date.

Примеры запросов для нерезидентов Беларуси:

Запрос на создание токена платежа 
{
  "checkout": {
    "test": true,
    "transaction_type": "payment",
    "settings": {
      "return_url": "http://127.0.0.1:4567/return",
      "success_url": "http://127.0.0.1:4567/success",
      "notification_url": "http://your_shop.com/notification"
    },
    "order": {
      "tracking_id": "your_unique_number",
      "currency": "BYN",
      "amount": 10000,
      "expired_at": "2025-11-29T05:33:38Z",
      "description": "description",
      "additional_data": {
        "customer_id_data": {
          "document_country": "RU"     
        }                    
      }
    },
    "customer": {
      "birth_date": "1990-01-01"
    }
  }
}
Запрос на создание платежного требования в ЕРИП 
{
  "request": {
    "amount": 1000,
    "currency": "BYN",
    "description": "Payment for Order#123",
    "email": "ivanpetrov@example.com",
    "ip": "127.0.0.1",
    "order_id": 123456789012,
    "tracking_id": "AB8923",
    "notification_url": "http://merchant.example.com",
    "customer": {
      "first_name": "Ivan",
      "middle_name": "Ivanovich",
      "last_name": "Petrov",
      "birth_date": "1990-01-01"
    },
    "payment_method": {
      "type": "erip",
      "account_number": "123",
      "service_no": "99999999"
    },
    "additional_data": {
      "customer_id_data": {
        "document_country": "RU"
      }
    }
  }
}