This is the regular and simple payment process.
This function returns a URL link for the Transaction Form
URL:
https://sandbox.meshulam.co.il/api/light/server/1.0/createPaymentProcess,
return value: a url that contain link for the Transaction Form + Processid + processToken.
apiKey userId, pageCode parameters would be provided by Grow during the API initial setting.
successUrl: Must include one parameter per request.
successUrl and cancelUrl:
- If using iFrame make sure to use HTTPS and not HTTP.
- Must use an external URL and not localhost.
The flow is as following:
Important Notes
- The URL will be valid for 10 min.
- The payment will go through even if you did not Approve Transaction.
- Due to URL length restrictions in the browser, restricted to 2000 characters, it is possible that not all Optional fields would return on requesting the Thank You page. ( On a request made to the server all fields will return).
- The successUrl and the optional fields must contain valid characters. In case you are interested in sending different parameters, it is recommended that you would use encryption of base64 or a similar one to it.
- In case of using Post Message, the successUrl and cancelUrl are not required.
- In case you wish the link to open up in a new tab, you must open the link in a new tab and not in the same tab (window.open).
- In case of using iFrame, please see iFrame section. iframe info
- It is required that you save the Id and token within your system, as you will need it for every transaction request that will be made, for instance, refund a transaction.
- You can set a webhook that will receive the invoice from the payment process. The address should be sent in the invoiceNotifyUrl param. See here for more details about the webhooks.