API
Direct Merchant Notifications
Server-to-server notifications delivered to your notification URL. Respond 2xx quickly and process asynchronously.
Use these events to keep your own system in sync with the final outcome of a pay-in, a tokenization or a payout, instead of polling status endpoints. Each event lists the payload fields it delivers and the acknowledgement slikair expects from your endpoint.
Endpoints on this page
| Event | Summary | Acknowledgement |
|---|---|---|
| v2_payin_notification | PayIn Notification (DMN) | 200 acknowledges receipt |
| v2_tokenization_notification | Tokenization Result Notification | 200 acknowledges receipt |
| v2_payout_notification | Payout notification | 200 acknowledges receipt |
API
Notification events
v2_payin_notificationPayIn Notification (DMN)
Server-to-server notification with the final pay-in result.
Notification payload fields
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| status | optional | enum | processing | succeeded | failed | refunded | chargeback | |
| status_code | optional | integer | ||
| reason_code | optional | string | ||
| payin_id | optional | uuid | ||
| merchant_reference | optional | string | ||
| payment_method | optional | string | ||
| amount | optional | number | ||
| currency | optional | string | ||
| decline_reason | optional | string |
Acknowledgement: 200 acknowledges receipt
v2_tokenization_notificationTokenization Result Notification
Delivered to tokenization_notification_url with the vaulted token and card metadata.
Notification payload fields
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| payin_id | required | uuid | ||
| request_id | required | string | ||
| status_code | required | integer | ||
| token | optional | string | Vaulted card token. | |
| brand | optional | string | ||
| last4 | optional | string | ||
| expDate | optional | string | ||
| error_message | optional | string |
Acknowledgement: 200 acknowledges receipt
v2_payout_notificationPayout notification
Server-to-server notification with the payout result.
Notification payload fields
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| status | optional | enum | initiated | processing | succeeded | failed | |
| reason | optional | string | ||
| payoutId | optional | string | ||
| merchantReference | optional | string | ||
| amount | optional | number | ||
| currency | optional | string | ||
| statusCode | optional | string | ||
| reasonCode | optional | string |
Acknowledgement: 200 acknowledges receipt