Connect WooCommerce to JaRyk (WordPress plugin)
With the “Lynbro Payment Reminders for WooCommerce” plugin your shop hands unpaid invoice orders to JaRyk, which sends reminders under the Danish Interest Act. JaRyk never gets access to your WordPress — only your API key connects the two.
Getting started
- Create a free JaRyk account at jaryk.dk (sign in with e-mail).
- Go to Settings → Connections → WooCommerce and click “Create key”. Name it after the shop (e.g. “shop.dk — WordPress”), enter the shop's address (https://shop.dk) and keep test mode on.
- Copy the API key (jrk_src_…) and the signing secret (whsec_…). They are shown only once.
- Paste both into WordPress under WooCommerce → JaRyk and click “Save and test”. The plugin shows the account name, plan and permissions.
- Try a test order. In test mode nothing reaches your customers — reminders are simulated.
- Once you have approved the reminder texts and turned sending on in JaRyk, turn test mode off on the key.
What is sent to JaRyk
Only orders matching your rules in the plugin: order and invoice number, amount, dates, language, the buyer's name, e-mail, phone, address, CVR/EAN and a link to the invoice PDF. Payments, cancellations and pauses are sent so the case follows the order.
What JaRyk sends back
Signed events to the shop: case created, reminder sent, fee added, paid, sent to collection, closed. They carry ids and amounts only — never customer data. The plugin re-reads the case from JaRyk before it changes an order.
How to revoke access
Click “Revoke” on the key in JaRyk. It stops working at once. Cases already received stay in JaRyk. “Rotate” gives a new key; the old one keeps working for 24 hours.
Technical reference (for developers)
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.