Skip to main content
Start Desktop
Rocka’s hosted checkout page lists all banks supported by Rocka in every locale. Once your customer chooses their country and payment method, they will be able to place a payment directly through their bank app.

​
Set up hosted checkout

1

Step 1

Complete your onboarding in Rocka Hub and get your API key. For more details, see Get your API key and Authorisation.
2

Step 2

Use the POST /payments endpoint to create a payment. At the very least, you will need to include these parameters:
  • payment amount and currency
  • returnUrl, which is the address your customer will be redirected to once they complete the payment.
  • paymentId, which is the payment’s unique identifier in your system. This will only be visible to you. Rocka will return this paymentId in every callback.
  • description, which is a short payment description your customer will see. 
You can include other optional parameters to personalise the payment experience for your customer. For more details, see POST Create a payment.
3

Step 3

POST /payments returns the payment’s ID and payment URL. We recommend that you direct the customer to the payment URL. This can be either in the same tab or a new tab. Once the customer completes the payment, they will be redirected to the returnUrl you specified.You can also embed the payment URL as an iFrame for on-page checkout. If you choose this option, make sure the iFrame embed’s size allows the customer to comfortably use their bank’s web interface.

​
What your customer will see

The hosted checkout page displays a selection of banks available in the customer’s country. If you include the customer’s ipAddress in your request, their country will be preselected on the payment page and they will see their local banks straight away. If you don’t, Rocka will get the customer’s IP address and suggest the country automatically.
Overview Payment
Once the customer chooses their bank, they will be either asked for their IBAN or prompted to scan a QR code to confirm the payment in their bank app. This depends on their bank and locale. If you provide the providerIdparameter, the bank will be preselected for your customer, but they will still need to enter their IBAN or scan the bank QR code. If you provide theiribanin the request, they will be redirected straight to their bank app, skipping Rocka’s hosted checkout page. For more information, see Integrate direct bank payments.
enter-iban

IBAN prompt step

Most banks will need your customer’s IBAN to process the payment. If your customer can’t find it, they’ll be able to simply log in with their bank through the mobile app or the web version
scan-qr

QR scan step

Some payment methods and banks will generate QR codes your customer can scan to complete the payment in the mobile app. They can also log in to the web version
Last modified on June 12, 2026