Payments in Gecko allow you to take payments through your forms and events using your existing payment provider. Before getting started, you'll first need to connect either Flywire or TouchNet to your Gecko account.
Setting up your integration
Head to Settings > Integrations and create a new integration. Select either Flywire or TouchNet, depending on the payment provider your institution uses.
You'll then need to configure the following:
Payment Destination - Provided by your payment provider.
Shared Secret - Provided by your payment provider.
Environment - Choose whether you're connecting to your Production or Demo payment environment.
Expiry Minutes - How long a pending, failed or cancelled payment can remain active before Gecko moves it to Expired.
Currency - The currency Gecko will use when sending the payment amount to your provider.
Integration Name - Give your integration a clear internal name so it's easy to identify when building your payment forms.
đĄ We recommend an expiry window of 24 hours. This gives students, including those making international payments, plenty of time to complete their payment while preventing abandoned payments from reserving event spaces indefinitely.
Currency
The currency selected on your integration determines the currency Gecko uses when sending the payment amount to Flywire or TouchNet.
â
For example, if your integration uses GBP and an event costs ÂŁ25, Gecko will send a ÂŁ25 charge to your payment provider.
Any currency conversion available to the student is handled by Flywire or TouchNet. This means an international student may still be able to complete their payment using their local currency, depending on the options supported by your payment provider.
You can create multiple payment integrations if you need to support different currencies or payment configurations.
Once you've saved your integration, you're ready to start creating chargeable items and adding payments to your forms and events đ¸
đ Troubleshooting
What happens if I need to refund a payment or someone cancels?
Refunds are processed directly through your payment provider rather than within Gecko.
Once the refund has been processed by your payment provider, the payment status in Gecko will update to Failed. If the payment was linked to an event registration, the contactâs attendance will also be removed from the event.
Can I use multiple currencies on a single form?
No. A form can only use one currency.
If you need to accept payments in different currencies, youâll need to create separate forms and configure the relevant Chargeable Item with the appropriate currency on each form.
Currency conversion is handled by your payment provider. Where supported by your provider, international payers may be able to pay in their local currency during the payment process.
Does someone have to pay for every Chargeable Item on a form?
Yes. Currently, if multiple Chargeable Items are added to a form, the payer will be required to pay for all of them.
If you have a use case that requires optional or selectable Chargeable Items, please book some time with the Gecko Product team to discuss your requirements.
Where can I find the credentials needed to set up my payment integration?
Your integration credentials are provided by your payment provider rather than Gecko.
If youâre unsure where to find the required information, we recommend contacting your Flywire or TouchNet account manager directly. Theyâll be able to provide the credentials needed to complete your integration setup.
Any questions? Start a live chat with a support team member, or feel free to explore the rest of our academy. Spotted an error or want to suggest a future article for the academy? Let us know here.