Developers

curl -X POST https://api.yourbrand.com/v1/payments \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Idempotency-Key: 7c1e2f0a-58b4-4d0e" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 125000,
    "currency": "TRY",
    "method": "card",
    "installments": 1,
    "three_d_secure": true,
    "order_id": "ORD-2026-11-0417",
    "callback_url": "https://shop.yourbrand.com/payment/result"
  }'

HTTP/1.1 201 Created
{
  "id": "pay_8f3k29dq",
  "status": "requires_3ds",
  "amount": 125000,
  "currency": "TRY",
  "three_d_secure": {
    "redirect_url": "https://3ds.yourbrand.com/a/8f3k29dq"
  },
  "created_at": "2026-11-03T14:32:08+03:00"
}

POST /webhooks/payments
X-Signature: t=1793716328,v1=5d41c0f3a9e2…
{
  "event": "payment.succeeded",
  "data": {
    "id": "pay_8f3k29dq",
    "status": "succeeded",
    "amount": 125000,
    "paid_at": "2026-11-03T14:32:21+03:00"
  }
}