PayArc Terminal-betaalgateway
PayArc Terminal stuurt een verkoop vanaf de kassa naar een PayArc PAX-terminal. De klant betaalt op de terminal en de kassa registreert de betaling zodra PayArc deze bevestigt.
Deze pagina begint bij het gebruik aan de kassa. Hoe je de betaalgateway instelt, lees je onder PayArc Terminal instellen.
Voor PayArc Terminal heb je WCPOS Pro 2.0 of hoger nodig.
Een kaartbetaling ontvangen
Als De kassa openen en sluiten is ingeschakeld, registreert de kassa geen betalingen zolang deze gesloten is. Een kaartbetaling die je al hebt ontvangen, zou je dan moeten terugbetalen. Zie Kassa's voor deze instelling.
Druk op Afrekenen in de winkelwagen. PayArc Terminal staat als tegel op het tabblad Betalingen, naast je andere betaalmethoden.
- Tik op de tegel PayArc Terminal.
- Controleer de terminal die boven het toetsenblok staat: Terminal: …. Heb je meerdere terminals, druk dan op Wijzigen en tik op de terminal bij jouw balie. De kassa onthoudt je keuze voor de volgende keer.
- Wil je een deel van het openstaande bedrag per kaart ontvangen, voer dan het bedrag in. De rest blijft openstaan voor een andere betaling.
- Druk op … naar PayArc Terminal sturen. De kassa toont Op de terminal met vier stappen: Verzonden, Op terminal, Goedgekeurd en Geïnd.
- De klant betaalt op de terminal. Zodra de betaling is geïnd en er niets meer openstaat, wordt de bon geopend. Staat er nog een bedrag open, ontvang dat dan via een andere tegel.
Met Details, onder de stappen, open je een logboek van de betaling: wanneer deze is verzonden, wanneer deze de terminal bereikte en welk bedrag is goedgekeurd. Bij de betaling worden het kaartmerk, de laatste 4 cijfers, de manier waarop de kaart is gelezen en de autorisatiecode van PayArc opgeslagen.
De terminal vraagt niet om fooi. Zie Fooien voor de terminals die dat wel doen.
Een betaling annuleren
Druk op Annuleren op terminal voordat de klant betaalt. De kassa wacht op bevestiging van de terminal en toont daarna Betaling geannuleerd.
Als de kaart al wordt gelezen, kan PayArc de annulering weigeren en de betaling afronden. De kassa blijft controleren en toont het resultaat. Tijdens het wachten verschijnt Annuleren — wachten op bevestiging van de terminal en kun je kiezen voor Deze betaling vrijgeven. Daarmee geef je de bestelling vrij om op een andere manier te betalen, terwijl je winkel de terminal blijft controleren.
Vrijgeven annuleert de betaling niet: de terminal kan deze nog steeds ontvangen. Controleer het resultaat op de terminal voordat je een andere betaling ontvangt.
Als er iets misgaat met een betaling
Heeft de terminal een ander bedrag bevestigd? Ontvang de betaling niet opnieuw. Controleer eerst de terminal, de bestelling en het PayArc-dashboard.
Betaling mislukt: kaart geweigerd
Druk op Opnieuw proberen om de betaling opnieuw naar de terminal te sturen, of op Een andere betaalmethode kiezen om via een andere tegel te betalen.
Betaling mislukt, met een melding van PayArc zelf
PayArc heeft de verkoop geweigerd, bijvoorbeeld omdat de terminal uitstaat of niet online is. Controleer de terminal en druk daarna op Opnieuw proberen.
Wachttijd verstreken — betaling geannuleerd
Er is niet binnen 5 minuten betaald, of de terminal wachtte op een kaart die niet werd aangeboden. Controleer de terminal en druk daarna op Opnieuw proberen.
De tegel PayArc Terminal is grijs weergegeven
Onder de tegels geeft de kassa aan waarom. Zie Wanneer een tegel niet kan worden gebruikt voor alle redenen.
- Geen terminals ingesteld voor PayArc Terminal — de winkel heeft geen terminal voor deze betaalgateway. Een beheerder voegt er een toe in stap 4 van PayArc Terminal instellen.
- In gebruik door bestelling #… — de terminal is bezig met een betaling voor een andere bestelling. Rond die af of annuleer deze, of druk op Wijzigen en kies een andere terminal.
- Verbinding nodig — de kassa is offline. Een terminalbetaling loopt via je winkel, dus ontvang een ander soort betaling of wacht tot er weer verbinding is.
Verbinding instabiel, we blijven het proberen
Dit verschijnt in het logboek onder Details. De kassa blijft controleren. Laat het scherm open: de betaling gaat door op de terminal.
Een betaling zit vast, of de kassa meldt dat de aanbieder niet heeft geantwoord
Een betaling blijft te lang wachten
- Controleer het scherm van de terminal en houd het betaalscherm open
- Na 5 minuten stopt de kassa en verschijnt Wachttijd verstreken — betaling geannuleerd
- Controleer de terminal, de bestelnotities en het PayArc-dashboard voordat je de betaling opnieuw ontvangt
Een eerdere PayArc Terminal-betaling voor deze bestelling kan niet worden uitgelezen met de huidige PayArc-inloggegevens
- Ontvang de betaling op een andere manier of vraag een beheerder om hulp. De bestelling bevat een betaling van vóór een wijziging van de modus of de inloggegevens
- De beheerder controleert die betaling in het PayArc-dashboard in de modus waarin deze is ontvangen
- Om PayArc weer voor deze bestelling te gebruiken, zet de beheerder PayArc terug naar die modus en klikt op Verbinden met deze inloggegevens. Daarna laad je de pagina opnieuw
Een PayArc-betaling terugbetalen
Een terugbetaling gaat terug naar de terminal die de verkoop heeft verwerkt, voor het volledige bedrag of een deel ervan.
- Open in de POS de terugbetaling voor de bestelling. Zie Terugbetalingen.
- Kies Terugbetalen via PayArc Terminal en druk op Terugbetaling verwerken.
- PayArc stuurt de terugbetaling naar de terminal, waar deze wordt goedgekeurd of geweigerd. De terugbetaling blijft in behandeling totdat de terminal antwoordt. Het resultaat wordt aan de bestelnotities toegevoegd.
Een terugbetaling in WP Admin via de WooCommerce-knop … terugbetalen via PayArc Terminal werkt op dezelfde manier.
Blijft een terugbetaling in behandeling, controleer dan het PayArc-dashboard voordat je opnieuw terugbetaalt.
Als PayArc niet op een terugbetaling reageert
Je winkel doet elke 2 minuten opnieuw een verzoek, maximaal 5 keer, met dezelfde verzoeksleutel. Daardoor behandelt PayArc elke nieuwe poging als dezelfde terugbetaling. Als er dan nog geen antwoord is, krijgen medewerkers de melding dat ze het PayArc-dashboard moeten controleren.
Betalingen die met een oudere versie zijn ontvangen
Deze PayArc-betaling is ontvangen via het eigen order-pay-paneel van de plugin. De betaling is ontvangen met versie 0.1 van de extensie, van vóór WCPOS 2, dus de betaalgateway kan deze niet terugbetalen. Betaal deze terug in het PayArc-dashboard of op de terminal en registreer dit daarna in WooCommerce met … handmatig terugbetalen.
PayArc Terminal instellen
Een beheerder stelt de betaalgateway eenmalig in via WP Admin en kiest daarna op elke kassa een terminal.
Voordat je begint: wat je nodig hebt
Vereisten
PayArc verstrekt je MID, ClientSecret en SecretKey, en het serienummer van een terminal die voor je is ingesteld.
Je winkel bereikt elke terminal via PayArc over het internet. Je hoeft dus niets te koppelen en elke kassa kan al je terminals gebruiken. Zonder WCPOS Pro 2.0 of hoger toont de extensie een melding in WP Admin en voegt deze niets toe aan de POS.
Zes stappen: installeren, verbinden, je terminal toevoegen, inschakelen en voor elke kassa een terminal kiezen
PayArc Terminal for WooCommerce installeren
Download payarc-terminal-for-woocommerce.zip, versie 1.0 of hoger, vanaf de GitHub-releasepagina en upload het bestand via Plugins > Add Plugin en vervolgens Plugin uploaden. Activeer de plugin.
Onder WP Admin > POS > Settings > Extensions staat mogelijk nog versie 0.1, die vóór WCPOS 2 is gemaakt. Controleer de versie voordat je de plugin vanaf die plek installeert.
Je PayArc-inloggegevens invoeren
- Ga naar
WP Admin > WooCommerce > Settings > Paymentsen open PayArc Terminal - Kies Modus:
Liveis de standaardinstelling. GebruikTestalleen met inloggegevens voor het PayArc-testdashboard en de PayArc Connect Test-app. Gebruik nooit verschillende omgevingen door elkaar - Vul PayArc-inlog-e-mailadres in: het e-mailadres waarmee je inlogt op je PayArc-handelaarsdashboard
- Vul PayArc MID uit het PayArc Merchant Profile in, niet de terminal-ID
- Vul PayArc ClientSecret uit het API-gedeelte van het dashboard en PayArc SecretKey / API-bearertoken uit het PayArc-dashboard in
- Laat Callback-bearertoken leeg, tenzij de ondersteuning van PayArc er een heeft verstrekt
Verbinden
Klik op Verbinden met deze inloggegevens. Als dit lukt, verschijnt Verbonden met PayArc en wordt je gevraagd het serienummer van de terminal in te voeren of te bevestigen en op te slaan. Als de melding aangeeft dat de inloggegevens bij de andere omgeving lijken te horen, wijzig dan Modus en maak opnieuw verbinding.
Klik na elke wijziging van Modus of een inloggegeven opnieuw op Verbinden met deze inloggegevens en sla daarna op. Zodra PayArc Terminal in WCPOS is ingeschakeld (stap 5), verschijnt bij het opslaan een foutmelding zolang je dit niet hebt gedaan. Terwijl een betaling op een terminal wordt verwerkt, kun je de modus, de inloggegevens en de verbinding niet wijzigen.
Je terminal toevoegen
- Vul bij Serienummer van terminal het PAX-serienummer in van het label S/N op de achterkant van het apparaat, zoals PayArc dit voor je account heeft ingesteld
- Kies Kaarttype en Bon afdrukken
- Controleer of de Webhook-URL HTTPS gebruikt. Geef deze alleen aan PayArc als ze erom vragen
- Klik op Wijzigingen opslaan
De kassa biedt deze terminal aan, plus elke terminal die volgens het terminalregister van PayArc voor je account is ingeschakeld. Met Verbinden wordt het register opgehaald; met Terminals vernieuwen wordt het opnieuw opgehaald. Een terminal die PayArc als uitgeschakeld markeert, wordt niet aangeboden, ook niet als je het serienummer ervan hebt ingevoerd. Een ingevoerd serienummer dat niet in het register staat, wordt wel aangeboden. Voor de live modus is een HTTPS-site vereist.
Inschakelen in WCPOS
- Ga naar
WP Admin > POS > Settings > Checkout - Zoek PayArc Terminal in de lijst en zet de schakelaar Ingeschakeld aan
- De tegel verschijnt bij de kassa zodra de pagina opnieuw wordt geladen
Dit is de enige schakelaar. De schakelaar Ingeschakeld in de lijst Betalingen van WooCommerce heeft geen effect en PayArc Terminal wordt nooit aangeboden bij het afrekenen in je webshop. Zie Kassa-instellingen.
Voor elke kassa een terminal kiezen
Open op elke kassa Instellingen > Kaartlezers. Je PayArc-terminals staan onder Slimme kaartlezers, elk op een eigen regel en allemaal gemarkeerd als Online: PayArc geeft niet door of een terminal aanstaat. Druk op Deze kaartlezer gebruiken bij de terminal aan die balie. Op de bijbehorende regel verschijnt Geselecteerd. De kassamedewerker kan bij het afrekenen nog steeds op Wijzigen drukken.
Met maar één PayArc-terminal hoef je niets te kiezen: deze is op elke kassa al Geselecteerd. Staat er op een regel Ingesteld door de winkel, dan zijn de kassa's vast ingesteld op de standaardterminal van de winkel. Zie Een slimme kaartlezer kiezen.
Overzicht van instellingen
Alles op de pagina van de betaalgateway onder WP Admin > WooCommerce > Settings > Payments > PayArc Terminal.
Alle instellingen van PayArc Terminal
| Instelling | Functie |
|---|---|
| Titel | De naam van de tegel bij de kassa; standaard PayArc Terminal |
| Beschrijving | De beschrijving van de betaalmethode; standaard Pay in person at a PayArc PAX terminal. |
| Modus | Live (standaard) of Test. Voor Test zijn inloggegevens voor het PayArc-testdashboard en de PayArc Connect Test-app nodig |
| PayArc-inlog-e-mailadres | Het e-mailadres waarmee je inlogt op je PayArc-handelaarsdashboard; vereist voordat je verbinding maakt |
| PayArc MID | De handelaars-MID uit je PayArc Merchant Profile, niet de terminal-ID |
| PayArc ClientSecret | De geheime sleutel uit het API-gedeelte van het dashboard; wordt alleen op je server opgeslagen |
| PayArc SecretKey / API-bearertoken | Het token uit het PayArc-dashboard, gebruikt om in te loggen en het terminalregister uit te lezen |
| Callback-bearertoken | Optioneel. Vul dit alleen in als de ondersteuning van PayArc er een heeft verstrekt |
| PayArc-verbinding | De knoppen Verbinden met deze inloggegevens, Terminals vernieuwen en Verbinding verbreken |
| Serienummer van terminal | Het PAX S/N dat PayArc voor je account heeft ingesteld. Vereist voor betalingen |
| Kaarttype | CREDIT (standaard) of DEBIT |
| Bon afdrukken | Afdrukken op de terminal: 0 - No receipt (standaard), 1 - Merchant receipt, 2 - Customer receipt of 3 - Both receipts |
| Webhook-URL | Alleen-lezen callbackadres. Controleer of het HTTPS gebruikt; geef het alleen aan PayArc als ze erom vragen |
| PayArc-diagnostiek | Verbindingsinformatie en een knop Instellingen valideren; geheime gegevens worden nooit getoond |
Van opgeslagen geheime gegevens worden alleen de laatste 4 tekens getoond. Laat een veld voor geheime gegevens leeg om de opgeslagen waarde te behouden.
De tabel PayArc-diagnostiek toont de modus, de PayArc-eindpunten, of het inlog-e-mailadres en het Connect-toegangstoken zijn ingesteld, een gemaskeerde MID, tenant-ID en terminalserienummer, het aantal gevonden terminals, de Webhook-URL, het tijdstip van de laatste callback en de laatste PayArc-fout. Instellingen valideren controleert de opgeslagen instellingen en vermeldt wat er ontbreekt.
Verbinding verbreken wist de opgeslagen PayArc-verbinding, de terminallijst en het Serienummer van terminal. Je inloggegevens blijven bewaard, zodat je snel opnieuw verbinding kunt maken. Controleer het serienummer voordat je opslaat.
Logboeken
Stuur het bestelnummer en de relevante logregels mee wanneer je om hulp vraagt.
Logboeken vinden voor ondersteuning
Je vindt de logboeken onder WooCommerce > Status > Logs, bij de bron payarc-terminal-for-woocommerce. Identificatiegegevens worden gemaskeerd en geheime gegevens worden verwijderd.
Je kunt geen ondersteuningsbundel downloaden. Deel geen volledige MID's, terminal-ID's, tokens of kaartgegevens.
Mogelijkheden en beperkingen
- Geen fooien op de terminal
- Een terminal verwerkt één betaling tegelijk. Terwijl deze bezig is, zien andere kassa's In gebruik door bestelling #…
- De ondersteunde valuta zijn beperkt tot USD, CAD, GBP, EUR en JPY
- De verbinding geeft niet door of een terminal aanstaat: een verkoop naar een offline terminal mislukt direct, zonder dat er iets naar de terminal wordt gestuurd
- Betalingen die met versie 0.1 van de extensie zijn ontvangen, betaal je terug in PayArc, niet via de betaalgateway
- Een terugbetaling gaat naar de terminal die de verkoop heeft verwerkt
Als er iets misgaat bij het instellen
Veelvoorkomende problemen
Dit lijken PayArc-inloggegevens voor Test (of Live)
- De geselecteerde modus en de inloggegevens horen bij verschillende PayArc-omgevingen
- Zet Modus op de modus die in de melding wordt genoemd, of vervang de inloggegevens door die voor de geselecteerde modus
- Klik opnieuw op Verbinden met deze inloggegevens en sla op
Kan geen verbinding maken met PayArc
- PayArc heeft de aanmelding geweigerd. Controleer de ingevoerde inloggegevens en probeer het opnieuw
- Kijk onder
WooCommerce > Status > Logs, bij de bronpayarc-terminal-for-woocommerce, voor details
De callback-URL moet HTTPS gebruiken voordat je de Live-modus inschakelt
- Voor de Live-modus moet je site HTTPS gebruiken, zodat PayArc de Webhook-URL kan bereiken
- Zet de site over naar HTTPS of gebruik de modus Test op een testsite
Het terminalregister is leeg
- De kassa biedt dan alleen de terminal aan die is ingevuld bij Serienummer van terminal. Betalingen naar die terminal blijven werken
- Vraag PayArc om dat serienummer voor je account te bevestigen en je andere terminals aan het register toe te voegen als je wilt dat de kassa die aanbiedt
- Klik op Terminals vernieuwen nadat PayArc ze heeft toegevoegd
PayArc heeft zowel het Connect AccessToken als de SecretKey geweigerd
- PayArc heeft toegang tot de transactie-API voor je account geweigerd
- Vraag de ondersteuning van PayArc om te bevestigen dat PayArc Connect V3 is ingeschakeld voor je handelaarsaccount en welk inloggegeven toegang geeft tot de transacties
Hulp krijgen
- Voeg het bestelnummer en de relevante logregels toe aan je ondersteuningsverzoek
- Bezoek de GitHub-repository om problemen te melden
- Neem contact op met de ondersteuning van PayArc voor je account, PayArc Connect en het instellen van terminals