Postback after payment

Postback schema

{
    "id": "f1c86ec3-45ff-4bde-a428-37f49bcde530",
    "status": "paid",
    "paytype": "cash_on_delivery",
    "created_at": "2025-03-10T15:56:29.169+02: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": "+380111111111",
    "external_id": null,
    "amount": 53,
    "delivery": {
        "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": "Андрійович"
    },
    "products": [
        {
            "count": 1,
            "image": "https://i.pinimg.com/736x/a3/b9/ca/a3b9cab8583db63b6eadcd7e9746cba6.jpg",
            "price": 17,
            "description": "Заліпуха"
        },
        {
            "count": 2,
            "image": "https://i.pinimg.com/736x/68/e5/24/68e52437158ced28ada0afc77582eb3f.jpg",
            "price": 18,
            "description": "Плащ-пальто"
        }
    ]
}

Parameter values

Code	Required	Description
id	Yes	Unique session identifier.
status	Yes	Payment status are described here (e.g., `paid`, `holded`, etc.).
paytype	Yes	Payment method (`cash_on_delivery`, `card`, `applepay`, etc.).
created_at	Yes	Transaction timestamp in ISO8601 format.
metadata	No	Additional session metadata.
client_first_name	Yes	Client's first name.
client_last_name	Yes	Client's last name.
client_patronymic	No	Client's middle name.
client_phone	Yes	Client's phone number.
external_id	No	External order identifier.
amount	Yes	Order amount.
delivery	Yes	Delivery information object.
recipient_city	Yes	Recipient's city identifier.
recipient_warehouse	Yes	Recipient's warehouse identifier.
recipient_phone	Yes	Recipient's phone number.
recipient_last_name	Yes	Recipient's last name.
recipient_first_name	Yes	Recipient's first name.
recipient_patronymic	No	Recipient's middle name.
products	Yes (if products exist)	List of ordered products.
count	Yes (if products exist)	Quantity of product units.
image	No	URL of the product image.
price	Yes (if products exist)	Price per unit of product.
description	Yes (if products exist)	Product description.

Postback after creating the express waybill

Postback schema

{
    "id": "f1c86ec3-45ff-4bde-a428-37f49bcde530",
    "status": "paid",
    "paytype": "cash_on_delivery",
    "created_at": "2025-03-10T15:56:29.169+02: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": "+380111111111",
    "external_id": null,
    "amount": 53,
    "delivery": {
        "express_waybills": [
            "200013123123"
        ],
        "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": "Андрійович"
    },
    "products": [
        {
            "count": 1,
            "image": "https://i.pinimg.com/736x/a3/b9/ca/a3b9cab8583db63b6eadcd7e9746cba6.jpg",
            "price": 17,
            "description": "Заліпуха"
        },
        {
            "count": 2,
            "image": "https://i.pinimg.com/736x/68/e5/24/68e52437158ced28ada0afc77582eb3f.jpg",
            "price": 18,
            "description": "Плащ-пальто"
        }
    ]
}

Parameter values

Code	Required	Description
id	Yes	Unique session identifier.
status	Yes	Payment status are described here (e.g., `paid`, `holded`, etc.).
paytype	Yes	Payment method (`cash_on_delivery`, `card`, `applepay`, etc.).
created_at	Yes	Transaction timestamp in ISO8601 format.
metadata	No	Additional session metadata (e.g., marketing messages).
client_first_name	Yes	Client's first name.
client_last_name	Yes	Client's last name.
client_patronymic	No	Client's middle name.
client_phone	Yes	Client's phone number.
external_id	No	External order identifier.
amount	Yes	Order amount.
delivery	Yes	Delivery information object.
express_waybills	Yes	List of express waybill identifiers.
recipient_city	Yes	Recipient's city identifier.
recipient_warehouse	Yes	Recipient's warehouse identifier.
recipient_phone	Yes	Recipient's phone number.
recipient_last_name	Yes	Recipient's last name.
recipient_first_name	Yes	Recipient's first name.
recipient_patronymic	No	Recipient's middle name.
products	Yes (if products exist)	List of ordered products.
count	Yes (if products exist)	Quantity of product units.
image	No	URL of the product image.
price	Yes (if products exist)	Price per unit of product.
description	Yes (if products exist)	Product description.

Postback for failed express waybill creation

Postback schema

{
    "id": "a975af0f-4ef1-459e-8ff6-ad884ca768f6",
    "status": "paid",
    "paytype": "cash_on_delivery",
    "created_at": "2025-03-12T19:00:25.468+02:00",
    "metadata": {
        "lol": "kek",
        "marketing_block_en": "Get bonus with visa card!",
        "marketing_block_uk": "Оплачуй карткою Visa та отримуй бонус!Оплачуй карткою Visa та отримуй бонус!",
        "ew_fail_reason": [
            "Warehouse with this Ref is not exist",
            "Empty RecipientAddressName or ServiceType should be to Doors",
            "Counterparty creation problem. RecipientName incorrect",
            "Recipient counterparty person creation problem.",
            "RecipientsPhone invalid format",
            "AfterpaymentOnGoodsCost is unavailable"
        ]
    },
    "client_first_name": "Іван",
    "client_last_name": "Іваненко",
    "client_patronymic": "Іванович",
    "client_phone": "+380111111111",
    "external_id": null,
    "amount": 53,
    "delivery": {
        "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": "Андрійович"
    },
    "products": [
        {
            "count": 1,
            "image": "https://i.pinimg.com/736x/a3/b9/ca/a3b9cab8583db63b6eadcd7e9746cba6.jpg",
            "price": 17,
            "description": "Заліпуха"
        },
        {
            "count": 2,
            "image": "https://i.pinimg.com/736x/68/e5/24/68e52437158ced28ada0afc77582eb3f.jpg",
            "price": 18,
            "description": "Плащ-пальто"
        }
    ]
}

Parameter values

Parameter	Required	Description
id	Yes	Unique session identifier.
status	Yes	Payment status (paid, holded, etc.).
paytype	Yes	Payment method (cash_on_delivery, card, applepay, etc.).
created_at	Yes	Date and time of transaction creation.
metadata	No	Additional session metadata.
lol	No	Additional value.
marketing_block_en	No	Marketing block in English.
marketing_block_uk	No	Marketing block in Ukrainian.
ew_fail_reason	No	List of possible delivery failure reasons.
client_first_name	Yes	Client's first name.
client_last_name	Yes	Client's last name.
client_patronymic	No	Client's patronymic (middle name).
client_phone	Yes	Client's phone number.
external_id	No	External order identifier.
amount	Yes	Order amount.
delivery	Yes	Delivery information.
recipient_city	Yes	Recipient's city identifier.
recipient_warehouse	Yes	Recipient's warehouse identifier.
recipient_phone	Yes	Recipient's phone number.
recipient_last_name	Yes	Recipient's last name.
recipient_first_name	Yes	Recipient's first name.
recipient_patronymic	No	Recipient's patronymic (middle name).
products	Yes	List of products in the order.
count	Yes (if products exist)	Quantity of product units.
image	No	Product image URL.
price	Yes (if products exist)	Price per unit of product.
description	Yes (if products exist)	Product description.