SEPA

Rail overview

Use SEPA for EUR payouts to European bank accounts.

Conomy captures funds from the internal account and sends the payout instruction to the provider for SEPA clearing.

Region Europe

Currency EUR

Direction Pay-out

Model IBAN bank transfer

Validate IBAN, beneficiary name, and country before capture; SEPA payouts are only as reliable as the beneficiary data.

Required fields

Field	Type	Description
type	string	Must be "SEPA"
currency	string	Must be "EUR"
sepa.iban	string	Recipient’s IBAN
sepa.customer.firstName	string	Recipient’s first name
sepa.customer.lastName	string	Recipient’s last name
sepa.customer.email	string	Recipient’s email
sepa.customer.documentNumber	string	National ID or tax number
sepa.customer.documentType	string	Document type
sepa.bic	string	BIC/SWIFT code of the bank

Example

{
  "type": "SEPA",
  "currency": "EUR",
  "sepa": {
    "iban": "DE89370400440532013000",
    "bic": "COBADEFFXXX",
    "customer": {
      "firstName": "Hans",
      "lastName": "Müller",
      "email": "hans@example.com",
      "documentType": "DNI",
      "documentNumber": "X1234567A"
    }
  }
}

Object

ibanstringrequired

Recipient's IBAN.

bicstring

BIC/SWIFT code of the recipient's bank.

customerobjectrequired

Information on who pays the transaction

idstring

Unique identifier for the internal service.

firstNamestringrequired

Payer's name

emailstring

Payer's email

lastNamestring

Payer's last name

phoneNumberstring

Payer's phone number without prefix

phoneNumberPrefixstring

Phone number prefix (e.g., +57)

documentTypestring

Documeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.

documentNumberstring

The document number associated with the documentType

addressobjectshow 8 properties

The entity’s address information.