01
API-nøkkel for firma
En firmanøkkel er avgrenset til én forhandler. Bruk den når integrasjonen bare tilhører dette firmaet.
Integrasjonsguide · 01
Gjør betalingene enkle å følge.
En praktisk guide til API-nøkler, firmatilgang, betalingsforespørsler og hendelsene som forteller systemet ditt hva som skjedde etterpå.
01
Første betaling
Første betaling
Opprett en nøkkel i Evo Pay-arbeidsområdet, hold tokenet hemmelig, velg forhandler-ID og send en idempotent betalingsforespørsel.
Base-URL:
https://demo.evopay.no/api/v1
POST /payments
curl --request POST 'https://demo.evopay.no/api/v1/merchants/epc_example/payments' \
--header 'Authorization: Bearer $EVOPAY_API_TOKEN' \
--header 'Idempotency-Key: order-2048' \
--header 'Content-Type: application/json' \
--data '{"amount":149000,"currency":"NOK","reference":"ORDER-2048","payment_type":"checkout"}'
02
Sentrale konsepter
Sentrale konsepter
02
API-nøkkel for partner
En partnernøkkel kan brukes på tvers av eksplisitt koblede forhandlere. Tilgangen kontrolleres på nytt for hver forespørsel.
03
Forhandler
En forhandler er et Evo Pay-firma og adresseres med en epc_-objekt-ID. Partnernøkler kan bare bruke firmaer som er koblet til partneren nå.
04
Objekt-ID-er
Offentlige ID-er er ugjennomsiktige og typeprefikset, for eksempel epc_ for forhandlere, epp_ for betalinger, t_ for terminaler og epwh_ for webhook-endepunkter.
05
Tilgangsområder
Gi bare payments:read/write, settings:read/write og merchants:read/write som integrasjonen trenger.
06
Betalingslivsløp
Opprett betalinger for checkout, terminal, Vipps eller Klarna, og les deretter statusen. Avbryt åpne betalinger, prøv mislykkede forsøk på nytt og refunder innbetalte beløp.
Idempotens
Send en stabil Idempotency-Key når du oppretter betalinger og refusjoner. Et nytt forsøk returnerer da det opprinnelige resultatet uten å duplisere pengeflyten.
03
Signerte webhooks
Signerte webhooks
Firmaendepunkter mottar hendelser for én forhandler. Partnerendepunkter mottar hendelser på tvers av koblede forhandlere. Verifiser EvoPay-Signature mot den eksakte rå forespørselskroppen.
Webhook-levering
30 forsøk totalt01
Etter 30 sekunder
02–04
Etter 2, 10 og 30 minutter
05–07
Etter 1, 2 og 4 timer
08–29
Deretter hver 8. time
Levering skjer minst én gang. Alle svar utenfor 2xx, tilkoblingsfeil og tidsavbrudd prøves på nytt i opptil 30 samlede forsøk: etter 30 sekunder; 2, 10 og 30 minutter; 1, 2 og 4 timer; deretter hver 8. time i omtrent 7 døgn og 16 timer.
04
Miljøer
Miljøer
Tilgangsnøkler og objekt-ID-er tilhører ett miljø. Akseptansedata og -nøkler må aldri gjenbrukes i produksjon.