The Wallet SDK provides an innovative and modular solution for rendering a unified payment form that seamlessly consolidates all available payment methods into a single interface.
Its design automatically adapts to any integration, eliminating the need for manual customization or adjustments.
Key Benefits
- Helps boost conversion rates by offering a smoother, more intuitive checkout experience.
- Seamlessly matches the look and feel of the hosting site—no extra design work required.
- Automatically adapts payment options to the user’s device and environment, so you don’t need to handle cross-platform adjustments.
- Supports fast one-click payments through Apple Pay and Google Pay.
API Endpoint Description
When using the Wallet flow, you call the createPaymentProcess endpoint with a dedicated pageCode.
Unlike a standard payment process that returns a redirect URL, this call returns an authCode.
The authCode is then used to launch the Wallet payment form and initiate the transaction.
The request must include the following parameters:
userId – Provided by Grow during the onboarding process.
pageCode – A wallet-specific identifier provided during the integration phase.
Technical Notes
- The authCode generated by this API is valid for 4 minutes. Once the payment form is opened within this timeframe, the form itself remains active for an additional 9 minutes to complete the payment.
- The transaction will be processed even if the Approve Transaction request is not executed or fails.
- Due to URL length limitations in browsers (max 2000 characters), some cField might not be available on the client-side Thank You page.
However, all fields will be available in server-side response.
- Both successUrl and cancelUrl must be valid external URLs. localhost is not supported.
Ensure that all URLs and cField parameters contain valid, encoded characters.
Important -
Only server-side requests are supported.
Client-side (browser-based) requests will be blocked for security reasons.
Process flow:
