Event types

The Webhooks API sends out events for the following APIs.

• ePayment API events
• Login API events
• QR API events
• Recurring API events

ePayment API event types

We support up to 25 webhook registrations per event per MSN. For more details, see [webhook limits](./api-guide.md##webhook limits).

Name	Event Type
Created	epayments.payment.created.v1
Aborted	epayments.payment.aborted.v1
Expired	epayments.payment.expired.v1
Cancelled	epayments.payment.cancelled.v1
Captured	epayments.payment.captured.v1
Refunded	epayments.payment.refunded.v1
Authorized	epayments.payment.authorized.v1
Terminated	epayments.payment.terminated.v1

The payload format is:

msn required	string (MSNType) [ 4 .. 7 ] characters ^[0-9]{4,7}$ The merchant serial number (MSN) for the sales unit.
reference required	string (ReferenceType) [ 8 .. 64 ] characters ^[a-zA-Z0-9-]{8,64}$ The reference is the unique identifier for the payment, specified when initiating the payment. The reference must be unique for the sales unit (MSN), but is not globally unique, so several MSNs may use the same reference. See the recommendations.
pspReference required	string (PspReference) Each payment operation (i.e., create, capture, refund, cancel) will have a unique pspReference, defined by Vipps MobilePay. One of: The Get event log response contains each event and its unique pspReference value. The Get payment response contains the pspReference for the payment creation event. The Adjustment response, returned by Cancel, Capture, and Refund requests, contains the pspReference for the payment creation event.
name required	string (PaymentEventName) Enum: "CREATED" "ABORTED" "EXPIRED" "CANCELLED" "CAPTURED" "REFUNDED" "AUTHORIZED" "TERMINATED"
required	object (Amount) Amount object, containing a value and a currency.
timestamp required	string <date-time>
idempotencyKey	string or null The Idempotency key of the request.
success required	boolean The outcome of this payment operation: true means that the operation was successful.

{

• "msn": "1234567",
• "reference": "acme-shop-123-order123abc",
• "pspReference": "3343121302",
• "name": "AUTHORIZED",
• "amount": {

  • "currency": "NOK",
  • "value": 49900

  },
• "timestamp": "2024-12-31T00:00:00Z",
• "idempotencyKey": "string",
• "success": true

}

For more details, see ePayment Webhooks.

Login API event types

We support up to 25 webhook registrations per event per MSN.

Name	Event Type
Ping	login.merchant-initiated.ping.v1

The payload will contain:

Name	Type	Description
auth_req_id	String	The auth_req_id that identifies the login.

For more details, see Login Webhooks.

QR API event types

We support up to one webhook registration per event per MSN. For more about these limits, see [webhook limits](./api-guide.md##webhook limits).

Name	Event Type
CheckedIn	user.checked-in.v1

The payload format is:

Name	Type	Description
customerToken	Base64 string	A reference to the customer. Should be used when initiating a payment through the ePayment API. Token is valid for 15 minutes.
merchantQrId	string	The ID of the QR code that has been scanned which is defined by the merchant when the QR was created.
msn	string	Merchant serial number. A unique ID of the sales unit to which the scanned QR belongs.
initiatedAt	UTC Timestamp in ISO 8601 format	The timestamp of when the customer scanned the QR.

For more details, see QR Webhooks.

Recurring API event types

We support up to 25 webhook registrations per event type per MSN. For more about these limits, see [webhook limits](./api-guide.md##webhook limits).

Agreement webhook event types

Name	Event Type
Agreement accepted	recurring.agreement-activated.v1
Agreement rejected	recurring.agreement-rejected.v1
Agreement stopped	recurring.agreement-stopped.v1
Agreement expired	recurring.agreement-expired.v1

Payload properties may include:

Field name	Type	Description	Possible values
agreementId	string	ID of an agreement	agr_kFW4chk
agreementUUID	UUID	ID of an agreement	82ce990f-d08a-448c-bd26-ee6be8418d06
agreementExternalId	nullable string	Merchant provided external ID of agreement	ExtId123
eventType	enum	Indicates what has happened to an agreement	Values provided in a table above
occurred	ISO 8601 UTC date	When change has occurred	2023-10-10T13:30:36.0690000Z
actor	nullable enum	Indicates who has initiated action. Applicable only for recurring.agreement-stopped.v1 webhook.	MERCHANT, USER, ADMIN
msn	string	Merchant Serial Number (MSN)	119145

Charge webhook event types

Name	Event Type
Charge reserved	recurring.charge-reserved.v1
Charge captured	recurring.charge-captured.v1
Charge cancelled	recurring.charge-canceled.v1
Charge refunded	recurring.charge-refunded.v1
Charge failed	recurring.charge-failed.v1
Charge failed on creation	recurring.charge-creation-failed.v1

Payload properties may include:

Field name	Type	Description	Possible values
agreementId	string	ID of an agreement	agr_kFW4chk
chargeExternalId	nullable string	Merchant provided external ID of charge	ExtId123
chargeId	string	ID of a charge	82ce990f-d08a-448c-bd26-ee6be8418d06
amount	number	Amount of charge in øre (NOK, DKK) or cents (EUR)	300
chargeType	enum	Indicates type of charge	RECURRING, INITIAL, UNSCHEDULED
eventType	enum	Indicates what has happened to a charge	Values provided in a table above
currency	enum	Currency of charge	DKK, NOK, EUR
occurred	ISO 8601 UTC date	When change has occurred	2025-05-02T10:36:43.4880000Z
amountCaptured	number	Amount of payment that was captured	100
amountCanceled	number	Amount of charge that was canceled	200
amountRefunded	number	Amount of charge that was refunded	100
failureCode	nullable number	Code of an error during async creation	Listed below
failureText (deprecated)	nullable string	Explanation of an error during async creation	Listed below
failureReason	nullable string	Explanation of an error	Listed below
msn	string	Merchant Serial Number (MSN)	119145

Possible failureCode values with explanation. This field is only present if the charge has failed async validation and was created using the multiple charge creation endpoint: POST:/recurring/v3/agreements/charges.

Failure code	Explanation
50003	Charge is requested for non-active agreement
50004	Trying to create charge with same idempotency key more than once
50005	Charge is requested for agreement that does not exist
50006	Unspecified exception during charge creation
70001	Charge amount is 5 times higher than fixed amount agreement's amount
70003	Trying to create charge of type not allowed by merchant
70004	Due date is too far in the future
70005	Due date is too soon

Possible failureReason values

Failure code	Explanation
user_action_required	The user has to fix something on their agreement, e.g. their payment source
charge_amount_too_high	Charge amount exceeds the users allowed max amount
technical_error	Something went wrong
non_technical_error	E.g. user no longer exist

For more details, see: Recurring Webhooks.