Betalingen ontvangen met Global Payments
Global Payments is een internationale betaaldienstverlener die compatibel is met Desjardins (Québec). Uw gebruikers betalen met hun bankkaart op een beveiligde betaalpagina van Global Payments. Deze pagina verzorgt ook de 3-D Secure-verificatie. De kosten zijn die van uw contract met Global Payments: OpenResa rekent geen commissie op deze betalingen.
Vereisten
Om echte betalingen te ontvangen, heeft uw organisatie een merchantaccount bij Global Payments nodig, bijvoorbeeld via Desjardins in Québec. Uw accountmanager geeft u dan twee gegevens die bij uw applicatie horen: een App ID en een App Key.
Wilt u de betaalgateway uitproberen voordat u tekent? Maak dan gratis een account aan op het ontwikkelaarsportaal van Global Payments (developer.globalpayments.com). Daar wordt een testapplicatie aangemaakt, met een eigen App ID en een eigen App Key.
Global Payments instellen op een factureringsaccount
Elk factureringsaccount heeft een eigen betaalgateway: u kunt Global Payments voor een deel van uw activiteiten gebruiken en de andere activiteiten op een ander account laten.
- Ga naar Administratie›Instellingen›Facturatie›Factureringsaccounts, open het betreffende factureringsaccount en ga naar het tabblad Betalingen.
- Schakel Online betalingen in en kies Global Payments in de lijst met betaalgateways.
- Plak uw App ID en uw App Key. De App Key wordt versleuteld opgeslagen en wordt nooit meer volledig getoond.
- Laat API-adres op
apis.globalpay.comstaan. Kiesapis.eu.globalpay.comalleen als Global Payments u dat heeft aangegeven. - Laat Accountnaam leeg: OpenResa kiest zelf welk account wordt gebruikt (zie verderop).
- Vink Testomgeving (sandbox) aan als u de gegevens van een testapplicatie invoert.
- Klik op Opslaan en daarna op Verbinding testen.
U hoeft geen meldingsadres in te stellen in uw Global Payments-omgeving: OpenResa geeft bij elke betaling zelf zijn retouradressen door. Een link Online hulp in het formulier herhaalt deze stappen.
Meldt de test dat de gegevens worden geweigerd? Controleer dan eerst het vakje van de testomgeving: testgegevens werken alleen als het vakje is aangevinkt, en productiegegevens alleen als het vakje niet is aangevinkt.
Het verwerkingsaccount kiezen
Een Global Payments-applicatie kan meerdere accounts voor betalingsverwerking bevatten. Als Accountnaam leeg is, kiest OpenResa het enige beschikbare account. Zijn er meerdere, dan kiest OpenResa het enige account dat voor de betaalpagina is bedoeld, waarvan de naam eindigt op _hpp. De verbindingstest toont u het gekozen account, bijvoorbeeld Verbinding met Global Payments OK — verwerkingsaccount automatisch geselecteerd: transaction_processing_hpp.
Kan OpenResa niet zelf kiezen, dan toont het testbericht de beschikbare accounts. Neem de naam van het account dat Global Payments u heeft aangegeven over in Accountnaam, sla op en voer de test opnieuw uit.
Uitproberen in de testomgeving
Met de gegevens van een testapplicatie en het vakje Testomgeving (sandbox) aangevinkt, zijn de betalingen fictief: er wordt geen kaart belast, en betaalde bestellingen leveren facturen op uit de reeks SPECIMEN, zonder boekhoudkundige waarde.
Voor een testbetaling betaalt u een bestelling met de Visa-testkaart 4263970000005262, de vervaldatum 05/39 en de beveiligingscode 599: de betaling wordt geaccepteerd. Andere testkaarten staan beschreven in de documentatie van Global Payments.
Om naar productie over te stappen, vervangt u de App ID en de App Key door uw productiegegevens. Vink het vakje uit, sla op en voer de verbindingstest opnieuw uit.
De betaling aan de kant van de gebruiker begrijpen
Bij het betalen kiest de gebruiker Online betaling, weergegeven met de vermelding via Global Payments. Daarna wordt hij doorgestuurd naar de betaalpagina van Global Payments, in het Frans of het Engels afhankelijk van zijn taal. Daar voert hij zijn kaartgegevens in en bevestigt hij, als zijn bank daarom vraagt, met 3-D Secure-verificatie.
Vervolgens keert hij terug naar OpenResa, dat wacht op de bevestiging van Global Payments: het bericht Betaling gevalideerd verschijnt meestal ongeveer tien seconden na de betaling. OpenResa stuurt hem dan, zoals bij elke betaalgateway, de bevestiging en de factuur.
Er gelden enkele regels die specifiek zijn voor Global Payments:
- E-mailadres. Global Payments vereist het e-mailadres van de betaler. De gebruiker moet dus een geldig adres van maximaal 50 tekens hebben, op zijn bestelling of in zijn account. Anders wordt de online betaling geweigerd met het bericht Een geldig e-mailadres is vereist om online te betalen. Controleer uw account.
- Valuta. De betaling gebeurt in de valuta van de bestelling, bijvoorbeeld in Canadese dollars voor een club in Québec. Deze valuta moet in uw Global Payments-account zijn ingeschakeld: anders ziet de gebruiker een melding dat de betaling niet beschikbaar is, en krijgt u na meerdere mislukte pogingen een waarschuwing.
- Eén poging per pagina. Na een geweigerde kaart keert de gebruiker terug naar OpenResa en start hij de betaling opnieuw: er wordt een nieuwe betaalpagina aangemaakt.
De betaalpagina van Global Payments blijft 24 uur geldig. Verlaat de gebruiker de pagina, dan blijft zijn bestelling in afwachting van betaling en kan hij die opnieuw betalen, via Global Payments of via een andere betaalmethode die u aanbiedt.
Een betaling terugvinden
In uw Global Payments-portaal heeft elke betaling een referentie die bestaat uit het bestelnummer, zonder streepjes, en het nummer van de betaalpoging: BJ2026000123T15349533 hoort bijvoorbeeld bij bestelling 2026-000123. Zoek dit bestelnummer op in Administratie›Dashboard›Facturatie›Facturen & transacties om de bestelling te openen.
In de details van de bestelling toont de transactie de Transactie-ID van Global Payments, de Autorisatienummer en de Referentie. De optie Gebeurtenislogboek van het factureringsaccount toont de meldingen die van Global Payments zijn ontvangen en het gecontroleerde resultaat, met de reden van een eventuele mislukking. Op een mislukte regel controleert Opnieuw afspelen de betaling opnieuw bij Global Payments en registreert die als ze is geslaagd.
Een betaling terugbetalen
U start een terugbetaling vanuit Administratie›Dashboard›Facturatie›Facturen & transacties: open de bestelling, klik op Restitutie en kies een volledige of gedeeltelijke terugbetaling. Met de tegel Global Payments werkt OpenResa de bestelling bij en geeft het de terugbetaling door aan Global Payments, dat het bedrag terugstort op de kaart van de betaler.
Een volledige terugbetaling trekt de geleverde onderdelen in (teruggegeven credits, ingetrokken abonnement) en zet de bestelling op terugbetaald. Een gedeeltelijke terugbetaling laat de bestelling betaald en verlaagt alleen het ontvangen bedrag. Global Payments staat niet toe dat u meer terugbetaalt dan het bedrag van de betaling.
Bevestigt Global Payments de terugbetaling niet, bijvoorbeeld bij een storing, dan wordt de bestelling toch bijgewerkt. Een bericht Terugbetaling te controleren bij Global Payments vraagt u dan om in uw portaal te controleren of de terugbetaling goed is uitgevoerd, en die anders alsnog uit te voeren.
