---
title: "Create Payment Form (Pay by Link)"
method: POST
path: "/v2/moneyins/card/paymentform"
tags: ["MoneyIns | Pay by Link"]
---

# Create Payment Form (Pay by Link)

`POST /v2/moneyins/card/paymentform`

Accept payments by an SMS, email, or document.   
 Create a form that permits your customers to make card payments by link.     
 
- Payment forms are generated and managed by Lemonway.  
- Payment forms are publicly accessible, making it possible for anyone to pay with a valid link.    
- Payment by bank card is only supported.  

Payment Scenerios:  
1. **Benificary Wallet `walletReceiver` not specified**  
You only specify `walletPayer` and not `walletReceiver` in the body parameters.  
They make a card payment and funds are transfered to the `walletPayer` (a designated wallet)

2. **Payer and Benificary Wallet defined**  

3. **Benificary pecified**  

 **Note:** Deferred payment is not supported.

## Headers

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

## Request body

- CreatePaymentFormInput
  - `optId` string — To cross-reference a buyer with a payment, use `optId` to help associate them with one another. **Note:** Do not use special characters in this field, for example: #, @, and !.
  - `walletPayer` string — Associated with the **Payer Wallet**. If this field is filled then the money reaches this wallet before arriving at the beneficiary wallet (via a transfer wallet to wallet). **Important:** Don't put the <b>SC Wallet</b> here, it won't work. You cannot debit the <b>SC Wallet</b> with a credit card.
  - `walletReceiver` string — Beneficiary Wallet. If this field is not complete, then the end-user must to fill its value on the payment form. <b>We recommend you complete the form instead of your end-user</b> Don't put the <b>SC Wallet</b> here, it won't work. You cannot credit the <b>SC Wallet</b> with a credit card.
  - `totalAmount` string, required — Amount or a range of the amount to be debited. 1. If this field is configured with an interval (eg, 15.30-500.26) then the final customer will have to enter an appropriate amount in the form. 2. If this field is not filled then the end-user can enter any amount to the form. 3. If this field is filled with a precise value (eg 15.60), then the end-user has no choice in the amount field of the form. Amounts are given as integer numbers in cents. Note: If you enter a fixed amount
  - `commissionAmount` integer — Your Fee Amounts are given as integer numbers in cents
  - `comment` string — Comment Regarding the Transaction
  - `returnUrl` string — URL redirection after the payment procedure is successfully finished
  - `cancelUrl` string — URL redirection after the payment procedure is cancelled
  - `errorUrl` string — URL edirection after the payment procedure is failed
  - `firstNamePayer` string — Payer's First Name If this field is not filled then the end-user have to fill it in the payment form
  - `lastNamePayer` string — Payer's Last Name If this field is not filled then the end-user have to fill it in the payment form
  - `emailPayer` string — Payer's Email If this field is not filled then the end-user have to fill it in the payment form
  - `style` string — Link to a custom CSS Stylesheet The stylesheet should be publicly accessible via **HTTPS*
  - `atosStyle` string
  - `notifUrl` string — At the end of the payment procedure, an HTTP POST message containing the payment status (PAID, ERROR, CANCEL) is sent to this address. It is possible that the same notification might be sent several times.
  - `options` string — Reserved for a future version

## Response `200`

OK

- CreatePaymentFormOutput
  - `form` PaymentForm
    - `walletIp` string
    - `walletUa` string
    - `amountTotRange` string
    - `amountCom` string
    - `language` string
    - `version` string
    - `style` string
    - `atosStyle` string — Mercanet v1 only: Link to a custom Mercanet CSS Stylesheet. The stylesheet should be publicly accessible via HTTPS
    - `notifUrl` string
    - `options` string — Reserved for future version
    - `active` boolean
    - `raisonSociale` string
    - `id` string — Payment Form ID
    - `optId` string — Optional identity of the payment form. You should not use special character here.
    - `accountPayer` string — Payer Account If this field is filled then the money reaches this wallet before arriving at the beneficiary wallet (via a transfer wallet to wallet) note: Don't put the <b>SC Wallet</b> here, it won't work. You cannot credit the <b>SC Wallet</b> with a credit card.
    - `accountReceiver` string — Beneficiary Account if this field is not filled then the end-user must to fill its value on the payment form. We recommend you to always fill it instead of your end-user. note: Don't put the <b>SC Wallet</b> here, it won't work. You cannot credit the <b>SC Wallet</b> with a credit card.
    - `comment` string
    - `returnUrl` string — URL redirection after the payment procedure is successfully finished
    - `cancelUrl` string — URL redirection after the payment procedure is cancelled
    - `errorUrl` string — URL redirection after the payment procedure is failed
    - `firstNamePayer` string — Payer's First Name If this field is not filled then the end-user have to fill it in the payment form.
    - `lastNamePayer` string — Payer's Last Name If this field is not filled then the end-user have to fill it in the payment form.
    - `emailPayer` string — Payer's Email If this field is not filled then the end-user have to fill it in the payment form.
  - `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)