Check your key configuration

Check the configuration of your Unzer API keys.

About Unzer API keys

After you sign your Unzer contract, you get four API keys:

  • Your sandbox public key (e.g. s-pub-xxxxxxxxxx)
  • Your sandbox private key (e.g. s-priv-xxxxxxxxxx)
  • Your production public key (e.g. p-pub-xxxxxxxxxx)
  • Your production private key (e.g. p-priv-xxxxxxxxxx)

For more information on the Unzer API authentication rules, go to: Authentication.

To find out which features require a public key and which features require a private key, go to: Authentication reference.

Check your key configuration

You have two ways of checking your API key configuration:

  • To quickly look up your key configuration, make a GET call to /keypair.
  • To get a detailed view of your key configuration, make a GET call to /keypair/types.
Keep your private key safe

Never make your private key accessible on the web.

If your private key has been compromised, contact us to change it.

Look up your key configuration

To quickly look up your public key and all of your configured payment methods, make a GET call to /keypair, with your private key in the request body:

curl https://api.unzer.com/v1/keypair \
  -u s-priv-xxxxxxxxxx:
{
  "publicKey" : "s-pub-xxxxxxxxxx",
  "privateKey" : "3b04ee56d6ba0c68562deea645032d180f6007046eaa3efaa19360983b383bb6",
  "availablePaymentTypes" : [ "invoice-secured", "PIS", "sofort", "prepayment", "sepa-direct-debit-secured", "paypal", "EPS", "sepa-direct-debit", "ideal", "invoice", "przelewy24", "card", "giropay" ]
}
Property Type Description
publicKey String Your production public key.
privateKey String Your production private key.
availablePaymentTypes Array All of your configured payment methods.

Check your key configuration details

To get a detailed view of of your API key configuration, make a GET call to /keypair/types, with your private key in the request body:

curl https://api.unzer.com/v1/keypair/types \
  -u s-priv-xxxxxxxxxx:
{
  "publicKey" : "s-pub-2a10ifVINFAjpQJ9qW8jBe5OJPBx6Gxa",
  "privateKey" : "3b04ee56d6ba0c68562deea645032d180f6007046eaa3efaa19360983b383bb6",
  "secureLevel" : "SAQ-D",
  "alias" : "",
  "paymentTypes" : [ {
    "supports" : [ {
      "brands" : [ ],
      "countries" : [ ],
      "channel" : "31HA07BC819430D3495C56BC18C55622",
      "currency" : [ "EUR" ]
    } ],
    "type" : "invoice-guaranteed",
    "3ds" : false
  }, {
    "supports" : [ {
      "brands" : [ ],
      "countries" : [ ],
      "channel" : "31HA07BC812920047BFF7AF14FE0F467",
      "currency" : [ "EUR" ]
    } ],
    "type" : "PIS",
    "3ds" : false
  }, {
    "supports" : [ {
      "brands" : [ ],
      "countries" : [ ],
      "channel" : "31HA07BC819430D3495C7C9D07B1A922",
      "currency" : [ "EUR" ]
    } ],
    "type" : "sofort",
    "3ds" : false
  } ]
}
Property Type Description
publicKey String Your production public key.
privateKey String Your production private key.
secureLevel String Your PCI SAQ level.
alias String Your merchant alias.
paymentTypes Object All of your configured payment methods.
supports Object Information about a configured payment method.
brands String Brands related to the payment method.
countries String Countries where the payment method is supported.
channel String A channel that identifies the payment method.
currency String The payment method currency, in the ISO 4217 alpha-3 format.
type String The type of the related payment resource.
3ds Boolean For cards: if set to true, the card is configured with the 3-D Secure protocol enabled.