دفع الفواتير

curl https://billapi.oneclickdz.com/v3/bills/pay \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: YOUR_API_KEY" \
  -d '{
    "transactionId": "68b2f4c1a7d3e9f204c81a55",
    "billId": "sbx_bill_68b2f4c1a7d3e9f204c81a55_0",
    "ref": "pay-inv-2026-0042"
  }'

const BASE = "https://billapi.oneclickdz.com";
const KEY = process.env.ONECLICKDZ_API_KEY;

async function payBill(order, bill) {
  // 1. Persist before sending — this row is your recovery path.
  await db.payments.insert({
    orderId: order.id,
    transactionId: order.transactionId,
    billId: bill.billId,
    amount: bill.amount,
    fee: bill.fee,
    total: bill.amount + bill.fee,
    discoveryRef: order.discoveryRef,
    paymentRef: `pay-${order.id}`,
    state: "SUBMITTING",
  });

  const response = await fetch(`${BASE}/v3/bills/pay`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Access-Token": KEY,
    },
    body: JSON.stringify({
      transactionId: order.transactionId,
      billId: bill.billId,
      ref: `pay-${order.id}`,
    }),
  });

  const body = await response.json();

  if (!body.success) {
    throw new Error(`${body.error.code}: ${body.error.message}`);
  }

  // PROCESSING — in flight, not paid.
  await db.payments.update(order.id, { state: "PROCESSING" });
  return body.data.transactionId;
}

import os
import requests

BASE = 'https://billapi.oneclickdz.com'
KEY = os.getenv('ONECLICKDZ_API_KEY')


def pay_bill(order, bill):
    # 1. Persist before sending — this row is your recovery path.
    db.payments.insert({
        'order_id': order['id'],
        'transaction_id': order['transaction_id'],
        'bill_id': bill['billId'],
        'amount': bill['amount'],
        'fee': bill['fee'],
        'total': bill['amount'] + bill['fee'],
        'discovery_ref': order['discovery_ref'],
        'payment_ref': f"pay-{order['id']}",
        'state': 'SUBMITTING'
    })

    response = requests.post(
        f'{BASE}/v3/bills/pay',
        headers={
            'Content-Type': 'application/json',
            'X-Access-Token': KEY
        },
        json={
            'transactionId': order['transaction_id'],
            'billId': bill['billId'],
            'ref': f"pay-{order['id']}"
        }
    )

    body = response.json()

    if not body['success']:
        raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")

    # PROCESSING — in flight, not paid.
    db.payments.update(order['id'], {'state': 'PROCESSING'})
    return body['data']['transactionId']

<?php
const BASE = 'https://billapi.oneclickdz.com';

function payBill(array $order, array $bill): string
{
    // 1. Persist before sending — this row is your recovery path.
    $db->payments->insert([
        'order_id'       => $order['id'],
        'transaction_id' => $order['transaction_id'],
        'bill_id'        => $bill['billId'],
        'amount'         => $bill['amount'],
        'fee'            => $bill['fee'],
        'total'          => $bill['amount'] + $bill['fee'],
        'discovery_ref'  => $order['discovery_ref'],
        'payment_ref'    => 'pay-' . $order['id'],
        'state'          => 'SUBMITTING'
    ]);

    $ch = curl_init(BASE . '/v3/bills/pay');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json',
        'X-Access-Token: ' . getenv('ONECLICKDZ_API_KEY')
    ]);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
        'transactionId' => $order['transaction_id'],
        'billId'        => $bill['billId'],
        'ref'           => 'pay-' . $order['id']
    ]));

    $body = json_decode(curl_exec($ch), true);
    curl_close($ch);

    if (!$body['success']) {
        throw new Exception($body['error']['code'] . ': ' . $body['error']['message']);
    }

    // PROCESSING — in flight, not paid.
    $db->payments->update($order['id'], ['state' => 'PROCESSING']);
    return $body['data']['transactionId'];
}
?>