مستندات API

v1
آدرس پایه
http://localhost:3001/api/v1
Authorization: Bearer <api_key>

به status آدرس بازگشت اعتماد نکنید. نتیجه قطعی فقط پاسخ verify است.

const BASE = "http://localhost:3001/api/v1";
const KEY = process.env.TETRAPAY_API_KEY;

const res = await fetch(BASE + "/payments", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    amount: "12500000",
    order_id: "ORD-10482",
    callback_url: "https://ketabno.ir/cb",
  }),
});
const link = await res.json();
// 201 (200 for a repeated order_id): send the payer to link.payment_url

محدودیت نرخ هر کلید API در دقیقه ۶۰ درخواست. درخواست اضافه پاسخ 429 RATE_LIMITED با هدر Retry-After می‌گیرد.

کدهای خطا

401UNAUTHORIZED
403GATEWAY_SUSPENDED
409ORDER_CONFLICT
422AMOUNT_OUT_OF_RANGE
429RATE_LIMITED