Important information

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


Accept Unzer Invoice Secured with own UI

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


Unzer Invoice Secured payment method doesn’t require any input from the customer on the merchant website.

With Unzer Invoice Secured you need to provide information about the customer via customer resource and the purchased products via basket resource when you make the transaction. This is required for customer assessment and transaction approval. You will also need the customer information to create the invoice document. You are responsible for gathering this data during the checkout.

<h2 id="before-you-begin">Before you begin</h2>

Step 1: Create a Payment Type resource
server side

When creating the payment type Unzer Invoice Secured, you need to send a request to the Unzer API. The response will contain 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');

$ivs = new InvoiceSecured();
$ivs = $unzer->createPaymentType($ivs);
InvoiceSecured invoiceSecured = new InvoiceSecured();
Unzer unzer = new Unzer(new HttpClientBasedRestCommunication(), "s-priv-xxxxxxxxxx");
invoiceSecured = unzer.createPaymentType(invoiceSecured);

The response looks similar to the following example:

    "id": "s-ivs-yyiu10a4bwye",
    "method": "invoice-secured",
    "recurring": false,
    "geoLocation": {
        "clientIp": "",
        "countryIsoA2": "DE"

For a full description of Unzer Invoice Secured payment type creation check API reference.

Next steps

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