1-click payment

OneClick payment uses the same process as card payment but without credit card or customer information and there is no interaction with the user. An initial card payment must be made beforehand in order to obtain a credit card Alias that can be used in this payment method.

Request

Body Params application/x-www-form-urlencoded

Amount

number

required

Transaction amount in cents

ClientId

string

required

Unique Easytransac customer ID

ClientIp

string

required

Customer IP address

Alias

string

required

Allows you to choose which card to use (it must be associated with your user by its Uid)

OrderId

string

optional

Your unique transaction identifier (or order number)

Description

string

optional

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

PreAuth

enum<string>

optional

Make a pre-authorisation only, the payment will have to be completed via the "capture" webservice

Allowed values:

yesno

PreAuthDuration

number

optional

Duration of reservation of an amount in a pre-authorisation, in days (1 to 6)

3DS

enum<string>

optional

Use 3DSecure or not (disabled by default, but depends on the acquiring platform).

Allowed values:

yesno

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

CardCVV

string

optional

The visual cryptogram of the bank card (for verification)

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 of subscriptions (monthly by default)

Allowed values:

yearlymonthlybimonthlyweeklydailybiannualquarterly

PayToEmail

string

optional

Allows you to redirect the collection 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

string

optional

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

3DSecure

enum<string>

optional

Allowed values:

yesno

Example:

OneClick

string

optional

Example:

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"]

Client

object

optional

Example

{
  "Code": 0,
  "Signature": "1f51786246a940677afe71f6968972fd46500bd1",
  "Result": {
    "RequestId": "a1b2c3d4e5f6",
    "Tid": "a1b2c3d4",
    "Uid": "Abc123",
    "OrderId": "Cde100",
    "Status": "captured",
    "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",
    "3DSecure": "yes",
    "OneClick": "no",
    "MultiplePayments": "yes",
    "Rebill": "yes",
    "OriginalPaymentTid": "a1b2c3d4",
    "Alias": "a1b2c3",
    "Error": "Insufficient funds",
    "AdditionalError": [
      "Do not honor"
    ],
    "Client": {
      "Id": "aaabbb1",
      "Email": "test@test.com",
      "Firstname": "John",
      "Lastname": "Doe",
      "Address": "26 green street",
      "ZipCode": "75001",
      "City": "Paris"
    }
  }
}