Підключення WooCommerce до JaRyk (плагін WordPress)

Плагін «Lynbro Payment Reminders for WooCommerce» передає неоплачені замовлення з оплатою за рахунком у JaRyk, а JaRyk надсилає нагадування за датським законом (renteloven). JaRyk ніколи не отримує доступу до вашого WordPress — їх поєднує лише ваш API-ключ.

Як почати

  1. Створіть безкоштовний акаунт JaRyk на jaryk.dk (вхід через e-mail).
  2. Відкрийте Налаштування → Підключення → WooCommerce і натисніть «Створити ключ». Назвіть його за магазином (напр. «shop.dk — WordPress»), впишіть адресу магазину (https://shop.dk) і залиште тестовий режим увімкненим.
  3. Скопіюйте API-ключ (jrk_src_…) і секрет підпису (whsec_…). Їх показують лише один раз.
  4. Вставте обидва у WordPress: WooCommerce → JaRyk → «Зберегти й перевірити». Плагін покаже назву акаунта, план і дозволи.
  5. Спробуйте тестове замовлення. У тестовому режимі клієнтам нічого не надходить — нагадування імітуються.
  6. Коли ви затвердите тексти нагадувань і ввімкнете надсилання в JaRyk, вимкніть тестовий режим ключа.

Створити ключ →

Що передається в JaRyk

Лише замовлення, що відповідають вашим правилам у плагіні: номер замовлення й рахунку, сума, дати, мова, ім'я покупця, e-mail, телефон, адреса, CVR/EAN і посилання на PDF рахунку. Оплати, скасування й паузи теж передаються, щоб справа йшла за замовленням.

Що JaRyk надсилає назад

Підписані події в магазин: справу створено, нагадування надіслано, додано плату, оплачено, передано на стягнення, закрито. Вони містять лише ідентифікатори й суми — ніколи дані клієнтів. Перш ніж змінити замовлення, плагін перечитує стан справи з JaRyk.

Як відкликати доступ

Натисніть «Відкликати» на ключі в JaRyk — він одразу перестає працювати. Уже отримані справи лишаються в JaRyk. «Оновити» видає новий ключ; старий працює ще 24 години.

Технічна довідка (для розробників)

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.