---
title: "Create New Pending Payment"
method: POST
path: "/v2/moneyins/buynowpaylater/init"
tags: ["MoneyIns | BNPL"]
---

# Create New Pending Payment

`POST /v2/moneyins/buynowpaylater/init`

## Request

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

Depending on your activated payment plans this call will let you setup a new payment plan.

## Headers

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

## Request body

- CreateBnplPaymentInput
  - `paymentPlanId` integer, required: Payment Plan ID
  - `captureMode` string: Defines if the payment should be captured right away or if the capture should be deferred. Possible values: `Automatic` and `Manual`. Default is set to 'Automatic'.
  - `delivery` BnplDelivery, required
    - `deliveryMode` string, required: Possible values: `CollectionOfTheGoodsInTheMerchantStore` `CollectionInAThirdPartyPoint` `DeliveryToCustomerAddress`
    - `expressDelivery` boolean, required
    - `deliveryAddress` BnplAddress, required
      - `street` string, required
      - `city` string, required
      - `postCode` string, required
      - `country` string, required
    - `deliveryPointName` string: Pickup name or recipient name. Mandatory only if DeliveryMode is not "DeliveryToCustomerAddress".
  - `items` BnplPurchaseItem[], required: Possible values: `PhysicalGood` `Discount` `ShippingFee` `DigitalGood` `ExternalPayment` `Insurance`
    - `type` string, required
    - `description` string, required
    - `reference` string, required
    - `quantity` integer, required
    - `unitAmount` integer, required
    - `merchantAccountId` string, required
  - `customer` Customer, required
    - `accountId` string, required: Client account Id.
    - `civility` string, required: Client civility. Possible values: `Mr` and `Ms`
    - `firstName` string, required: Client first name.
    - `lastName` string, required: Client last name.
    - `birthDate` string: Client birth date.
    - `mobileNumber` string, required: Client phone number.
    - `email` string, required: Client email.
    - `taxIdentificationNumber` string: Client tax identification number.
    - `billingAddress` BnplAddress, required
      - `street` string, required
      - `city` string, required
      - `postCode` string, required
      - `country` string, required
  - `returnUrl` string, required: Return success url
  - `errorUrl` string, required: Return error url
  - `cancelUrl` string, required: Return cancel url
  - `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

- CreateBnplPaymentOutput
  - `id` integer: Transaction ID.
  - `redirectUrl` string: Payment page URL.
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string: Get the Error Message from PSP

---

[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)
