SEPA Direct Debit

The request allows the initiation of a SDD (SEPA Direct Debit).
The customer will be required to sign an electronic mandate for the first debit. A redirection page (parameter MandateUrl) is then returned, as for a 3DSecure payment for example, and this operation will not be requested for the next debits.

Request

Body Params application/x-www-form-urlencoded

Amount

number

required

Transaction amount in cents

Uid

string

required

Your unique customer ID (highly recommended)

string

required

The customer's email address associated with the payment (highly recommended)

Lastname

string

required

Name of the client, or company name

Iban

string

required

IBAN of the customer

Bic

string

optional

BIC of the customer

AccountOwner

number

optional

Person (or company) who owns the bank account

B2B

enum<string>

optional

Only used to manage the collection of payments between companies. It does not apply to individuals or self-employed persons
A B2B direct debit is not contestable by the customer (disabled by default)

Allowed values:

yesno

ClientIp

string

required

IP address of the client or device validating the collection

Address

string

required

Customer's address

ZipCode

string

required

Customer's postal code

City

string

required

Customer's city

Country

string

required

Customer's country of residence

ClientId

string

optional

Unique Easytransac customer ID (if you have already made a payment for this customer)

OrderId

string

optional

Your unique transaction identifier (or order number)

Description

string

optional

Description of the transaction (use \nto make a line break)

Firstname

string

optional

Customer's first name

CallingCode

string

optional

Customer's calling code

Phone

string

optional

Customer's phone number

BirthDate

string

optional

Customer's birth date

Nationality

string

optional

Customer's nationality

ReturnUrl

string

optional

URL where the customer is redirected once the payment is made
The status of the transaction is systematically returned in POST on this return URL

ReturnMethod

enum<string>

optional

The ReturnUrl parameter passing is by default in POST, you can force it in GET
Only the "essential" parameters are returned in this case

Allowed values:

GETPOST

MultiplePayments

enum<string>

optional

Allows the transaction to be split into several payments (for example, for an amount of 300 euros, the deposit will be 100 euros by default, a payment of 100 euros will take place 30 days later, and then a final payment of 100 euros after 60 days)

Allowed values:

yesno

MultiplePaymentsRepeat

string

optional

Number of payments to be made in total when paying in instalments, including deposit (default is 3)

DownPayment

number

optional

Deposit for a payment in several instalments (33% of the total by default, if payment in 3 instalments for example) or amount of the first payment (for a subscription, if the first payment is different from the following)

Rebill

enum<string>

optional

Activate or not the subscription (recurring payments)

Allowed values:

yesno

Recurrence

enum<string>

optional

Frequency of direct debit subscriptions (monthly by default)

Allowed values:

yearlymonthlybimonthlyweeklydailybiannualquarterly

PayToEmail

string

optional

Allows you to redirect the cashing of this transaction to the account of another Easytransac user

PayToId

number

optional

Allows you to redirect the collection of this transaction to the account of another Easytransac user, by his unique ID

UserAgent

string

optional

Indicates the capabilities of the client browser

Language

string

optional

Language of the potential bank errors returned

Signature

string

required

Signature to verify the integrity of the data sent

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Response

application/json

Body

Code

integer

optional

Example:

Signature

string

optional

Example:

1f51786246a940677afe71f6968972fd46500bd1

Result

object

optional

RequestId

string

optional

Example:

a1b2c3d4e5f6

Tid

string

optional

Example:

a1b2c3d4

Uid

string

optional

Example:

Abc123

OrderId

string

optional

Example:

Cde100

Status

enum<string>

optional

Allowed values:

pendingcapturedfailed

Example:

captured

Date

string

optional

Example:

2019-06-03 17:05:30

DateRefund

string

optional

Example:

2019-06-03 17:05:30

DateChargeback

string

optional

Example:

2019-06-03 17:05:30

DateRepresentment

string

optional

Example:

2019-06-03 17:05:30

Amount

string

optional

Example:

29.99

FixFees

string

optional

Example:

0.01

Message

string

optional

Example:

Payment was successful

MultiplePayments

enum<string>

optional

Allowed values:

yesno

Example:

Rebill

enum<string>

optional

Allowed values:

yesno

Example:

OriginalPaymentTid

string

optional

Example:

a1b2c3d4

Alias

string

optional

Example:

a1b2c3

Error

string

optional

Example:

Insufficient funds

AdditionalError

array[string]

optional

Example:

["Do not honor"]

MandateUrl

string

optional

Example:

https://www.easytransac.com/api/payment/mandate/a1b2c3d4

Client

object

optional

Example

{
  "Code": 0,
  "Signature": "1f51786246a940677afe71f6968972fd46500bd1",
  "Result": {
    "RequestId": "a1b2c3d4e5f6",
    "Tid": "a1b2c3d4",
    "Uid": "Abc123",
    "OrderId": "Cde100",
    "Status": "pending",
    "Date": "2019-06-03 17:05:30",
    "DateRefund": "2019-06-03 17:05:30",
    "DateChargeback": "2019-06-03 17:05:30",
    "DateRepresentment": "2019-06-03 17:05:30",
    "Amount": "29.99",
    "FixFees": "0.01",
    "Message": "Payment was successful",
    "MultiplePayments": "yes",
    "Rebill": "yes",
    "OriginalPaymentTid": "a1b2c3d4",
    "Alias": "a1b2c3",
    "Error": "Insufficient funds",
    "AdditionalError": [
      "Do not honor"
    ],
    "MandateUrl": "https://www.easytransac.com/api/payment/mandate/a1b2c3d4",
    "Client": {
      "Id": "aaabbb1",
      "Email": "test@test.com",
      "Firstname": "John",
      "Lastname": "Doe",
      "Address": "26 green street",
      "ZipCode": "75001",
      "City": "Paris"
    }
  }
}