Accept Unzer Invoice with a server-side-only integration

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

Overview

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

• Check the basic integration requirements.
• Familiarize yourself with the general Server-side-only integration guide.

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.

POST https://api.unzer.com/v1/types/invoice

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": "127.0.0.143",
    "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.