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

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

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

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
условно обязательный
 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_uniq_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_uniq_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
условно обязательный
 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_uniq_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_uniq_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": "1234567",
                    "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_uniq_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": "1234567890",
                    "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_uniq_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
условно обязательный
 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": "375444444444"
        },
        "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": "375444444444"
        },
        "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": "1234567890",
                    "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_uniq_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": "1234567890",
                    "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 30101990AB123CD4 -
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": "Проверка клиента неуспешна."
        }
    }
}