UnionPay, ook bekend als China UnionPay (CUP), is een kaartsysteem dat actief is op het Chinese vasteland en in Oost- en Zuidoost-Azië. SecurePay is een dienst van UnionPay die de browser van de kaarthouder tijdens het afrekenproces naar hun servers leidt, waar zij vóór de aankoop worden geverifieerd en gevraagd worden hun kaartgegevens in een beveiligde omgeving in te voeren. Klanten kunnen ook de QR-code scannen die op de betaalpagina wordt weergegeven met een UnionPay-app of andere ondersteunde apps. Na de betaling wordt de klant teruggeleid naar uw website en ontvangt u een bevestiging via een URL-kennisgeving.
| Ondersteunde landen | Alle landen die UnionPay-kaarten uitgeven, met uitzondering van gesanctioneerde landen. |
| Ondersteunde munteenheden | AUD, CAD, CHF, CNY, EUR, GBP, HKD, JPY, NZD, SGD, USD |
| Terugbetalingen |
Volledige en gedeeltelijke terugbetalingen zijn toegestaan tot 6 maanden. |
| Terugboekingen |
Betalingen kunnen worden teruggevorderd. |
| Zero-authorisation |
Niet ondersteund. |
| Terugkerende betalingen |
Niet ondersteund. |
Configuratie
- Neem contact op met uw accountmanager om deze betaalmethode op uw account in te schakelen.
Er wordt een testzandbakaccount verstrekt, die u nodig hebt om uw implementatie te testen. - Wijzig uw POST naar Payment Pages indien nodig:
Naam van het veld Vereist tijdens betaalsessie
(hetzij opgenomen in POST door handelaar of ingevoerd door klant op Payment Pages)
Vereist in POST Beschrijving billingcountryiso2a Ja Geen Het voor het factuuradres ingevoerde land, in ISO2A-formaat. billingfirstname Ja Geen De Voornaam facturatie. billinglastname Ja Geen De Achternaam facturatie. ruleidentifier Geen Geen Als uw POST naar de Payment Pages al alle door de betaalmethode vereiste velden bevat, kunt u het afrekenproces voor de klant stroomlijnen door ook ruleidentifier=STR-14 in te dienen.
Hierdoor kan de browser van de klant onmiddellijk naar de door de betaalmethode gehoste pagina's gaan om de transactie te voltooien. (Wij noemen dit Journey C)
Meldingen
Zodra een betaling is geautoriseerd, wordt het geld op een later tijdstip verrekend, zoals bepaald door UnionPay.
De afwikkeling kennisgeving mag niet onmiddellijk na de verwerking van de betaling worden verzonden.
In het onwaarschijnlijke geval dat de betaling na 7 dagen nog steeds in behandeling is afwikkeling (settlestatus "10"), wordt dit ingepland voor onderzoek en nemen wij contact met u op met nadere informatie.
Voordat u begint met testen, raden wij u aan contact op te nemen met ons Support Team en te verzoeken dat regels worden ingeschakeld op uw account, die URL-kennisgevingen naar uw systeem sturen in de volgende scenario's:
- Wanneer een betaling is goedgekeurd.
- Als de fondsen vereffend zijn.
Configuratie van de autorisatie melding
Wij raden u aan ten minste de volgende velden op te nemen in uw autorisatie kennisgeving:
- Antwoordbericht aankoper (acquirerresponsemessage)
- Basisbedrag (baseamount) (b.v. €10,50 is "1050")*.
- Hoofdbedrag (mainamount) (b.v. €10,50 is "10.50")*
- Land facturatie (billingcountryiso2a)
- Munt (currencyiso3a)
- Foutcode (errorcode)
- Live Status (livestatus)
- Referentie bestelling (orderreference)
- Betalingstype (paymenttypedescription)
- Verzoektype (requesttypedescription)
- Status betaling (settlestatus)
- Site referentie (sitereference)
- Transactiereferentie (transactionreference)
- Tijdstempel start transactie (transactionstartedtimestamp)
*Kies uw voorkeursformaat.
Configuratie van de afwikkeling melding
Wij raden u aan de volgende velden op te nemen in uw afwikkeling kennisgeving:
- Status betaling (settlestatus)
- Site referentie (sitereference)
- Transactiereferentie (transactionreference)
Controleer de kennisgeving
U moet de inhoud van elke ontvangen kennisgeving controleren en dienovereenkomstig reageren door de procedures te volgen die in onze URL-kennisgevingen documentatie. In het bijzonder moet u kijken naar de bijgewerkte settlestatus waarde:
- Op autorisatie: Als de settlestatus "0", "1" of "10" is, is de betaling geautoriseerd en hoeft u op dit moment geen verdere actie te ondernemen. Waarden van "2" of "3" geven echter aan dat de fondsen niet gepland voor vereffening (respectievelijk opgeschort en geannuleerd).
- Op afwikkeling: Als de settlestatus is bijgewerkt tot "100", betekent dit dat het geld is vereffend. Als dit is bijgewerkt tot "3", is er een probleem geweest en is de betaling geannuleerd.
Geannuleerde transacties (settlestatus "3") kunnen op een later tijdstip worden afgewikkeld. In situaties waarin de klant de vereiste stappen heeft voltooid om de betaling uit te voeren, wordt de settlestatus wordt bijgewerkt tot "100" om aan te geven dat het geld naar uw rekening is overgemaakt.
Als u contact hebt opgenomen met het Support Team om afwikkeling meldingen te configureren (zoals hierboven beschreven), wordt u op de hoogte gebracht wanneer dit gebeurt.
Test
U moet uw oplossing testen voordat u live betalingen kunt gaan verwerken. Testtransacties worden verwerkt via uw test site referentie.
Vereisten
U moet contact opnemen met ons Support Team en uw UnionPay test account gegevens doorgeven. Wij zullen dan uw test site referentie configureren om rechtstreeks verbinding te maken met de UnionPay testomgeving.
Bij het uitvoeren van testtransacties wordt uw browser omgeleid naar de UnionPay testomgeving om een betaling te simuleren. Verder verloopt het proces precies hetzelfde als bij live betalingen.
Terugbetalingen
Na het verwerken van een betaling is het mogelijk om de klant terug te betalen via Portal.
Terugbetalingen voor UnionPay worden onmiddellijk verrekend (settlestatus "100").
Vereisten
- U kunt een betaling niet terugbetalen totdat de AUTH is vereffend (settlestatus is "100").
- U kunt geen groter bedrag terugbetalen dan oorspronkelijk werd verrekend.
