---
title: "Initiate Pay by PayPal"
method: POST
path: "/v2/moneyins/paypal/init"
tags: ["MoneyIns | PayPal"]
---

# Initiate Pay by PayPal

`POST /v2/moneyins/paypal/init`

Lets you integrate PayPal payments on your platform. The integration is implemented as a standard web page redirect to PayPal.com, it enables buyers to login to their accounts and make a payment to your organization.

## Headers

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

## Request body

- InitPayPalTransactionInput — Init PayPal transaction input
  - `redirections` Redirections — Redirection urls
    - `returnUrl` string — Return URL
    - `errorUrl` string — Error URl
    - `cancelUrl` string — Cancel URL
  - `transaction` Transaction — Transcation
    - `reference` string — Reference
    - `accountId` string, required — Account Id
    - `totalAmount` integer, required — Total Amount
    - `commissionAmount` integer — Commission Amount
    - `comment` string — Comment
    - `autoCommission` boolean — Auto Commission
    - `isPreAuth` boolean
    - `captureMode` 1 | 2 — Specifies the capture mode for the payment: Automatic results in a Capture type, and Manual results in an Authorize type.<br/>1 = Automatic.<br/>2 = Manual.<br/>
  - `amountBreakdown` AmountBreakdown — The amount breakdown.
    - `totalItems` integer — The subtotal for all items.
    - `totalItemTaxes` integer — The total tax for all items.
    - `shipping` integer — The shipping fee for all items.
    - `handling` integer — The handling fee for all items.
    - `insurance` integer — The insurance fee for all items.
    - `shippingDiscount` integer — The shipping discount for all items.
    - `discount` integer — The discount for all items.
  - `delivery` Delivery — Delivery
    - `receiver` Receiver — Receiver
      - `fullName` string — Full name
    - `address` PaypalDeliveryAddress — Address
      - `country` string — ISO 3166-1 alpha-2
      - `city` string — City
      - `street` string — Number and street
      - `postCode` string — Postcode/ZIP
      - `state` string — Postcode/ZIP
  - `items` PurchaseItem[] — Items
    - `merchantAccountId` string — Merchant account id
    - `description` string — Description
    - `quantity` integer — Quantity
    - `unitAmount` integer — Unit amount
    - `type` 1 | 2 — Type<br/>1 = Physical.<br/>2 = Digital.<br/>
    - `taxAmount` integer — Tax amount
  - `riskData` object — Risk data

## Response `200`

OK

- InitPayPalTransactionOutput — Init PayPal transaction Output
  - `id` integer — Money-in Id
  - `redirectionUrl` string — Redirection Url
  - `payPalOrderId` string — PayPal Order Id
  - `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)