Web Uploads Integration Guide for Gini Pay API

App! Web! Why not both?

This guide is for our banking customers who have already integrated Gini Bank SDK into their mobile platforms and are now looking to extend that functionality to their website. It covers the key considerations for enabling website uploads, along with steps to integrate Return Assistant and Skonto features.

Key Considerations for Website Uploads

Before integrating web uploads with Gini Pay API, ensure the following:

1. Dedicated Credentials for Web Uploads

Web integrations require separate credentials from mobile integrations.
This ensures better security, analytics, reporting and performance tracking.
Read more on setting up dedicated credentials.

2. Test Authentication & API Access

Ensure your website can securely authenticate users with the correct API credentials.
Implement OAuth 2.0 or the preferred authentication mechanism.
See API authentication guide.

3. Upload Workflow & Supported File Types

The API supports specific file types (e.g., PDFs, images).
Users should be guided on how to upload files correctly from the website.
Consider implementing a drag-and-drop uploader or a simple file selection option.
Check the API documentation for supported file formats.

4. Security Considerations

Implement CORS policies to allow uploads only from your website.
Ensure secure handling of user data and compliance with privacy regulations.
Refer to security best practices.

Integrating Additional Features

Return Assistant and Skonto can be integrated in your website as well. Below are the initial steps to take on your journey to enable one or both of these features.

1. Return Assistant

Return Assistant helps users manage and process ordered items on their invoice to be returned efficiently. The RA screen has toggles to turn on or off, for each ordered item on the invoice, if turned off the amount is directly deducted from the amount to pay and vice versa, when the toggle is on, the amount to pay calculates that item in the total amount to pay.

Contact Gini to enable Return Assistant in your API credentials.
Implement return workflows based on Gini’s recommended logic.
Ensure the website interface provides an easy way for users to trigger return requests for items they are returning.
See the Return Assistant guide.

2. Skonto (Early Payment Discount)

Skonto allows users to apply early payment discounts directly within the payment flow. The Skonto discount is automatically detected and presented to the user. The user has the ability to turn off the feature or turn it on even if the time for early payment has expired. Amount to pay is automatically calculated and the user is shown the amount they will be saving by paying early.

Ensure your API calls correctly passes invoice data with discount information.
Validate eligibility for Skonto based on invoice parameters.
Configure the UI to show applicable discounts.
See the Skonto integration guide.

Next Steps

Test your web upload integration using your POC credentials (dev/test credential set) issued by Gini. Please reach out to Gini’s Technical Support or get in touch with Technical Account Manager (TAM) for assistance.
1. We recommend a QA session - a session to jointly test the flow and validate the feedback is received properly.
Ensure all necessary configurations (authentication, file handling, error handling and security) are in place.
Checkout our UX sample and recommendations section to get started faster.
Reach out to Technical Support or your Technical Account Manager (TAM) for further assistance.
Gini can help monitor analytics and suggest optimization based on user feedback.

For more detailed information, refer to the full Gini Pay API documentation.