Important information

The API reference is now available here.
The deprecated API reference is available here.


Accept Unzer Invoice with a server-side-only integration

Build your own payment form to add Unzer Invoice payment to the checkout page


The Unzer Invoice payment method doesn’t require any input from the customer on your website. You can see an example of here on our demo page.

Although Unzer API doesn’t require any customer data for this payment method, you should request for the customer’s details during the checkout so that you can create the invoice document.

Before you begin

Step 1: Create a payment type resource
server side

When creating the Unzer Invoice payment type, you need to send a request to the Unzer API. The response contains an id , this is later referred to as typeId. You will need this typeId to perform the transaction.


Body: {}
$unzer = new Unzer('s-priv-xxxxxxxxxx');

$invoice = new Invoice();
$invoice = $unzer->createPaymentType($invoice);
Unzer unzer = new Unzer(new HttpClientBasedRestCommunication(), "s-priv-xxxxxxxxxx");
Invoice invoice = new Invoice();
invoice = unzer.createPaymentType(invoice);

The response looks similar to the following example:

  "id": "s-ivc-yv4uza8xbapi",
  "method": "invoice",
  "recurring": false,
  "geoLocation": {
    "clientIp": "",
    "countryCode": "DE"

For a full description of Unzer Invoice payment type creation, see the API reference.

Next steps

The next steps are the same as for the UI components integration. See Accept Unzer Invoice with UI Components from Step 2 onwards.