Test your payment integration

Before you start accepting payments, test your Rocka integration to make sure everything’s working as intended.

Test your integration

Make a test API call

Go to your Rocka Hub > Integration. You’ll find your test API key under Test credentials.
To verify your site is connected to Rocka, make a test API call with your sandbox key. For example, you can try the Get the list of top banks endpoint.

Create your first payment in sandbox mode

Try creating your first payment with your test API key using the POST /api/payments endpoint.The response will include the url parameter, which is the payment link:

Sample response

{
  "id": "d620b186-f3fd-41cf-afa2-35d290002c87",
  "url": "https://stage.checkout.rocka.live/?id=d620b186-f3fd-41cf-afa2-35d290002c87&country=EU&info_isNew=true",
  "qrCode": null,
  "token": "v4.local.nfh1xPxnY6ekBQYmMaEOF7_sivOdy6WPrXW1eZJGVEeIiL8BXZep_P7lJS02KAjRqOWVabXvebTK8hVccovmxQ6SFLttc80lPvEjN2hvOgjAx20bJxQD07I5gp8X-EHoiIrit4ANEEvSM5iYOhnkobrB6yLC-tD8YQO8K_pCmOTyTPjx261JwZ5BNLoB_Klg27nPRRpJE400_9VQIbWR95s4dnH2NM2NRFJQ83LZCDJ07gTimjEHkpfDYXrU1F7-9Jb9JhylqETRTevCwOlWBUex-agzobgMLxG4dNU6frGM6uMI0RpKZcYjbWcp5lwdqiLhtBJ4ZTPicDDm0tNh_JCA5UbXyxx1GxPe76Eh1RYHhP3S-BOJ-yk1EI0eHkC0bPQw-IMQ_AHohhZR2-Qu8nk2lQ",
  "threeDsData": null,
  "status": "New"
}

Place the test payment

To make a test payment, follow the steps below. This payment flow will be the same for your customers.

Open the link in the url parameter. If you’re located in one of the supported locales, Rocka will automatically detect your country and offer local banks. You can also change the country using the dropdown list in the top-right.

For most locales, you will be prompted for a local IBAN. You can use one of the test IBANs provided below. Once you enter the IBAN, click Proceed to payment → Go to bank.

Test IBANs for each country

Country	Test IBAN
Austria	`AT442060462969882667`
Belgium	`BE86548395218350`
Bulgaria	`BG11UNCR70002357555869`
Czechia	`CZ3950512253883481546422`
Denmark	`DK0350517819194565`
Estonia	`EE241288345534195171`
Finland	`FI6096556523142496`
France	`FR2017569000305334518641U14`
Germany	`DE28500105175177352381`
Greece	`GR8001017482782598767712723`
Hungary	`HU47109180019139163433933895`
Ireland	`IE13BOFI900017196892`
Italy	`IT41G0300203280631633853611`
Latvia	`LV47BFTO78HL1E44S557U`
Lithuania	`LT531333837574574518`
Luxembourg	`LU970101299639351982`
Netherlands	`NL06RABO3605998615`
Norway	`NO4643439454116`
Poland	`PL92109024024223477881477127`
Portugal	`PT36003506517684676992475`
Romania	`RO48PORL2287771354415982`
Slovakia	`SK8937262781847381589252`
Slovenia	`SI37131411574212932`
Spain	`ES6221001524961942163622`
Sweden	`SE6131639725357863517336`

For some banks, you can also ignore the prompt and click Don’t remember your IBAN? at the bottom of the form. Next, click Connect to your bank account → Go to Bank Europe, which will send you directly to the test bank website.

On the test bank login form, you can enter these usernames to trigger a specific payment status. Once you enter the username, click Continue → Yes, I agree.

Username	Payment status
`done`	Done. You will also receive callbacks from the sender and recipient banks.
`failed`	Failed. You will receive a callback from the sender bank.
`processing`	Awaiting confirmation. You will not receive any callbacks.

Select any of the test bank accounts. Click Go to bank and log in to the test bank website again. For real payments, your customers will be redirected to their bank app to confirm the payment on this step.

Process the callback

Once the payment goes through, you will receive a callback to the webhookUrl you specified in your request. You will also see the payment in the Transactions section in your Rocka Hub.To see other callbacks you can potentially receive for other payment statuses, see Callbacks.

{
 "PaymentId":"bc973098-3dfb-4700-af20-28ca4fdb583a",
 "Status":"Done",
 "Signature":"b2e286bfc7b94ab2342342341881c85b50f286b23462436432d7dfc5fcd05ca2r234r231",
 "MerchantPaymentId":"12345678-1234-1234-1234-12345678910",
 "Reference":"12345678 PAYMENT",
 "Amount":50.0,
 "Currency":"EUR",
 "CardId":null,
 "Remitter":{
    "Name":"User Testing",
    "Iban":"TT123456789HFE112345",
    "SortCode":null,
    "AccountNumber":null
 },
 "AdditionalData":null,
 "DetailedInfo":null,
 "Method":"open-banking",
 "BankId":"sparkasse_de",
 "IsSenderBank":false,
 "BankTransactionId":"BANKTRANSACTIONID",
 "Settled":"Yes",
 "SettlementDate":"2024-10-01T07:18:56.316302Z"
}

Quickstart

Integrate with Rocka

Webhooks

Your account details

Your bank accounts

Open banking payments

Payouts

Reports and reconciliation

Refunds

Account settings

Test your payment integration

Test your integration

​Test your integration

Test your integration