Payments
Integrate Volume SDK
React Web
Events

Volume Events

Events from Payment initiated to Bank Launched Loaded are emitted only in the mobile version of the component. In the desktop (QR code) version, see PaymentId Generated and the QR code events below.

Payment initiated

'PAYMENT_INITIATED'

A specific institution has been selected by the user by clicking on its icon or by payWithInstitution(institutionId) function.

️⚠️

Kindly ensure that the merchantPaymentId is regenerated immediately upon triggering this event.

Generic Error

'GENERIC_ERROR'

Is triggered when an unknown error happens.

Confirm Page Loaded

'CONFIRM_PAGE_LOADED'

Is triggered when the page with the Confirm Button is displayed.

Bank Selection Loaded

'BANK_SELECTION_LOADED'

Is triggered when the page with bank icon selection list is displayed.

Awaiting Authorisation

'AWAITING_AUTHORISATION'

Is triggered when the user clicks the confirm button.

Bank Launched Loaded

'BANK_LAUNCHED_LOADED'

Is triggered when the final page with the final confirmation label is displayed. After user clicked the Confirm Button.

PaymentId Generated

'PAYMENT_ID_GENERATED'

Valid only in desktop version. When component is rendered in the desktop version, event is triggered as soon as the payment id is generated.

Payment initiated (QR code)

'PAYMENT_INITIATED_QR'

Valid only in desktop version. Is triggered when the payer has picked a bank on their phone and the payment is awaiting authorisation, authorised or pending.

Payment completed (QR code)

'PAYMENT_COMPLETED_QR'

Valid only in desktop version. Is triggered when the payment is completed.

Payment failed (QR code)

'PAYMENT_FAILED_QR'

Valid only in desktop version. Is triggered when the payment failed.

QR code events come from payment status polling (every 4 seconds). They are not emitted when disablePaymentStatusPooling is set, or for country="DE". If the payment completes or fails between two polls, PAYMENT_INITIATED_QR is not emitted. Do not rely on it to come before PAYMENT_COMPLETED_QR or PAYMENT_FAILED_QR.