Sign in

v1

latestOpenAPI 3.0.02026-07-2691259477.2 KB
MoneyIns | Pay by Link

Create Payment Form (Pay by Link)

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.

post/v2/moneyins/card/paymentform

Headers

Authorizationstring required

Authorization bearer (OAuth 2)

PSU-Accept-Languagestring

Response language accepted by final client (PSU). English by default

PSU-IP-Addressstring required

IP address of the final client (PSU).

PSU-User-Agentstring

User-agent of the final client (PSU).

Request body

optIdstring

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 !.

walletPayerstring

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.

walletReceiverstring

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.

totalAmountstring 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
commissionAmountinteger

Your Fee Amounts are given as integer numbers in cents

commentstring

Comment Regarding the Transaction

returnUrlstring

URL redirection after the payment procedure is successfully finished

cancelUrlstring

URL redirection after the payment procedure is cancelled

errorUrlstring

URL edirection after the payment procedure is failed

firstNamePayerstring

Payer's First Name If this field is not filled then the end-user have to fill it in the payment form

lastNamePayerstring

Payer's Last Name If this field is not filled then the end-user have to fill it in the payment form

emailPayerstring

Payer's Email If this field is not filled then the end-user have to fill it in the payment form

stylestring

Link to a custom CSS Stylesheet The stylesheet should be publicly accessible via *HTTPS

atosStylestring
notifUrlstring

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.

optionsstring

Reserved for a future version

Example request

{
  "optId": "Order1234",
  "walletPayer": "8888",
  "walletReceiver": "9999",
  "totalAmount": "500-1000",
  "commissionAmount": 100,
  "comment": "Commande numéro 245",
  "returnUrl": "http://YourCompany.com/ThankYou",
  "cancelUrl": "http://YourCompany.com/PleaseComeBackLater",
  "errorUrl": "http://YourCompany.com/Sorry",
  "firstNamePayer": "Jean",
  "lastNamePayer": "DUPONT",
  "emailPayer": "jean.dupont@email.com",
  "style": "https://sandbox-webkit.lemonway.fr/demo/dev/payment-page/css/main.css",
  "atosStyle": "https://YourCompany.com/public/atos.css",
  "notifUrl": "http://login:pass@YourCompany.com/notif/?origine=lemonway&orderId=135"
}

Response

OK