---
title: "Initiate a Web Payment"
method: POST
path: "/v2/moneyins/card/webinit"
tags: ["MoneyIns | Cards"]
---

# Initiate a Web Payment

`POST /v2/moneyins/card/webinit`

## Request

- Base URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest`
- URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/moneyins/card/webinit`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Request body

- MoneyInWebInitInput
  - `returnUrl` string, required: Your site URL called by WebKit to terminate the operation.
  - `errorUrl` string, required: Your site return URL, called by WebKit in case of an error.
  - `cancelUrl` string, required: Your site return URL, called by WebKit in case of a cancellation.
  - `registerCard` boolean: Save the card and returns an ID for future payments.
  - `captureDelayedDays` integer: Indicate the number of days of the deferred payment. Between 0 and 6 days to have a guaranteed payment. Only usable with isPreAuth = 0-6
  - `label` string: Indicates the name of the shop on the payment page.
  - `cardId` string: Indicates the CardId
  - `moneyInNature` 0 | 1: Indicates the nature of activity for this Money-In:<br/>0 = Activity 1.<br/>1 = Activity 2.<br/>
  - `threeDS` ThreeDS
    - `challengeMode` string: If you would like to enforce 3D Secure for your client then use the challenge mode. Possible values are: - No_preference (default value). The card holder's bank will decide whether or not to challange - Force_threeDS
  - `riskAnalysis` RiskAnalysis
    - `billingAddress` BillingAddress
      - `city` string: Client city
      - `country` string: Client country using ISO 3166-1 alpha-3
      - `addressAdditional1` string: Client number and street
      - `addressAdditional2` string: Client number and street
      - `addressAdditional3` string: Client number and street
      - `zipCode` string: Client Post Code/ZIP
      - `state` string: Client State
    - `holder` Holder
      - `firstName` string
      - `lastName` string
      - `email` string
      - `phone` string
      - `mobile` string
      - `workPhone` string
    - `deliveryAddress` DeliveryAddress
      - `city` string: Client City
      - `Country` string: Client country using ISO 3166-1 alpha-3
      - `addressAdditional1` string: Client Number and Street
      - `addressAdditional2` string: Client Number and Street
      - `addressAdditional3` string: Client Number and Street
      - `zipCode` string: Client Postal Code/ZIP
      - `state` string: Client State
    - `deliveryAdditionalInfo` DeliveryAdditionalInfo
      - `contact` Contact
        - `email` string
      - `numberOfItemsBasket` string: Total quantity of all products in the basket
      - `addressDeliveryBillingMatchIndicator` string: Specifies whether the delivery and the billing addresses are the same
      - `deliveryAddressCreationDate` string: The date on which the last delivery address used by the merchant's account was reported in the transaction
      - `estimatedDeliveryDelay` string: Estimated Delivery Delay (in days) by the Merchant
      - `deliveryMode` string: Delivery Method (Postal Office or Amazon box and so on)
    - `customerAccountInfo` CustomerAccountInfo
      - `customerAccountId` string: Additional information about the account optionally provided by the 3-D Secure Requestor
      - `numberOfPurchase180Days` string: The number of customer transactions made over the last six months (last 180 days)
      - `numberOfTransactionYear` string: Number of accepted or abandoned transactions in the last year on the customer account
      - `customerAccountCreationDate` string: The customer account creation date. Format: YYYY/MM/DD
      - `numberOfAttemptsAddCard24Hours` string: The number of add card attempts in 24 hours
      - `suspiciousActivityIndicator` string: Specifies whether a suspicious activity is detected on customer account. Possible values: true or false.
      - `numberOfTransaction24Hours` string: Number of abandoned or successful transactions in the last 24 hours on the customer account
      - `customerAccountChangeDate` string: Last date the customer account was changed. Format: YYYY/MM/DD
      - `passwordChangeDate` string: Date of last change of password of the customer account. Format: YYYY/MM/DD
      - `addPaymentMeanDate` string: Date of last added form of payment made to account. For example a new card registered to the account. Format: YYYY/MM/DD
    - `customer` CustomerInformation: Holds Customer contact information (email, phone, etc.)
      - `first_name` string: Customer first name
      - `last_name` string: Customer last name
      - `email` string: Customer email
      - `address1` string: Customer number and street
      - `address2` string: Customer additional address information
      - `city` string: Customer city
      - `state` string: Customer state
      - `zip` string: Customer Post Code/ZIP
      - `country_code` string: Customer country using ISO 3166-1 alpha-3
      - `phone` Phone: Holds Customer phone information
        - `number` string: Phone number
        - `dialing_code` string: Phone dialing code
      - `ip_address` string: Customer IP address
      - `gender` string: Customer sex
      - `date_of_birth` string: Customer date of birth
    - `authentication` Authentication
      - `merchantCustomerAuthentMethod` string: Possible Authentication Methods: <br /> - NOAUTHENT = 1 - No authentication of the customer by the merchant - OWNCREDENTIAL = 2 - Customer authentication by the merchant using his own system - FEDERATEDID = 3 - Customer authentication by the merchant using an identifier federated(facebook, ...) (e.g.Facebook) - ISSUERID = 4 - Customer authentication by the merchant using information of the issuer's payment mean - THIRDPARTY = 5 - Customer authentication by the merchant using a third system - FIDO = 6 - Customer authentication by the merchant with FIDO(Fast IDentity Online) system
      - `merchantCustomerAuthentDateTime` string: ISO8601 date time format
  - `recurringAvgAmount` integer: Average amount of future recurring payments to cover recurring payments with variable amounts. **Note:** Only if the amount is higher than the amount of the first transaction.
  - `paymentPattern` string: **Recurring**: If a payment follows a recurring amount or **One_shot**: when there is no future recurring payments.
  - `reference` string: Unique ID of the call, generated by your server. This ID can be used as a search field when looking for operation details
  - `accountId` string, required: Payment Account ID to Credit
  - `totalAmount` integer: Amount to Debit Amounts are given as integer numbers in cents
  - `commissionAmount` integer: Your Fee Amounts are given as integer numbers in cents
  - `comment` string: Comment Regarding the Transaction
  - `autoCommission` boolean: If true: 1. [amountCom] will be ignored and will be replaced with Lemonway's fee 2. You will not receive any fee

## Response `200`

OK

- MoneyInWebInitOutput
  - `webKitToken` string: Payment Token to Pass to WebKit URL using GET
  - `id` integer: Transaction ID
  - `id ` integer: OBSOLETE Transaction ID
  - `cardId` integer
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string: Get the Error Message from PSP

## Other responses

- `401`: Unauthorized
- `500`: InternalServerError

---

[API](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0.md) - [All operations](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/revisions/82551a0a77b8?raw)