Welcome to Payku Docs
Here you will find everything you need to easily integrate Payku into your business.
If you are interested in implementing this payment method, learn more at Payku.com and request a demo 👍
If you are interested in implementing this payment method, learn more at Payku.com and request a demo 👍
How does the integration work?
Section titled “How does the integration work?”- Choose your country — the API is the same; payment methods, currency and some fields change: 🇨🇱 Chile · 🇵🇪 Peru · 🇻🇪 Venezuela.
- Get your credentials — when you register at app.payku.cl you receive a public token and a private token. The public token is sent as
Authorization: Bearer TOKENon your API calls; the private token is the secret key used to compute theSignheader and is never sent directly. See Authentication. - Test risk-free — use the sandbox server
https://des.payku.cl/and the test environment; in Chile you also get Webpay/Oneclick test cards. See API access. - Create your first payment (PayIn) —
POST /api/transactioncreates an order and returns the payment URL to redirect the payer to. See Transaction. - Receive the confirmation — once the payment completes, Payku notifies your
urlnotify(webhook) and you can verify the state withGET /api/transaction/{id}. Important: always check thestatusfield in the JSON, not just the HTTP code. - Sign the operations that require it — subscriptions, nullifications, mall and third-party payments use the
Signheader (HMAC-SHA256 with your private token). See Signature. - Pay third parties (PayOut) — send money from your wallet with
POST /api/wallet/payout. See Wallet.
🚀 Prefer to try before writing code? Download your country’s Postman collection (linked on each introduction page) together with the environment: it ships every endpoint with example bodies and computes the
Signsignature for you.🤖 Integrating with AI? Download the full documentation as Markdown (also available per country on each introduction page) and use it as context for your assistant.