v3 (перехід з 01/09)

Postback після оплати

Схема Postback

{
    "id": "403cd18d-3af9-41443-795ba6cf29d4",
    "status": "holded",
    "paytype": "card",
    "terminal_name": "N3000031",
    "RRN": "123456789101",
    "created_at": "2022-11-17T12:33:50.875+00:00",
    "metadata": {
        "order_id": "17189"
    },
    "client_first_name": "Максим",
    "client_last_name": "Кумедний",
    "client_patronymic": "Максимович",
    "client_phone": "+380501112233",
    "client_ip": "192.10.0.12",
    "processing_result": "Successful",
    "delivery": {
        "recipient_city": "db5c8903-391c-11dd-90d9-001a92567626",
        "recipient_city_description": "м. Золотоноша",
        "recipient_warehouse": "336de19c-e1c2-11e3-8c4a-0050568002cf",
        "recipient_warehouse_description": "Відділення №3 (до 30 кг на одне місце): вул. Обухова, 20",
        "recipient_address": "м. Золотоноша, Відділення №3 (до 30 кг на одне місце): вул. Обухова, 20"
    },
    "card_details": {
        "pan": "123456xxxx1234",
        "card_bank": "JSC CB PRIVATBANK",
        "card_country": "804",
        "card_type": "MC"
    },
    "payments": [
        {
            "external_id": "331-24",
            "amount": 101,
            "products": [
                {
                    "count": 2,
                    "price": 50,
                    "description": "щастя"
                },
                {
                    "count": 1,
                    "price": 1,
                    "description": "радість"
                }
            ]
        },
        {
            "external_id": "331-25",
            "amount": 50,
            "products": [
                {
                    "count": 1,
                    "price": 40,
                    "description": "надія"
                },
                {
                    "count": 1,
                    "price": 10,
                    "description": "свобода"
                }
            ]
        }
    ]
}

Опис параметрів

ПараметрНазва українською
idІдентифікатор сесії.
statusСтатуси сесії описані тут.
paytypeПараметр способу оплати (card, applepay, googlepay).
terminal_nameІдентифікатор платіжного термінала.
RRN(Reference Retrieval Number) — генерується платіжним провайдером (PSP) і використовується для ідентифікації транзакції.
created_atЧас створення платіжної сесії.
metadataДані, що були передані в запиті "Create session".
client_first_nameПараметр, отриманий у запиті "Create session".
client_last_nameПараметр, отриманий у запиті "Create session".
client_patronymicПараметр, отриманий у запиті "Create session".
client_phoneПараметр, отриманий у запиті "Create session".
client_emailПараметр, отриманий у запиті "Create session".
client_ipІР-адреса платника.
processing_resultОпис статусу обробки (процесінгу).
deliveryІнформація про доставку.
recipient_cityІдентифікатор міста отримувача.
recipient_city_descriptionНазва міста отримувача.
recipient_warehouseІдентифікатор відділення отримувача.
recipient_warehouse_descriptionОпис відділення отримувача.
recipient_addressПовна адреса доставки для отримувача.
card_detailsМасив деталей картки.
panМаскований номер платіжної картки.
card_bankНазва банку-емітента картки.
card_countryЧисловий код країни, в якій було видано картку.
card_typeТип платіжної системи картки.
paymentsМасив об'єктів, що містить деталі окремих операцій.
external_idПараметр, отриманий у запиті "Create session".
amountПараметр, отриманий у запиті "Create session".
productsСписок товарів.
countКількість одиниць товару.
priceЦіна за одну одиницю товару.
descriptionТекстовий опис товару.

Postback після створення експрес-накладної

Схема Postback

{
    "id": "403cd18d-3af9-41443-795ba6cf29d4",
    "status": "holded",
    "paytype": "card",
    "terminal_name": "N3000031",
    "RRN": "123456789101",
    "created_at": "2022-11-17T12:33:50.875+00:00",
    "metadata": {
        "order_id": "17189"
    },
    "client_first_name": "Максим",
    "client_last_name": "Кумедний",
    "client_patronymic": "Максимович",
    "client_phone": "+380501112233",
    "client_ip": "192.10.0.12",
    "processing_result": "Successful",
    "delivery": {
        "express_waybills": [
            "20400461297713"
        ],
        "recipient_city": "db5c8903-391c-11dd-90d9-001a92567626",
        "recipient_city_description": "м. Золотоноша",
        "recipient_warehouse": "336de19c-e1c2-11e3-8c4a-0050568002cf",
        "recipient_warehouse_description": "Відділення №3 (до 30 кг на одне місце): вул. Обухова, 20",
        "recipient_address": "м. Золотоноша, Відділення №3 (до 30 кг на одне місце): вул. Обухова, 20"
    },
    "card_details": {
        "pan": "123456xxxx1234",
        "card_bank": "JSC CB PRIVATBANK",
        "card_country": "804",
        "card_type": "MC"
    },
    "payments": [
        {
            "external_id": "331-24",
            "amount": 101,
            "products": [
                {
                    "count": 2,
                    "price": 50,
                    "description": "щастя"
                },
                {
                    "count": 1,
                    "price": 1,
                    "description": "радість"
                }
            ]
        },
        {
            "external_id": "331-25",
            "amount": 50,
            "products": [
                {
                    "count": 1,
                    "price": 40,
                    "description": "надія"
                },
                {
                    "count": 1,
                    "price": 10,
                    "description": "свобода"
                }
            ]
        }
    ]
}

Опис параметрів

ПараметрНазва українською
idІдентифікатор сесії.
statusСтатуси сесії описані тут.
paytypeПараметр способу оплати (card, applepay, googlepay).
terminal_nameІдентифікатор платіжного термінала.
RRN(Reference Retrieval Number) — генерується платіжним провайдером (PSP) і використовується для ідентифікації транзакції.
created_atЧас створення платіжної сесії.
metadataДані, що були передані в запиті "Create session".
client_first_nameПараметр, отриманий у запиті "Create session".
client_last_nameПараметр, отриманий у запиті "Create session".
client_patronymicПараметр, отриманий у запиті "Create session".
client_phoneПараметр, отриманий у запиті "Create session".
client_emailПараметр, отриманий у запиті "Create session".
client_ipІР-адреса платника.
processing_resultОпис статусу обробки (процесінгу).
deliveryІнформація про доставку.
express_waybillsСписок номерів експрес-накладних.
recipient_cityІдентифікатор міста отримувача.
recipient_city_descriptionНазва міста отримувача.
recipient_warehouseІдентифікатор відділення отримувача.
recipient_warehouse_descriptionОпис відділення отримувача.
recipient_addressПовна адреса доставки для отримувача.
card_detailsМасив деталей картки.
panМаскований номер платіжної картки.
card_bankНазва банку-емітента картки.
card_countryЧисловий код країни, в якій було видано картку.
card_typeТип платіжної системи картки.
paymentsМасив об'єктів, що містить деталі окремих операцій.
external_idПараметр, отриманий у запиті "Create session".
amountПараметр, отриманий у запиті "Create session".
productsСписок товарів.
countКількість одиниць товару.
priceЦіна за одну одиницю товару.
descriptionТекстовий опис товару.

Postback після невдалого створення експрес-накладної

Схема Postback

{
  "id": "403cd18d-3af9-41443-795ba6cf29d4",
  "status": "holded",
  "paytype": "card",
  "terminal_name": "N3000031",
  "RRN": "123456789101",
  "created_at": "2022-11-17T12:33:50.875+00:00",
  "metadata": {
    "lol": "kek",
    "marketing_block_en": "Get bonus with visa card!",
    "marketing_block_uk": "Оплачуй карткою Visa та отримуй бонус!Оплачуй карткою Visa та отримуй бонус!"
  },
  "client_first_name": "Максим",
  "client_last_name": "Кумедний",
  "client_patronymic": "Максимович",
  "client_phone": "+380501112233",
  "client_ip": "192.10.0.12",
  "processing_result": "Successful",
  "delivery": {
    "ew_fail_reason": [
      "Warehouse with this Ref is not exist"
    ],
    "recipient_city": "526b41b7-f344-48ad-becf-17544ff460e5",
    "recipient_warehouse": "526b41b7-f344-48ad-becf-17544ff460e6",
    "recipient_phone": "+380222222222",
    "recipient_last_name": "Андрієнко",
    "recipient_first_name": "Андрій",
    "recipient_patronymic": "Андрійович"
  },
  "card_details": {
    "pan": "123456xxxx1234",
    "card_bank": "JSC CB PRIVATBANK",
    "card_country": "804",
    "card_type": "MC"
  },
  "payments": [
    {
      "external_id": "331-24",
      "amount": 101,
      "products": [
        {
          "count": 2,
          "price": 50,
          "description": "щастя"
        },
        {
          "count": 1,
          "price": 1,
          "description": "радість"
        }
      ]
    },
    {
      "external_id": "331-25",
      "amount": 50,
      "products": [
        {
          "count": 1,
          "price": 40,
          "description": "надія"
        },
        {
          "count": 1,
          "price": 10,
          "description": "свобода"
        }
      ]
    }
  ]
}

Опис параметрів

ПараметрНазва українською
idІдентифікатор сесії.
statusСтатуси сесії описані тут.
paytypeПараметр способу оплати (card, applepay, googlepay).
terminal_nameІдентифікатор платіжного термінала.
RRN(Reference Retrieval Number) — генерується платіжним провайдером (PSP) і використовується для ідентифікації транзакції.
created_atЧас створення платіжної сесії.
metadataДані, що були передані в запиті "Create session".
client_first_nameПараметр, отриманий у запиті "Create session".
client_last_nameПараметр, отриманий у запиті "Create session".
client_patronymicПараметр, отриманий у запиті "Create session".
client_phoneПараметр, отриманий у запиті "Create session".
client_emailПараметр, отриманий у запиті "Create session".
client_ipІР-адреса платника.
processing_resultОпис статусу обробки (процесінгу).
deliveryІнформація про доставку.
ew_fail_reasonСписок можливих причин відмови створення ЕН.
recipient_cityІдентифікатор міста отримувача.
recipient_warehouseІдентифікатор відділення отримувача.
recipient_phoneТелефон отримувача.
recipient_last_nameПрізвище отримувача.
recipient_first_nameІм’я отримувача.
recipient_patronymicПо-батькові отримувача.
card_detailsМасив деталей картки.
panМаскований номер платіжної картки.
card_bankНазва банку-емітента картки.
card_countryЧисловий код країни, в якій було видано картку.
card_typeТип платіжної системи картки.
paymentsМасив об'єктів, що містить деталі окремих операцій.
external_idПараметр, отриманий у запиті "Create session".
amountПараметр, отриманий у запиті "Create session".
productsСписок товарів.
countКількість одиниць товару.
priceЦіна за одну одиницю товару.
descriptionТекстовий опис товару.