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

  1. Opret en gratis JaRyk-konto på jaryk.dk (log ind med e-mail).
  2. 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.
  3. Kopiér API-nøglen (jrk_src_…) og signeringsnøglen (whsec_…). De vises kun én gang.
  4. Indsæt begge i WordPress under WooCommerce → JaRyk og klik »Gem og test«. Pluginet viser kontonavn, abonnement og rettigheder.
  5. Prøv med en testordre. I testtilstand sendes intet til dine kunder — rykkerne simuleres.
  6. Når du har godkendt rykkerteksterne og slået udsendelse til i JaRyk, slår du testtilstand fra på nøglen.

Opret nøgle →

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).

PathScope
GET/me—account, plan, quota, scopes, origins, key, sandbox
POST/sources/woocommerce/ping—connection test
POST/sources/woocommerce/invoicesinvoices:writeupsert an unpaid order/invoice
POST/sources/woocommerce/paymentspayments:writepayment received → case closes
POST/sources/woocommerce/invoices/{external_id}/voidinvoices:writecancelled / credited
POST/sources/woocommerce/invoices/{external_id}/holdinvoices:write{"hold": true|false, "until"?}
GET/sources/woocommerce/cases/{external_id}cases:readcase state (re-read after a webhook)
GET/sources/woocommerce/cases?state=opencases:readpoll fallback
PUT/sources/woocommerce/webhookwebhooks:write{"url": "https://shop.dk/wp-json/…"}
POST/sources/woocommerce/webhook/testwebhooks:writesigned 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.