{"title":"Sofort Drop-in integration","category":"default","creationDate":1778252958,"content":"

Our Android Drop-in<\/a> renders Sofort in your payment form, and redirects the shopper to Sofort to complete the payment.<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nMake sure that you have built your integration<\/a>. <\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\nBefore you begin, add Sofort in your test Customer Area<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Show Sofort in your payment form<\/h2>\n

Drop-in uses the countryCode<\/code> and the amount.currency<\/code> from your \/paymentMethods<\/a> request to show the available payment methods to your shopper.<\/p>\n

To have Drop-in render Sofort in your payment form, specify in your request one of the following combinations of countryCode<\/a> and amount.currency<\/a>:<\/p>\n\n\n\n\n\n\n\n\n\n\n
Country\/region<\/th>\ncountryCode<\/code><\/th>\namount.currency<\/code><\/th>\n<\/tr>\n<\/thead>\n
Austria<\/td>\nAT<\/td>\nEUR<\/td>\n<\/tr>\n
Belgium<\/td>\nBE<\/td>\nEUR<\/td>\n<\/tr>\n
Germany<\/td>\nDE<\/td>\nEUR<\/td>\n<\/tr>\n
Spain<\/td>\nES<\/td>\nEUR<\/td>\n<\/tr>\n
Switzerland<\/td>\nCH<\/td>\nCHF<\/td>\n<\/tr>\n
The Netherlands<\/td>\nNL<\/td>\nEUR<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Make a payment<\/h2>\n

When the shopper proceeds to pay, Drop-in returns the paymentComponentData.paymentMethod<\/code>.<\/p>\n

    \n
  1. \n

    Pass the paymentComponentData.paymentMethod<\/code> to your server.<\/p>\n<\/li>\n

  2. \n

    From your server, make a \/payments<\/a> request, specifying:<\/p>\n\n\n\n\n\n\n\n\n
    Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    paymentMethod<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe paymentComponentData.paymentMethod<\/code> from your client app.<\/td>\n<\/tr>\n
    returnUrl<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nURL to where the shopper should be redirected back to after they complete the payment. Get this URL from the Component in the RedirectComponent.getReturnUrl(context)<\/code>.<\/td>\n<\/tr>\n
    countryCode<\/code><\/td>\n<\/td>\nThe shopper's country\/region.
    Format: the two-letter ISO-3166-1 alpha-2<\/a> country code. Exception: QZ<\/strong> (Kosovo). Include this in the request for a better shopper experience. When the shopper is redirected to Sofort's website, the country\/region will be automatically selected from the dropdown list.<\/td>\n<\/tr>\n
    shopperLocale<\/code><\/td>\n<\/td>\nThe language that the Sofort page should be rendered in. The page can be the local language (for example, nl-NL<\/strong><\/span> for the Netherlands) or in en-US<\/strong><\/span>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    The following example shows how to make a payment request for 10 EUR<\/strong> for a shopper in the Netherlands, with the Sofort page rendered in US English.<\/p>\n<\/li>\n<\/ol>\n

    \n <\/code-sample>\n<\/div>\n

    In the \/payments<\/a> response, check the action<\/code> object for the information that you must use to redirect the shopper.<\/p>\n

    \n <\/code-sample>\n<\/div>\n

    If your integration is set up correctly<\/a>, the action<\/code> object is passed from your server to the client.<\/p>\n

    Check the payment result<\/h2>\n

    Drop-in redirects the shopper to complete the payment. When the shopper returns back to your app, Drop-in provides the actionComponentData<\/code> object.<\/p>\n

    <\/p>\n

    From your server, make a POST \/payments\/details<\/a> request providing:<\/p>\n