Skip to content

Sofort

MH Integration option

Payment Flow

  1. The customer selects Sofort as a payment method on the merchant's website.
  2. The merchant sends a payment request to the PaySage.io.
  3. PaySage.io responds with a link to the payment page.
  4. The merchant redirects the customer to the payment page.
  5. The customer completes the payment.
  6. PaySage.io sends a webhook notification with the payment status to the merchant.
  7. The merchant displays the payment status to the customer.

Payment

Info

This integration option supports only `EUR` currency.
Request

Send a payment request with the following additional parameters:

Parameter Type Description
request object
return_url * required
 string URL to return the customer to when the transaction is completed.
ip string The customer's IP address.
method object A section of the payment method information.
type * required
 string sofort
user_id * required
 string Unique customer identifier in the merchant's system.
customer object A section of the customer details.
email * required
 string The customer's email address.
country * required
 string (2) The customer's country in the ISO 3166-1 Alpha-2 format. For example, DE.
Request example 
{
  "request": {
    "amount": 500,
    "currency": "EUR",
    "description": "description",
    "test": true,
    "return_url": "https://return.com",
    "language": "en",
    "customer": {
      "email": "example@example.com",
      "country": "DE"
    },
    "method": {
      "type": "sofort",
      "user_id": "fdsaf345"
    }
  }
}
Response

The sofort response object will have the parameters copied from the request as well as the form object to build a form where you should redirect the customer to finalize the payment.

Response example 
{
  "transaction": {
    "uid": "e87066f7-fdb5-4fcf-9d2c-9449fa7375e3",
    "type": "payment",
    "status": "pending",
    "amount": 500,
    "currency": "EUR",
    "description": "description",
    "created_at": "2024-03-15T13:25:16Z",
    "updated_at": "2024-03-15T13:25:17Z",
    "method_type": "sofort",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/e87066f7-fdb5-4fcf-9d2c-9449fa7375e3/d019a14ca5457d96e4e18a4241ebe6fae58b203af17d7417ec016ee97de38acd?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 3806,
      "ref_id": "1710509116731",
      "message": "Transaction was initialized",
      "rrn": 33761516
    },
    "sofort": {
      "user_id": "fdsaf345",
      "type": "sofort"
    },
    "customer": {
      "email": "example@example.com",
      "country": "DE",
      "ip": null
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized",
    "test": true,
    "language": "en",
    "billing_address": {
      "email": "example@example.com",
      "country": "DE"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "https:/mh/paymentpage/1298/1710509116731",
      "method": "GET",
      "fields": []
    }
  }
}