Create a session

post https://api-sandbox.retail.monext.com/v1/checkout/payments/sessions

Creating a payment session generates a session token:
A temporary key used to initialize the Payment Widget and authenticate it against your account.
This works the same way with Hosted Payment Pages.

Payment Widget automatically retrieves all the settings from the payment session to configure the payment methods and the payment experience.

Note: sessionId expire after 30 minutes per default.

Body Params

pointOfSaleReference

string

required

1 to 50

Point of sale reference identifier.

paymentMethod

object

The suggested payment method.

order

object

required

Order information.

payment

object

Payment information.

buyer

object

Buyer information.

delivery

object

Delivery object

threeDS

object

3DS information

privateData

object

Additional data to be used throughout the payment lifecycle.
A dictionary of key-value pairs where the values can only be strings.
e.g. {"suborderid": "AE-3023-001", "chanel": "mobile"}

miscData

object

miscData can be transmit to the payment method partners.
Consult the payment method for each use.
miscData is a dictionary values can be of any type (aka free-form object) Example:
{ "key1": "value1", "key2": "value2" } or "SBCC": { "membershipStatus": "01", "deferredPayment": { "numberOfDays": "060" }

returnURL

string

required

URL on which the buyer's browser is redirected in case of acceptance or refusal of payment on Monext Online.
The merchant must call getWebPaymentDetails or GET /sessions.

notificationURL

string

URL on which Monext Online will ask the merchant site to retrieve the result of the transaction.

languageCode

string

Buyer browser language by default. Example : FR

customPaymentPageCode

string

The identifier of customized template pages.
If not set, the default one will be used.

oneClickOption

string

Defaults to WITHOUT_CVV

Defines whether the CVV is required during a 1-click payment.
Possible values: WITH_CVV, WITHOUT_CVV.
By default, or if the field is left empty, the CVV will not be requested.

mxWalletId

string

1 to 50

The unique identifier of Monext virtual wallet.
You must provide Monext with an unique identifier that corresponds to one and only one buyer on your information system.
This identifier will be used when you request a payment by Monext virtual wallet.
MXWallet ID must:

Start and contain only an alphanumeric characters (A-Z, a-z, 0-9).
May include dots ('.'), hyphens ('-'), and underscores ('_').
Have a length between 1 and 50 characters.

Responses

Language

Credentials

Basic

base64


xxxxxxxxxx
35
1
curl --request POST \
2
     --url https://api-sandbox.retail.monext.com/v1/checkout/payments/sessions \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "order": {
8
    "currency": "EUR",
9
    "origin": "E_COM",
10
    "country": "FR"
11
  },
12
  "payment": {
13
    "paymentType": "ONE_OFF",
14
    "capture": "AUTOMATIC",
15
    "recurring": {
16
      "frequency": "DAILY"
17
    }
18
  },
19
  "buyer": {
20
    "legalStatus": "PRIVATE",
21
    "billingAddress": {
22
      "country": "FR"
23
    }
24
  },
25
  "delivery": {
26
    "address": {
27
      "country": "FR"
28
    }
29
  },

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

201Created

400Bad Request

401Unauthorized

403Forbidden

404Not Found

409Conflict

412Precondition Failed

422Unprocessable Entity

429Too Many Requests

500Internal Server Error

501Not Implemented

502Bad Gateway ou Proxy Error

503Service Unavailable

504Gateway Time-out