PayArc Terminal-gateway
Met de PayArc Terminal-gateway kun je via PayArc Connect vanuit WCPOS betalingen op locatie accepteren met een PayArc PAX-terminal. Een betaling wordt gestart vanuit WooCommerce en afgerond op de terminal. De bestelling wordt pas als betaald gemarkeerd nadat PayArc dit heeft bevestigd.
Functies
PAX-terminalintegratie
Verstuur betalingen via PayArc Connect in de cloud naar je PayArc PAX-terminal, zonder lokale koppeling
Geverifieerde afronding
Het bedrag en de valuta moeten vóór afronding overeenkomen met de bestelling; het kaartmerk, de invoermethode en de laatste 4 cijfers worden bij de bestelling opgeslagen
Duidelijke redenen voor weigering
Redenen voor weigering worden getoond aan de kassamedewerker en toegevoegd als bestelnotitie
Terminalbonnen
Druk een bon voor de verkoper, een klantbon of beide af op de terminal
Ingebouwde diagnostiek
Controleer je verbinding met de knop Validate Settings en een diagnosetabel met afgeschermde identificatiegegevens
Zo werkt het
WordPress roept PayArc Connect aan en PayArc maakt verbinding met de PAX-terminal. De POS communiceert alleen met je site. Elke betaling brengt het volledige bestelbedrag in rekening.
De betaalpagina controleert het resultaat elke 1.5 seconden en stopt na 5 minuten. Terugkoppelingen van PayArc naar de Webhook URL versnellen het resultaat; betalingen worden ook zonder terugkoppelingen afgerond via polling. Laat de betaalpagina open terwijl de klant op de terminal betaalt.
Instellen
PayArc Terminal for WooCommerce installeren
Installeer via WP Admin > POS > Settings > Extensions of download het bestand payarc-terminal-for-woocommerce.zip vanaf de GitHub-releasespagina en upload het via Plugins > Add New > Upload Plugin. Activeer de plugin.
Je PayArc-inloggegevens invoeren
- Ga naar
WP Admin > WooCommerce > Settings > Paymentsen open PayArc Terminal - Kies Mode:
Liveis de standaardinstelling. GebruikTestalleen met inloggegevens van het PayArc-testdashboard en de PayArc Connect Test-app. Gebruik nooit gegevens uit verschillende omgevingen door elkaar - Voer PayArc login email in: het e-mailadres waarmee je je aanmeldt bij het PayArc-verkopersdashboard
- Voer PayArc MID in vanuit het PayArc Merchant Profile, niet de terminal-ID
- Voer PayArc ClientSecret in uit het API-gedeelte van het dashboard en PayArc SecretKey / API bearer token uit het PayArc-dashboard
- Laat Callback bearer token leeg, tenzij PayArc Support er een heeft verstrekt; dit veld is optioneel
Verbinden
Klik op Connect using these credentials. Na een geslaagde verbinding vraagt het scherm je het serienummer van de terminal in te voeren of te bevestigen en de instellingen op te slaan. Als wordt aangegeven dat de inloggegevens bij de andere omgeving lijken te horen, wijzig dan Mode en verbind opnieuw.
Klik na elke wijziging van de modus of inloggegevens opnieuw op Connect using these credentials en sla de instellingen op. Betalingen worden geblokkeerd totdat de modus en inloggegevens overeenkomen met de opgeslagen verbinding. Klik bij een upgrade vanaf een versie ouder dan 0.1.14 één keer op Connect.
Je terminal toevoegen
- Voer het PAX-Terminal serial number in dat op het label S/N aan de achterkant van het apparaat staat, zoals PayArc dat voor je account heeft ingesteld
- Kies Tender type en Print receipt
- Controleer of de Webhook URL HTTPS gebruikt. Geef deze alleen aan PayArc als daarom wordt gevraagd
- Klik op Save changes
Voor de Live-modus is een HTTPS-site vereist.
Inschakelen in WCPOS
- Ga naar
WP Admin > POS > Settings > Checkout - Zoek de gateway PayArc Terminal en schakel deze in voor de POS
- Sla je instellingen op
Het selectievakje Enable/Disable op het WooCommerce-instellingenscherm regelt alleen het afrekenen in de onlinewinkel. WCPOS gebruikt deze gateway zodra deze is ingesteld, ongeacht of dat vakje is aangevinkt.
De meeste winkels laten dit uitgeschakeld.
Naslag voor instellingen
| Instelling | Beschrijving |
|---|---|
| Enable/Disable | Schakelt PayArc Terminal in voor afrekenen in de onlinewinkel. Standaard uitgeschakeld; inschakelen voor de POS regel je via POS > Settings > Checkout |
| Title | Het label bij het afrekenen; standaard PayArc Terminal |
| Description | De beschrijving bij het afrekenen; standaard Pay in person at a PayArc PAX terminal. |
| Mode | Live (standaard) of Test. Voor Test zijn inloggegevens van het PayArc-testdashboard en de PayArc Connect Test-app vereist |
| PayArc login email | Het e-mailadres waarmee je je aanmeldt bij het PayArc-verkopersdashboard; vereist om verbinding te maken |
| PayArc MID | De MID van de verkoper uit je PayArc Merchant Profile, niet de terminal-ID |
| PayArc ClientSecret | Het geheim uit het API-gedeelte van het dashboard; wordt alleen op je server opgeslagen |
| PayArc SecretKey / API bearer token | Het token uit het PayArc-dashboard, gebruikt om aan te melden en het terminalregister op te halen |
| Callback bearer token | Optioneel. Vul dit alleen in als PayArc Support er een heeft verstrekt |
| PayArc connection | De knoppen Connect using these credentials, Refresh Terminals en Disconnect |
| Terminal serial number | Het PAX S/N dat aan je account is toegewezen; vereist voor betalingen. Wordt ingevuld vanuit het register als het daar wordt gevonden; voer het in of bevestig het voordat je opslaat |
| Tender type | CREDIT (standaard) of DEBIT |
| Print receipt | 0 — geen (standaard), 1 — verkoper, 2 — klant, 3 — beide |
| Webhook URL | Alleen-lezen adres voor terugkoppelingen. Controleer of dit HTTPS gebruikt; geef het alleen aan PayArc als daarom wordt gevraagd |
| PayArc diagnostics | Verbindingsinformatie en een knop Validate Settings; geheimen worden nooit weergegeven |
Opgeslagen geheimvelden tonen alleen de laatste 4 tekens. Laat een geheimveld leeg om de opgeslagen waarde te behouden.
De tabel PayArc diagnostics toont de modus, eindpunten, afgeschermde MID / tenant-ID / serienummer, of het Connect-toegangstoken is ingesteld, de Webhook URL, de laatste terugkoppeling en de laatste PayArc-fout. Gebruik Validate Settings om je instellingen te controleren.
Gebruik
Betalingen verwerken
- Select Gateway: Kies PayArc Terminal als betaalmethode in de POS
- Start Payment: Klik op Start Payment om het bestelbedrag naar de terminal te sturen
- Klantbetaling: Laat de pagina open terwijl de klant de betaling afrondt op de PAX-terminal. Volg de statusberichten:
Starting terminal payment...→Payment sent to terminal.→Waiting for the terminal result...→Payment approved. Completing the order... - Automatisch afronden: Zodra PayArc de betaling bevestigt, wordt de bestelling automatisch afgerond
Betalingsbediening
- Cancel Payment verschijnt zodra een betaling start. Als PayArc nog geen trace-ID heeft teruggegeven, wacht dan even voordat je annuleert
- Na een weigering, annulering of time-out kun je het opnieuw proberen. Controleer bij een time-out de terminal voordat je het opnieuw probeert
- Het betalingsactiviteitenlogboek is standaard ingeklapt. Gebruik Show activity om het te bekijken en Clear om de weergegeven activiteit te wissen
Bonnen
De instelling Print receipt bepaalt wat er op de terminal wordt afgedrukt: niets, een bon voor de verkoper, een klantbon of beide.
Terugbetalingen
Terugbetalingen worden niet ondersteund door de plugin. Voer de terugbetaling uit via PayArc en registreer deze daarna handmatig in WooCommerce.
Logboeken
Je vindt logboeken in WooCommerce > Status > Logs, onder de bron payarc-terminal-for-woocommerce. Logboeken bevatten verbindingspogingen, gestarte of mislukte verkopen, annuleringen en geaccepteerde of afgewezen terugkoppelingen. Identificatiegegevens zijn afgeschermd en geheime gegevens zijn weggelakt.
Er is geen download voor een ondersteuningspakket. Stuur bij een hulpvraag het bestelnummer en de relevante logregels mee. Deel geen volledige MID's, terminal-ID's, tokens of kaartgegevens.
Vereisten
Reikwijdte en beperkingen
- Terugbetalingen worden niet ondersteund door de plugin
- Betalingen brengen het volledige bestelbedrag in rekening; gedeeltelijke betalingen of gesplitste betalingen worden niet ondersteund
- Fooien worden niet ondersteund
- Eén terminal per winkel: één instelling voor het serienummer, zonder keuzemenu voor kassamedewerkers
- Valuta's zijn beperkt tot USD, CAD, GBP, EUR en JPY
- Betalingen worden geblokkeerd totdat de modus en inloggegevens overeenkomen met de opgeslagen verbinding
Problemen oplossen
Veelvoorkomende problemen
De inloggegevens lijken bij de andere omgeving te horen
- De geselecteerde modus en inloggegevens zijn afkomstig uit verschillende omgevingen
- Wijzig Mode zodat deze overeenkomt met de inloggegevens, of vervang de inloggegevens door die voor de geselecteerde modus
- Klik opnieuw op Connect using these credentials en sla de instellingen op
Kan geen verbinding maken met PayArc
- PayArc heeft de inloggegevens geweigerd. Controleer de ingevoerde gegevens en probeer het opnieuw
- Controleer
WooCommerce > Status > Logs, bronpayarc-terminal-for-woocommerce, voor meer informatie
Kan betalingsverzoek niet verwerken. (HTTP 500)
- Dit bericht voor de kassamedewerker is algemeen. Zoek PayArc payment action failed in het WooCommerce-logboek voor de werkelijke oorzaak
- Klik na een wijziging van de modus of inloggegevens opnieuw op Connect using these credentials en sla de instellingen op
- Controleer of Terminal serial number is ingevuld
- Als het logboek aangeeft dat PayArc zowel het Connect-toegangstoken als SecretKey heeft geweigerd, vraag dan aan PayArc Support om te bevestigen dat PayArc Connect V3 is ingeschakeld voor je verkopersaccount
- Controleer of de winkelvaluta USD, CAD, GBP, EUR of JPY is
Toegang geweigerd. (HTTP 403) bij Start Payment
- Werk bij naar 0.1.12 of hoger; deze versie verhelpt deze fout voor POS-sessies
Terminal Registry is leeg
- Een leeg register, of een terminal die zonder POS-identificatie wordt weergegeven, is normaal
- Registergegevens zijn alleen bedoeld voor rapportage. Voor betalingen wordt Terminal serial number gebruikt
Een betaling duurt te lang
- Controleer het terminalscherm en laat de betaalpagina open
- Controleer de bestelnotities en het PayArc-dashboard voordat je het opnieuw probeert
- De pagina controleert elke 1.5 seconden en stopt na 5 minuten
Hulp krijgen
- Vermeld het bestelnummer en de relevante logregels bij je hulpvraag
- Ga naar de GitHub-repository om problemen te melden
- Neem contact op met PayArc Support voor hulp met je account, PayArc Connect en de terminalconfiguratie