Take BOONKA payments on your own site.

curl https://api.boonka.com/api/v1/payment-sessions/store \
  -H "X-API-Key: $BOONKA_PUBLIC_KEY" \
  -H "Authorization: Bearer $BOONKA_SECRET_KEY" \
  -H "Idempotency-Key: order_1042.v1" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 450000,
    "reference": "order_1042",
    "success_url": "https://shop.dz/orders/1042/paid",
    "cancel_url": "https://shop.dz/orders/1042/cancelled",
    "metadata": {
      "order_id": "1042",
      "customer_id": "cust_8821"
    },
    "service_fee": 5000,
    "items": [
      { "name": "Herbal tea blend, 250 g", "quantity": 2, "amount": 125000 }
    ]
  }'

const res = await fetch(`${boonka.base}/payment-sessions/store`, {
  method: "POST",
  headers: {
    ...boonka.headers(),
    "Idempotency-Key": `order_${order.id}.v${order.version}`,
  },
  body: JSON.stringify({
    amount: order.totalMinor,
    reference: `order_${order.id}`,
    success_url: `https://shop.dz/orders/${order.id}/paid`,
    cancel_url: `https://shop.dz/orders/${order.id}/cancelled`,
    metadata: { order_id: String(order.id), customer_id: order.customerId },
    service_fee: order.shippingMinor,
    items: order.lines.map((l) => ({
      name: l.title,
      quantity: l.qty,
      amount: l.unitPriceMinor,
    })),
  }),
});

if (!res.ok) throw new Error(`BOONKA ${res.status}`);

const { data: session } = await res.json();

<?php

$response = $client->post('payment-sessions/store', [
    'headers' => [
        'Idempotency-Key' => "order_{$order->id}.v{$order->version}",
    ],
    'json' => [
        'amount'      => $order->total_minor,
        'reference'   => "order_{$order->id}",
        'success_url' => "https://shop.dz/orders/{$order->id}/paid",
        'cancel_url'  => "https://shop.dz/orders/{$order->id}/cancelled",
        'metadata'    => [
            'order_id'    => (string) $order->id,
            'customer_id' => $order->customer_id,
        ],
        'service_fee' => $order->shipping_minor,
        'items'       => $order->lines->map(fn ($line) => [
            'name'     => $line->title,
            'quantity' => $line->qty,
            'amount'   => $line->unit_price_minor,
        ])->all(),
    ],
]);

$session = json_decode((string) $response->getBody(), true)['data'];

response = boonka.post(
    f"{BASE}/payment-sessions/store",
    headers={"Idempotency-Key": f"order_{order.id}.version_{order.version}"},
    json={
        "amount": order.total_minor,
        "reference": f"order_{order.id}",
        "success_url": f"https://shop.dz/orders/{order.id}/paid",
        "cancel_url": f"https://shop.dz/orders/{order.id}/cancelled",
        "metadata": {
            "order_id": str(order.id),
            "customer_id": order.customer_id,
        },
        "service_fee": order.shipping_minor,
        "items": [
            {"name": l.title, "quantity": l.qty, "amount": l.unit_price_minor}
            for l in order.lines
        ],
    },
    timeout=15,
)
response.raise_for_status()
session = response.json()["data"]

{
  "success": true,
  "message": "Payment session created successfully",
  "data": {
    "id": "9d4b1c2e-3f5a-4b6c-8d7e-9f0a1b2c3d4e",
    "status": "pending",
    "amount": 450000,
    "currency": "DZD",
    "reference": "order_1042",
    "checkout_url": "https://checkout.boonka.io/9d4b1c2e-3f5a-4b6c-8d7e-9f0a1b2c3d4e",
    "expires_at": "2026-07-29T12:00:00+00:00",
    "created_at": "2026-07-29T11:30:00+00:00"
  }
}

{
  "success": false,
  "message": "The success url field must be a valid URL.",
  "errors": {
    "success_url": ["The success url field must be a valid URL."]
  }
}