How to use Orders API

1
const BASE = "https://api-gateway-stg.transak.com";
2
3
interface Order {
4
  orderId: string;
5
  status: string;
6
  isBuyOrSell: string;
7
  fiatCurrency: string;
8
  cryptoCurrency: string;
9
  paymentMethod: string;
10
  network: string;
11
  walletAddress: string;
12
  quoteId: string;
13
  fiatAmount: number;
14
  cryptoAmount: number;
15
  totalFeeInFiat: number;
16
  txHash: string;
17
}
18
19
async function getActiveOrders(params: {
20
  apiKey: string;
21
  userIp: string;
22
  accessToken: string;
23
}): Promise<Order[]> {
24
  const res = await fetch(`${BASE}/api/v2/active-orders`, {
25
    headers: {
26
      "x-api-key": params.apiKey,
27
      "x-user-ip": params.userIp,
28
      Authorization: params.accessToken,
29
    },
30
  });
31
  const json = await res.json();
32
  if (!res.ok) throw new Error(json.error?.message ?? `HTTP ${res.status}`);
33
  return json.data as Order[];
34
}

1
const BASE = "https://api-gateway-stg.transak.com";
2
3
interface Order {
4
  orderId: string;
5
  status: string;
6
  isBuyOrSell: string;
7
  fiatCurrency: string;
8
  cryptoCurrency: string;
9
  paymentMethod: string;
10
  fiatAmount: number;
11
  cryptoAmount: number;
12
  totalFeeInFiat: number;
13
  txHash: string;
14
  transactionLink: string;
15
}
16
17
async function getOrders(params: {
18
  apiKey: string;
19
  userIp: string;
20
  accessToken: string;
21
}): Promise<Order[]> {
22
  const res = await fetch(`${BASE}/api/v2/orders`, {
23
    headers: {
24
      "x-api-key": params.apiKey,
25
      "x-user-ip": params.userIp,
26
      Authorization: params.accessToken,
27
    },
28
  });
29
  const json = await res.json();
30
  if (!res.ok) throw new Error(json.error?.message ?? `HTTP ${res.status}`);
31
  return json.data as Order[];
32
}

1
const BASE = "https://api-gateway-stg.transak.com";
2
3
interface Order {
4
  orderId: string;
5
  status: string;
6
  fiatAmount: number;
7
  cryptoAmount: number;
8
  txHash: string;
9
  transactionLink: string;
10
}
11
12
async function getOrderById(params: {
13
  orderId: string;
14
  apiKey: string;
15
  userIp: string;
16
  accessToken: string;
17
}): Promise<Order> {
18
  const res = await fetch(`${BASE}/api/v2/orders/${params.orderId}`, {
19
    headers: {
20
      "x-api-key": params.apiKey,
21
      "x-user-ip": params.userIp,
22
      Authorization: params.accessToken,
23
    },
24
  });
25
  const json = await res.json();
26
  if (!res.ok) throw new Error(json.error?.message ?? `HTTP ${res.status}`);
27
  return json.data as Order;
28
}
29
30
const FINAL_STATUSES = ["COMPLETED", "CANCELLED", "FAILED", "REFUNDED", "EXPIRED"];
31
32
async function pollOrderStatus(
33
  params: Parameters<typeof getOrderById>[0] & { intervalMs?: number; timeoutMs?: number }
34
): Promise<Order> {
35
  const { intervalMs = 5000, timeoutMs = 300_000 } = params;
36
  const deadline = Date.now() + timeoutMs;
37
38
  while (Date.now() < deadline) {
39
    const order = await getOrderById(params);
40
    if (FINAL_STATUSES.includes(order.status)) return order;
41
    await new Promise(resolve => setTimeout(resolve, intervalMs));
42
  }
43
  throw new Error("Timed out waiting for order to reach a final status");
44
}

1
const BASE = "https://api-gateway-stg.transak.com";
2
3
async function cancelOrder(params: {
4
  orderId: string;
5
  cancelReason: string;
6
  apiKey: string;
7
  userIp: string;
8
  accessToken: string;
9
}): Promise<{ orderId: string; status: string }> {
10
  const qs = new URLSearchParams({ cancelReason: params.cancelReason });
11
  const res = await fetch(`${BASE}/api/v2/orders/${params.orderId}?${qs}`, {
12
    method: "DELETE",
13
    headers: {
14
      "x-api-key": params.apiKey,
15
      "x-user-ip": params.userIp,
16
      Authorization: params.accessToken,
17
    },
18
  });
19
  const json = await res.json();
20
  if (!res.ok) throw new Error(json.error?.message ?? `HTTP ${res.status}`);
21
  return json.data;
22
}