Skip to content

Webhooks

Receive payment result notifications via Webhooks

The Smart Collect API enables asynchronous event notifications through Webhooks, allowing your system to automatically receive the final result of a payment for hosted integration types, without the need for continuous polling.

Basic Webhook

Sends only the payId, allowing your system to fetch full payment details afterward.

Enhanced Webhook

Sends the complete payment information directly within the webhook payload.

For information on securing webhook communication, see the Security & verification section in the documentation.

Enhanced Webhook
Webhook

Request

The Enhanced Webhook includes detailed transaction data in the payload and is signed with an HMAC signature to ensure authenticity and integrity.

Bodyapplication/jsonrequired
payIdstringrequired

A unique identifier assigned by Smart Collect to the payment.

transIdstringrequired

Transaction ID created in your system; should be unique per payment.

refNrstring

Your reference number for the specific operation; used for reconciliation.

statusstringrequired

Status of the transaction.

responseCodestringrequired

Response code of the transaction.

responseDescriptionstringrequired

Response description associated with the response code.

amountobject(requestEnhancedWebhooksAmount)required
paymentMethodsArray of objects(enhancedWebhookPaymentMethod)required

Selected payment method(s).

creationDatestring, (date-time)required

Date and time when the order was created.

Payload
{ "payId": "78f5adccfe8640e5a549613389ff33we", "transId": "txn_7890", "refNr": "45687", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "amount": { "value": 10000, "currency": "EUR" }, "paymentMethods": [ { … } ], "creationDate": "2025-09-23T13:20:30Z" }

Responses

Successfully received and processed by merchant system