Introduction

Set Session Webhook URL

Configures or updates the v3 session webhook URL for the merchant.

Uses the same shared signing secret as the order webhook — generate it via /v2/client/webhook-v3/secret/generate if you haven't already.

The following session events will be sent to the configured URL:

order_created — an order was created from the session
session_expired — the session has expired
session_active — the session has become active
failed — the session has failed
cancelled — the session has been cancelled

Note: Webhooks fire only on status changes. Creating a new session does not emit a webhook.

Body Parameters

billinkUsernamestring Required

The merchant's Billink username.

billinkIDstring Required

The merchant's Billink ID (SHA-1 hash).

urlstring Required

The HTTPS URL where webhook events will be delivered.

Response

200

Object

Webhook has been set

Response Attributes

statusstring

Operation result status.

Enum values:

success

messagestring

Human-readable success message.

400

Object

billinkUsername parameter missing|billinkID parameter missing|url parameter is empty|Invalid url parameter|Webhook signing secret is not set. Please, generate the secret first

Response Attributes

statusstring

Operation result status.

Enum values:

error

messagestring

Human-readable error description.

404

Object

Client not found

Response Attributes

statusstring

Operation result status.

Enum values:

error

messagestring

Human-readable error description.

500

Object

Could not set session webhook|Could not set webhook

Response Attributes

statusstring

Operation result status.

Enum values:

error

messagestring

Human-readable error description.

Sections

Set Session Webhook URL

Body Parameters

Response

Response Attributes

Response Attributes

Response Attributes

Response Attributes

What made this section helpful for you?

What made this section unhelpful for you?

Response

What made this section helpful for you?

What made this section unhelpful for you?