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

# Initiate a Web Payment

`POST /v2/moneyins/card/webinit`

## Headers

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

## Request body

- MoneyInWebInitInput
  - `returnUrl` string — Your site URL called by WebKit to terminate the operation.
  - `errorUrl` string — Your site return URL, called by WebKit in case of an error.
  - `cancelUrl` string — 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, required
      - `lastName` string, required
      - `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
    - `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, required — 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.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/revisions/73309fe68e2d/schema)