Підключення WooCommerce до JaRyk (плагін WordPress)
Плагін «Lynbro Payment Reminders for WooCommerce» передає неоплачені замовлення з оплатою за рахунком у JaRyk, а JaRyk надсилає нагадування за датським законом (renteloven). JaRyk ніколи не отримує доступу до вашого WordPress — їх поєднує лише ваш API-ключ.
Як почати
- Створіть безкоштовний акаунт JaRyk на jaryk.dk (вхід через e-mail).
- Відкрийте Налаштування → Підключення → WooCommerce і натисніть «Створити ключ». Назвіть його за магазином (напр. «shop.dk — WordPress»), впишіть адресу магазину (https://shop.dk) і залиште тестовий режим увімкненим.
- Скопіюйте API-ключ (jrk_src_…) і секрет підпису (whsec_…). Їх показують лише один раз.
- Вставте обидва у WordPress: WooCommerce → JaRyk → «Зберегти й перевірити». Плагін покаже назву акаунта, план і дозволи.
- Спробуйте тестове замовлення. У тестовому режимі клієнтам нічого не надходить — нагадування імітуються.
- Коли ви затвердите тексти нагадувань і ввімкнете надсилання в 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).
| 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.