# Quickstart

> Accept Kaspi Pay on your site with Bankemes: by hand in five steps, or let your AI agent do it.

## With an AI agent

Cabinet → “AI agents”: connect your client through OAuth or create an MCP key, download [BANKEMES_AGENT.md](https://bankemes.kz/BANKEMES_AGENT.md) and give it to your agent with the request “Connect Bankemes payments to this project”. See [for agents](https://bankemes.kz/for-agents).

## By hand

1. [Register](https://bankemes.kz/register) with your phone number (2 days free).
2. Connect your Kaspi Pay cashier on the Kaspi page of the dashboard (cashier phone + SMS code).
3. Resources → add your site URL → create an API token and set the webhook URL.
4. Create a payment from your server and redirect the buyer to `checkout_url`.
5. Handle the signed webhook and re-read the payment before fulfilling the order.

Create a payment:

```
curl -X POST https://bankemes.kz/api/v1/payments \
  -H "Authorization: Bearer $BANKEMES_API_TOKEN" \
  -H "Idempotency-Key: order-1001" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"1001","amount":2500}'
```

The example amount is for a seller’s buyer order, not the seller’s Bankemes subscription. Bankemes costs 4,990 ₸ per connected cashier per month, renewed on the billing anniversary; the account gets a one-time 2-day trial and 3 days of grace after a paid period. The seller pays each renewal invoice manually in Kaspi; there is no automatic debit.

Use a `bms_test_…` token to try everything without the bank (`"livemode": false`). Full reference: [API](https://bankemes.kz/developers/api), [OpenAPI](https://bankemes.kz/openapi.json).

Source: https://bankemes.kz/docs/quickstart
