Payment infrastructure for global commerce

Cross-border payments,made clear and reliable.

Manage payments, refunds, events, and payouts with one straightforward server-side API. Keep your team focused on your business, not payment plumbing.

Create merchant account Read the docs

Free sandbox
Hosted checkout
Verifiable webhooks

Order amount

$29.90 USD

ORD_2026_001

SandboxPaid

Payment lifecycle

Order createdPOST /v1/orders
Checkout openedcheckout_url
Payment succeededpayment.succeeded
Webhook deliveredHTTP 200
Recorded in ledger+ $29.90

Illustration, not a real transaction

One API: HTTP + JSON; Fits your existing backend
Sandbox and live: Two environments; Separated by key prefix
Signed webhooks: HMAC-SHA256; Trustworthy async events
Pending payments: Reconciliation; Final states checked again

Platform capabilities

Everything in the payment flow

The essentials in one API. Every state can be queried, and every movement of funds can be traced.

Unified payments API

Create orders, query status, and issue refunds with a predictable HTTP + JSON contract.

Hosted checkout

Send customers to a signed checkout link without handling payment credentials yourself.

Separate environments

Independent test and live keys lower the risk of accidental real transactions.

Reliable webhooks

Verify signatures, retry failed deliveries, inspect logs, and resend events.

Automatic reconciliation

Pending payments and refunds are checked again when a notification is missed.

Wallet and ledger

Track payments, refunds, and payouts in an auditable record of balance changes.

Built for developers

Your first payment starts with one request

Create an order on your server, then redirect the customer to the checkout URL. Your order reference also acts as an idempotency key, so retries are safe.

View quickstart

Example request · Sandbox

Request

curl -X POST https://api.kukopay.com/v1/orders \
  -H "X-Api-Key: kuko_test_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "out_trade_no": "ORD_2026_001",
    "amount": 2990,
    "currency": "USD",
    "subject": "Premium plan"
  }'

Response 201

{
  "code": 201,
  "data": {
    "trade_no": "TRD_SB_9F3A2C7E…",
    "status": "pending",
    "checkout_url": "https://checkout.kukopay.com/…"
  }
}

Integration flow

From setup to fulfillment in four steps

The browser return improves the experience; a verified server-side event is the basis for fulfillment.

1
Get a sandbox key
Create a merchant account and request a test key to start integration.
2
Create an order
Send the amount, order reference, and notification URL to get a checkout link.
3
Customer pays
Redirect the customer to KukoPay's hosted checkout.
4
Verify and fulfill
Verify the payment.succeeded event and deduplicate by event ID.

Security by design

Safeguards built into the flow

Separate environments, signed events, and ledger rules reduce operational mistakes.

Protected keys

Keys are stored encrypted and can be reset by merchants.

Access controls

Merchant-level API rate limits and optional IP allowlists.

Environment isolation

Test and live use independent keys and ledgers.

Fund consistency

Idempotent state changes and balance movements have matching records.

FAQ

Before you integrate

Where can I find the API documentation?

Public integration docs are at kukopay.com/docs. Keys, orders, and webhook delivery logs are in the merchant portal.

How do I prevent duplicate orders or fulfillment?

Use a unique out_trade_no when creating an order, then deduplicate webhook events by event ID. You can retry the same order reference after a timeout.

Is the browser return proof of payment?

No. Fulfill only after verifying a payment.succeeded webhook; query the order for an additional check.

Ready to create your first sandbox order?

Open a merchant account, request a test key, and follow the quickstart from end to end.

Create sandbox account Browse documentation