SepaExpressV2

This page provides an overview of the payments methods provided by the SepaExpressV2 adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating SepaExpressV2 within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment Method	Transaction Flows	Transaction Types
DirectDebit	iFrame Form & Server-To-Server	Debit, Register, Deregister, Refund, Payout
BankTransfer	Full-Page Redirect	Debit, Refund

Depending on your setup SepaExpressV2 DirectDebit can be used as Server-to-Server only integration, or with an iFrame Payment form.

For the Server-to-Server integration the IBAN must be sent within the customer details, otherwise the customer will enter its IBAN within the iFrame form.

note

If your merchant is configured to generate and verify the SEPA mandate on the Gateway, a redirect to the iFrame Payment Page is always required.

Otherwise, it can be only server-to-server communication, and you provide all information as described in Additional parameters below.

For SepaExpressV2 BankTransfer, you must use a full-page redirect instead.

Additional parameters for DirectDebit transactions

Key	Required	Values	Description
customer.iban	conditional	string	Required if no reference transaction provided.
customer.bic	false	string
customer.firstName	conditional	string	Required if no company is provided
customer.lastName	conditional	string	Required if no company is provided
customer.company	false	string
extraData.checkAmount	conditional	float	Required for register calls.
extraData.checkCurrency	conditional	string (3 letter currency code)	Required for register calls.
extraData.approvalBy	false	string	currently allowed values: click, sms, email, ais

note

Make sure to use the ibanCustomer element within the XML instead of the normal customer object. The ibanCustomer contains the fields necessary for DirectDebit transactions.

Additional parameters for BankTransfer transactions

Key	Required	Values	Description
extraData.bankAccountId	conditional	string	Required unless a new BankAccount to create is given.
customer.identification	conditional	string	Required unless a new customer to create is given.
customer.bic	false	string
customer.firstName	conditional	string	Required if no company is provided
customer.lastName	conditional	string	Required if no company is provided
customer.company	false	string	Customer company
description	conditional	string	Required for payouts.
customer.billingAddress1	false	string	Billing address line 1
customer.billingAddress2	false	string	Billing address line 2
customer.billingPostcode	false	string	Billing postal code
customer.billingCity	false	string	Billing city
customer.billingState	false	string	Billing state
customer.billingCountry	false	string	Billing country
customer.email	false	string	Customer email
customer.shippingPhone	false	string	Customer phone
paymentData.ibanData.iban	true	string	IBAN
currency	true	string	Currency code
amount	true	string	Amount of transaction