У запит на купівлю додається параметр reservation_data. Приклад:
У форматі XML:
<?xml version="1.0" encoding="UTF-8" ?>
<request>
<response_url>https://site.com/responsepage/</response_url>
<order_id>test_reservation_data_12345</order_id>
<order_desc>Test payment</order_desc>
<currency>EUR</currency>
<amount>100</amount>
<signature>dcf5a9a582872bf0ba89bb77a25c3894671b423a</signature>
<merchant_id>1396424</merchant_id>
<reservation_data>
ewogICJwaG9uZW1vYmlsZSI6ICIrMTIzNDU2NzgiLAogICJjdXN0b21lcl9hZ
GRyZXNzIjogIjE1IGdhbm5ldCBzdHJlZXQgZWxzcGFyayIsCiAgImN1c3RvbW
VyX2NvdW50cnkiOiAiVVMiLAogICJjdXN0b21lcl9zdGF0ZSI6ICJOWSIsCiA
gImN1c3RvbWVyX25hbWUiOiAiQnJhbmRvbiBOeWF0aGkiLAogICJjdXN0b21l
cl9jaXR5IjogIk5ldyBZb3JrIiwKICAiY3VzdG9tZXJfemlwIjogIjE0MDEiL
AogICJhY2NvdW50IjogImlkMzI2NDg0ODAiCn0=</reservation_data>
</request>
У форматі JSON:
{
"request": {
"response_url": "https://site.com/responsepage/",
"order_id": "test_reservation_data_12345",
"order_desc": "Test payment",
"currency": "EUR",
"amount": "100",
"signature": "dcf5a9a582872bf0ba89bb77a25c3894671b423a",
"merchant_id": "1396424",
"reservation_data": "ewogICJwaG9uZW1vYmlsZSI6ICIrMTIzNDU2NzgiLAogICJjdXN0b21lcl9hZGRyZXNzIjogIjE1IGdhbm5ldCBzdHJlZXQgZWxzcGFyayIsCiAgImN1c3RvbWVyX2NvdW50cnkiOiAiVVMiLAogICJjdXN0b21lcl9zdGF0ZSI6ICJOWSIsCiAgImN1c3RvbWVyX25hbWUiOiAiQnJhbmRvbiBOeWF0aGkiLAogICJjdXN0b21lcl9jaXR5IjogIk5ldyBZb3JrIiwKICAiY3VzdG9tZXJfemlwIjogIjE0MDEiLAogICJhY2NvdW50IjogImlkMzI2NDg0ODAiCn0="
}
}
reservation_data – це набір JSON-даних, закодований алгоритмом BASE64, який має таку структуру:
JSON:
{
"phonemobile": "+12345678",
"customer_address": "15 gannet street elspark",
"customer_country": "US",
"customer_state": "NY",
"customer_name": "Brandon Nyathi",
"customer_city": "New York",
"customer_zip": "1401",
"account": "id32648480",
"uuid": "00002415-0000-1000-8000-00805F9B34FB"
}
Усі передані дані мають бути alphanumeric, тобто містити латинські літери, цифри, розділові знаки
назва параметра | тип даних | опис | приклад значення |
---|---|---|---|
phonemobile | AN(16) | мобільний телефон платника | +12345678 |
customer_address | AN(1024) | Домашня адреса клієнта латиницею | 15 gannet street elspark |
customer_country | AN(2) | ISO код країни клієнта | UK |
customer_name | AN(1024) | ПІБ клієнта латиницею | Brandon Nyathi |
customer_city | AN(1024) | Місто проживання або оформлення покупки латиницею | New York |
customer_zip | AN(250) | ZIP або поштовий код клієнта | 1401 |
account | AN(250) | Ідентифікатор акаунта клієнта (id, номер телефону тощо). | id32648480 |
uuid | AN(250) | UUID пристрою | 00002415-0000-1000-8000-00805F9B34FB |