API Reference

Overview

This API initiates a standard payment process and returns a secure URL for the transaction form.

The apiKey, userId and pageCode parameters are provided by Grow during the onboarding process

The flow:



Important Notes

  1. The URL will be valid for 10 min.
  2. The transaction will be processed even if the Approve Transaction request is not executed or fails.
  3. 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).
  4. 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.
  5. In case of using Post Message, the successUrl and cancelUrl are not required.
  6. In case of using iFrame, please see iFrame section. iframe info
  7. To receive the invoice via webhook, set the invoiceNotifyUrl parameter with your endpoint.
  8. The successUrl and cancelUrl must point to external URLs. localhost is not allowed.
  9. When using an iFrame, ensure that the URL uses HTTPS rather than HTTP.

📘

Important

Only server-side requests are allowed. Any client-side (browser-based) requests will be blocked.