kokolisted
Install: claude install-skill psnwd/getewise
# Koko
Koko is a Sri Lankan Buy-Now-Pay-Later gateway: customer is redirected to Koko, pays in installments, merchant is paid up front. Currency LKR. This skill packs the Koko API Developer Preview v1.05 and Merchant Order View API v1.0 PDFs. The docs have gaps; `references/troubleshooting.md` lists them. Flag them, don't invent.
## How to use this skill
1. Pick the integration from the routing table.
2. Read only the matching reference file(s).
3. For code, start from `references/code-examples.md`.
4. Use `scripts/koko_sign.py` to build `dataString` + `signature` for an order or order view, or verify a Koko callback signature while debugging.
5. Say that facts come from Koko's developer PDFs; contractual or account questions go to Koko merchant support (paykoko.com).
## Routing table
| User needs | Read |
|---|---|
| Create order: form fields, `dataString` order, signing, environments | `references/checkout-api.md` |
| `_returnUrl`, `_cancelUrl`, `_responseUrl` handling, verifying Koko's signature | `references/callbacks.md` |
| Check order status server-side (`orderView`) | `references/order-view-api.md` |
| Code in PHP, Node/TS, Python, Go | `references/code-examples.md` |
| Errors, doc gaps/contradictions, go-live checklist | `references/troubleshooting.md` |
| App uses several gateways: env layout, callback routes, shared idempotent settle | `references/multi-provider.md` |
## Core rules
1. **Request is a signed form POST** to `{host}/api/merchants/orderCreate` (`app