Create Payment Form (Pay by Link)

post

https://ws.lemonway.fr/mb/ENVNAME/prod/directkitrest/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:

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)
Payer and Benificary Wallet defined
Benificary pecified

Note: Deferred payment is not supported.

Body Params

optId

string

length between 0 and 60

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

length between 0 and 100

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 SC Wallet here, it won't work. You cannot debit the SC Wallet with a credit card.

walletReceiver

string

length between 0 and 100

Beneficiary Wallet. If this field is not complete, then the end-user must to fill its value on the payment form. We recommend you complete the form instead of your end-user Don't put the SC Wallet here, it won't work. You cannot credit the SC Wallet with a credit card.

totalAmount

string

Amount or a range of the amount to be debited.

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.
If this field is not filled then the end-user can enter any amount to the form.
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

int32

Your Fee Amounts are given as integer numbers in cents

comment

string

length between 0 and 140

Comment Regarding the Transaction

returnUrl

string

length between 0 and 255

URL redirection after the payment procedure is successfully finished

cancelUrl

string

length between 0 and 255

URL redirection after the payment procedure is cancelled

errorUrl

string

length between 0 and 255

URL edirection after the payment procedure is failed

firstNamePayer

string

length between 0 and 255

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

lastNamePayer

string

length between 0 and 255

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

emailPayer

string

length between 0 and 255

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

style

string

length between 0 and 255

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

atosStyle

string

length between 0 and 255

notifUrl

string

length between 0 and 255

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

length between 0 and 255

Reserved for a future version

Headers

Authorization

string

required

Authorization bearer (OAuth 2)

PSU-Accept-Language

string

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

PSU-IP-Address

string

required

IP address of the final client (PSU).

PSU-User-Agent

string

User-agent of the final client (PSU).

Responses

401

Unauthorized

500

InternalServerError

200OK