Sofort

Sofort is an online payment method used in select European countries.

About Sofort

Sofort lets you accept a direct online transfer from your customer’s bank account.

To authorize the transfer, the customer provides their online banking credentials.

Accept a Sofort payment

To accept a Sofort payment, follow the steps below.

To implement Unzer UI components, go here.

When testing, do not use real customer data. Use the test data prepared by Unzer.

Step 1: Create a sofort resource

To accept a Sofort payment, create a sofort resource first.

Make an empty-body POST call to /types/sofort:

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

Body: {}

{
  "id": "s-sft-ys8v4iyqhgpk",
  "method": "sofort",
  "recurring": false,
  "geoLocation": {
    "clientIp": "115.77.189.143",
    "countryCode": "VN"
  }
}

Step 2: Make a charges call

To charge the Sofort resource, make a POST call to payments/charges, with the following parameters in the request body:

POST https://api.unzer.com/v1/payments/charges

{
  "amount": "12.4500",                                    
  "currency": "EUR",
  "returnUrl": "https://www.unzer.com",
  "resources": {
    "typeId": "s-sft-23ashaor54",
  }
}

{
  "id": "s-chg-1",
  "isSuccess": false,
  "isPending": true,
  "isError": false,
  "redirectUrl": "https://payment.unzer.com/sofort/3849234023942354935353405234320423",
    ...
}

Step 3: Forward the customer to redirect URL

After you charge the sofort resource, implement the following flow:

1. Redirect the customer to redirectURL.
2. The customer is forwarded to the Sofort payment page.
3. After a successful payment, the customer is redirected to the returnURL that you specified in the charges call (Step 2).

Step 4: Check the payment status

After the customer is redirected to the returnUrl, check the status of the payment.

Make a GET call with the following parameters in the request path:

GET https://api.unzer.com/v1/payments/{resource_ID}>/charges/{transaction_ID}

{
  "id": "s-chg-1",
  "isSuccess": true,
  "isPending": false,
  "isError": false,
     ...
}