{"title":"SEPA Direct Debit for API only","category":"default","creationDate":1776961628,"content":"

You can add SEPA Direct Debit to your existing integration. The following instructions show only what you must add to your integration specifically for SEPA Direct Debit.<\/p>\n

If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.<\/p>\n

Requirements<\/h2>\n\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 an existing API-only integration<\/a>.<\/td>\n <\/td>\n<\/tr>\n
Action handling<\/strong><\/td>\nMake sure that your existing integration is set up to handle the additional action<\/a>.
action.type<\/code>: direct<\/strong>.<\/td>\n		<\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\n Before you begin, add SEPA Direct Debit in your Customer Area<\/a>. <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n
    \n
  1. The shopper selects SEPA Direct Debit as the payment method.<\/li>\n
  2. The shopper enters their details in the payment form that you build<\/a>.<\/li>\n
  3. When you make the payment request, you include additional information about the items that the shopper intends to purchase<\/a>.<\/li>\n
  4. If you do not use automatic capture, you must capture the payment<\/a>.<\/li>\n<\/ol>\n

    Build your payment form<\/h2>\n
      \n
    1. \n

      Include SEPA Direct Debit in the list of available payment methods.<\/p>\n<\/li>\n

    2. \n

      After the shopper selects SEPA, render the input fields for SEPA to collect their issuer selection. You'll need this to\u00a0make a payment.<\/p>\n\n\n\n\n\n\n
      Payment details<\/strong><\/th>\nExample<\/th>\n<\/tr>\n<\/thead>\n
      The name on the SEPA bank account.<\/td>\n\"A. Klaassen\"<\/td>\n<\/tr>\n
      The IBAN of the bank account.<\/td>\n\"NL98ABNA0410108103\"<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ol>\n
      \n

      You can download the logo for SEPA Direct Debit<\/a> to use in your form.<\/p>\n<\/div>\n

      Get SEPA Direct Debit as an available payment method<\/h2>\n

      When you make the \/paymentMethods<\/a> to get available payment methods<\/a>, specify the following so that SEPA Direct Debit is included in the response.<\/p>\n\n\n\n\n\n\n
      Parameter<\/th>\nValues<\/th>\n<\/tr>\n<\/thead>\n
      countryCode<\/a><\/td>\nAT<\/strong>, BE<\/strong>, CY<\/strong>, EE<\/strong>, FI<\/strong>, FR<\/strong>, DE<\/strong>, GR<\/strong>, IE<\/strong>, IT<\/strong>, LV<\/strong>, LT<\/strong>, LU<\/strong>, MT<\/strong>, NL<\/strong>, PT<\/strong>, SK<\/strong>, SI<\/strong>, ES<\/strong><\/td>\n<\/tr>\n
      amount.currency<\/a><\/td>\nEUR<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
      \n <\/code-sample>\n<\/div>\n
      \n <\/code-sample>\n<\/div>\n

      Add additional parameters to your \/payments request<\/h2>\n

      When you make a payment<\/a>, add the following parameters:<\/p>\n

      \n

      The billing address is required if the country IBAN is from any of the following non-EEA SEPA countries or territory.<\/p>\n<\/div>\n\n\n\n\n\n\n\n
      Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
      paymentMethod.sepa.ownerName<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe name on the SEPA bank account.<\/td>\n<\/tr>\n
      paymentMethod.sepa.ibanNumber<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe IBAN of the bank account. Make sure that you do not encrypt this value.<\/td>\n<\/tr>\n
      billingAddress.street<\/code>
      billingAddress.houseNumberOrName<\/code>
      billingAddress.postalCode<\/code>
      billingAddress.city<\/code>
      billingAddress.country<\/code><\/td>\n      		<\/td>\nThe billing address is required if the country IBAN is from any of the following non-EEA SEPA countries or territories:

      Non-EEA SEPA countries (11)<\/strong>
      Albania (AL)
      Andorra (AD)
      Moldova (MD)
      Monaco (MC)
      Montenegro (ME)
      North Macedonia (MK)
      San Marino (SM)
      Serbia (RS)
      Switzerland (CH)
      United Kingdom (GB)
      Vatican City State (VA)

      Non-EEA SEPA territories (4)<\/strong>
      Guernsey (GG)
      Isle of Man(IM)
      Jersey (JE)
      Saint Pierre and Miquelon (PM)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
      \n <\/code-sample>\n<\/div>\n
      \n <\/code-sample>\n<\/div>\n

      Capture the payment<\/h2>\n

      If you do not use automatic capture, you must capture the payment in one of the following ways:<\/p>\n