Forbind WooCommerce med JaRyk (WordPress-plugin)
Med pluginet »Lynbro Payment Reminders for WooCommerce« sender din butik ubetalte ordrer på faktura til JaRyk, som rykker efter renteloven. JaRyk får aldrig adgang til dit WordPress — kun din API-nøgle forbinder de to.
Sådan kommer du i gang
- Opret en gratis JaRyk-konto på jaryk.dk (log ind med e-mail).
- Gå til Indstillinger → Forbindelser → WooCommerce og klik »Opret nøgle«. Navngiv den efter butikken (fx »shop.dk — WordPress«), skriv butikkens adresse (https://shop.dk) og behold testtilstand slået til.
- Kopiér API-nøglen (jrk_src_…) og signeringsnøglen (whsec_…). De vises kun én gang.
- Indsæt begge i WordPress under WooCommerce → JaRyk og klik »Gem og test«. Pluginet viser kontonavn, abonnement og rettigheder.
- Prøv med en testordre. I testtilstand sendes intet til dine kunder — rykkerne simuleres.
- Når du har godkendt rykkerteksterne og slået udsendelse til i JaRyk, slår du testtilstand fra på nøglen.
Hvad sendes til JaRyk
Kun ordrer, der matcher dine regler i pluginet: ordre- og fakturanummer, beløb, datoer, sprog, købers navn, e-mail, telefon, adresse, CVR/EAN og et link til faktura-PDF'en. Betalinger, annulleringer og pauser sendes, så sagen følger ordren.
Hvad JaRyk sender tilbage
Signerede hændelser til butikken: sag oprettet, rykker sendt, gebyr tilføjet, betalt, sendt til inkasso, lukket. De indeholder kun id'er og beløb — aldrig kundedata. Pluginet henter sagens status fra JaRyk, før det ændrer en ordre.
Sådan tilbagekalder du adgangen
Klik »Tilbagekald« på nøglen i JaRyk. Den virker ikke længere med det samme. Sager, der allerede er modtaget, bliver i JaRyk. »Forny« giver en ny nøgle; den gamle virker 24 timer endnu.
Teknisk reference (til udviklere)
Base URL: https://jaryk.dk/api/v1 · OpenAPI 3.1: https://jaryk.dk/api/v1/sources/woocommerce/openapi.json
Headers: Authorization: Bearer jrk_src_…, X-Lynbro-Timestamp (unix s), X-Lynbro-Event-Id (uuid), X-Lynbro-Signature, X-Lynbro-Site: https://shop.dk, Idempotency-Key on writes, Accept-Language da/en/uk.
Signature: v1=hex(HMAC-SHA256(secret, ts + "." + METHOD + " " + path + "." + raw_body)) — path includes ?query when present; ±300 s window. X-JaRyk-Signature is accepted/sent as an alias (bare hex).
| Path | Scope | ||
|---|---|---|---|
GET | /me | — | account, plan, quota, scopes, origins, key, sandbox |
POST | /sources/woocommerce/ping | — | connection test |
POST | /sources/woocommerce/invoices | invoices:write | upsert an unpaid order/invoice |
POST | /sources/woocommerce/payments | payments:write | payment received → case closes |
POST | /sources/woocommerce/invoices/{external_id}/void | invoices:write | cancelled / credited |
POST | /sources/woocommerce/invoices/{external_id}/hold | invoices:write | {"hold": true|false, "until"?} |
GET | /sources/woocommerce/cases/{external_id} | cases:read | case state (re-read after a webhook) |
GET | /sources/woocommerce/cases?state=open | cases:read | poll fallback |
PUT | /sources/woocommerce/webhook | webhooks:write | {"url": "https://shop.dk/wp-json/…"} |
POST | /sources/woocommerce/webhook/test | webhooks:write | signed ping to the webhook URL |
Invoice body:
{"external_id": "1042", "number": "F-1042", "issued_at": "2026-11-01", "due_at": "2026-11-09",
"amount_minor": 125000, "currency": "DKK", "language": "da",
"buyer": {"name": "Kunde ApS", "email": "…", "phone": "…", "cvr": "12345678",
"ean": "5790001234567", "address": {"line1": "…", "postcode": "8000", "city": "Aarhus"}},
"pdf_url": "https://shop.dk/…/F-1042.pdf"}Webhooks (signed the same way, to the registered URL): case.created, case.reminder_sent, case.fee_added, case.paid, case.collection, case.closed; body {id, type, api_version, created_at, site_id, sandbox, data:{external_id, state, …}}. Retries: 1 m, 5 m, 30 m, 2 h, 6 h, 12 h, 24 h.
Errors: {"error": {"code", "message", "details"}} — invalid_key 401, invalid_signature 401, scope_missing 403, origin_mismatch 403, quota_exceeded 402, rate_limited 429 (Retry-After), invalid_payload 422, idempotency_key_reused 422, unknown_invoice 404.