Skip to main content
POST
/
api
/
payments
/
logo
Display customised payment buttons
curl --request POST \
  --url https://api.stage.rocka.live/api/payments/logo \
  --header 'Content-Type: application/*+json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "currency": "EUR",
  "country": "DE"
}
'
{
  "Example: DE": {
    "value": {
      "url": "https://rocka.blob.core.windows.net/logo-button/de.svg",
      "type": "country",
      "id": "de",
      "displayName": "GERMANY"
    }
  }
}

Authorizations

​
x-api-key
string
header
required

To get your own API keys, go to the Integration tab in your Rocka Hub. Use your test (not live) credentials to make API requests from this form.

Body

application/*+json
​
currency
string
required

Payment currency. Currently accepted: EUR.

​
customerId
string

Customer's unique identifier in your records.

​
email
string

Customer's email address.

​
ipAddress
string

Customer's IP address.

​
country
string

Customer's country's ISO 3166 code. For example, DE for Germany or FR for France.

Response

200 - application/json

Button appearance configuration.

​
type
enum<string>
required

Button type (bank or country).

Available options:
bank,
country
​
url
string

URL to the SVG logo that will be part of the button.

​
id
string

Payment option choice. For example, country code or bank ID.

​
displayName
string

Alternative display name for the payment option. For example, United Kingdom or Lloyds Bank.

​
country
string

Country's ISO 3166 code (only for bank buttons).

Last modified on June 22, 2026