Skip to main content
You can change the appearance of your payment buttons and tailor them to your customer’s country or preferred bank.

​
Regional buttons

This endpoint displays a button based on the customer’s currency. It requires the customer’s currency code, such as EUR for the euro or GBP for the British pound.
Request
 curl --request POST \
--url https://api.stage.rocka.live/api/payments/logo \
--header 'Accept: application/json, text/json, text/plain' \
--header 'Content-Type: application/*+json' \
--header 'x-api-key: 24d0034-5a83-47d5-afa0-cca47298c516' \
--data '{
  "currency": "EUR"
}'
Response
 {
  "type": "country",
  "id": "eu",
  "displayName": "EUROPEAN UNION",
  "url": "https://rockastore.azureedge.net/logo-button/eu.svg"
}
ResultEU payment button logoEU payment button

​
Country buttons

You need to include two parameters in your request, currency and country. This returns the button tailored to the customer’s country.
Request
 curl --request POST \
--url https://api.stage.rocka.live/api/payments/logo \
--header 'Accept: application/json, text/json, text/plain' \
--header 'Content-Type: application/*+json' \
--header 'x-api-key: 24d0034-5a83-47d5-afa0-cca47298c516' \
--data '{
"currency": "EUR",
"country": "DE"
}'
Response
 {
    "type": "country",
    "id": "de",
    "displayName": "Germany",
    "url": "https://rockastore.azureedge.net/logo-button/de.svg"
}
ResultGermany payment buttonGermany payment button
Request
curl --request POST \
--url https://api.stage.rocka.live/api/payments/logo \
--header 'Accept: application/json, text/json, text/plain' \
--header 'Content-Type: application/*+json' \
--header 'x-api-key: 24d0034-5a83-47d5-afa0-cca47298c516' \
--data '{
"currency": "EUR",
"country": "NL"
}'
Response
 {
"type": "country",
"id": "nl",
"displayName": "Netherlands",
"url": "https://rockastore.azureedge.net/logo-button/nl.svg"
}
ResultThe Netherlands payment buttonThe Netherlands payment button

​
Bank buttons

You need to pass the currency and either of the customer’s email address orcustomerId(or both). This checks the customer’s past transaction history and displays a payment button with their bank’s logo.
Request
 curl --request POST \
--url https://api.stage.rocka.live/api/payments/logo \
--header 'Accept: application/json, text/json, text/plain' \
--header 'Content-Type: application/*+json' \
--header 'x-api-key: 24d0034-5a83-47d5-afa0-cca47298c516' \
--data '{
"currency": "EUR",
"customerId": "test_customer_id"
}'
Response
 {
"country": "nl",
"type": "bank",
"id": "abn_amro_group_nl",
"displayName": "ABN AMRO",
"url": "https://rockastore.azureedge.net/logo-button/abn_amro_group_nl.svg"
}
ResultABN Amro payment buttonABN Amro payment button
Request
 curl --request POST \
--url https://api.stage.rocka.live/api/payments/logo \
--header 'Accept: application/json, text/json, text/plain' \
--header 'Content-Type: application/*+json' \
--header 'x-api-key: 24d0034-5a83-47d5-afa0-cca47298c516' \
--data '{
"currency": "EUR",
"email": "test@example.com"
}'
Response
 {
"country": "nl",
"type": "bank",
"id": "ing_nl",
"displayName": "ING",
"url": "https://rockastore.azureedge.net/logo-button/ing_nl.svg"
}
ResultING payment buttonING payment button
Request
curl --request POST \
--url https://api.stage.rocka.live/api/payments/logo \
--header 'Accept: application/json, text/json, text/plain' \
--header 'Content-Type: application/*+json' \
--header 'x-api-key: 24d0034-5a83-47d5-afa0-cca47298c516' \
--data '{
"currency": "EUR",
"email": "test@example.com",
"customerId": "test_customer_id"
}'
Response
 {
"country": "nl",
"type": "bank",
"id": "ing_nl",
"displayName": "ING",
"url": "https://rockastore.azureedge.net/logo-button/ing_nl.svg"
}
ResultING payment buttonING payment button