Accept KNET, mada, cards and Apple Pay with one API.

Teyra Pay gives you a hosted checkout for the Gulf. Create a payment from your server, send the customer to checkout_url, and get a signed webhook when it settles.

Start the quick startBrowse the API reference
RequestPOST /v1/payments
curl https://api.teyra.co/v1/payments \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042" \
  -d '{"amount": 12500, "currency": "KWD",
       "return_url": "https://shop.example.com/thanks"}'
Response · 201 Createdapplication/json
{
  "id": "pay_01JBX4T9W2",
  "status": "requires_payment",
  "amount": 12500,  // 12.500 KWD
  "currency": "KWD",
  "checkout_url": "https://api.teyra.co/checkout/pay_01JBX4T9W2"
}

How a payment moves

  1. 1

    Create

    Your server calls POST /v1/payments with the amount in minor units and a return_url.

    requires_payment
  2. 2

    Redirect

    Send the customer to checkout_url, the Teyra Pay checkout page. They pay with KNET, mada, card, Apple Pay or Benefit.

    processing
  3. 3

    Return

    The customer lands on your return_url with payment_id and status in the query string.

    return_url?status=…
  4. 4

    Confirm

    Fulfil the order only after GET /v1/payments/:id or a verified payment.succeeded webhook.

    succeeded

Guides

Get started

Accept payments

Build reliably

Payment methods

  • KNET
  • mada
  • Visa
  • Mastercard
  • American Express
  • Apple Pay
  • Google Pay
  • Benefit
  • STC Pay