Tests en sandbox

BASE="https://billapi.oneclickdz.com"
KEY="YOUR_SANDBOX_API_KEY"

# 0. Confirm the environment
curl -s "$BASE/v3/validate" -H "X-Access-Token: $KEY"

# 1. Discover
TXN=$(curl -s "$BASE/v3/bills/discover" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: $KEY" \
  -d '{
    "partner": "ADE",
    "account": { "reference": "0123456789012345678901234" },
    "ref": "disc-sbx-001"
  }' | grep -o '"transactionId":"[a-f0-9]*"' | cut -d'"' -f4)

echo "transaction: $TXN"
sleep 2

# 2. Read the bills
curl -s "$BASE/v3/bills/transactions/$TXN" -H "X-Access-Token: $KEY"

# 3. Pay the first bill (note the NEW ref)
curl -s "$BASE/v3/bills/pay" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: $KEY" \
  -d "{
    \"transactionId\": \"$TXN\",
    \"billId\": \"sbx_bill_${TXN}_0\",
    \"ref\": \"pay-sbx-001\"
  }"

sleep 3

# 4. Confirm the outcome
curl -s "$BASE/v3/bills/transactions/$TXN" -H "X-Access-Token: $KEY"

# 5. Download the receipt
curl -s "$BASE/v3/bills/transactions/$TXN/receipt" \
  -H "X-Access-Token: $KEY" \
  --fail --remote-header-name --remote-name

import { writeFile } from "node:fs/promises";

const BASE = "https://billapi.oneclickdz.com";
const KEY = process.env.ONECLICKDZ_SANDBOX_API_KEY;
const headers = { "X-Access-Token": KEY, "Content-Type": "application/json" };
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function call(path, options = {}) {
  const response = await fetch(`${BASE}${path}`, { headers, ...options });
  const body = await response.json();
  if (!body.success) throw new Error(`${body.error.code}: ${body.error.message}`);
  return body;
}

async function waitFor(transactionId, predicate, timeoutMs = 120_000) {
  const deadline = Date.now() + timeoutMs;
  while (Date.now() < deadline) {
    const { data } = await call(`/v3/bills/transactions/${transactionId}`);
    if (predicate(data)) return data;
    await sleep(2000);
  }
  throw new Error("Timed out");
}

// 0. Confirm the environment
const { data: identity } = await call("/v3/validate");
if (identity.key.type !== "SANDBOX") throw new Error("Not a sandbox key");

// 1. Discover
const { data: started } = await call("/v3/bills/discover", {
  method: "POST",
  body: JSON.stringify({
    partner: "ADE",
    account: { reference: "0123456789012345678901234" },
    ref: "disc-sbx-001",
  }),
});

// 2. Wait for the bills
const ready = await waitFor(started.transactionId, (t) => t.status === "READY");
console.log(ready.bills); // 1 bill @ 443.39 DZD

// 3. Pay the first one, with a NEW ref
await call("/v3/bills/pay", {
  method: "POST",
  body: JSON.stringify({
    transactionId: started.transactionId,
    billId: ready.bills[0].billId,
    ref: "pay-sbx-001",
  }),
});

// 4. Wait for a final state
const final = await waitFor(started.transactionId, (t) =>
  ["SUCCESS", "FAILED", "REFUNDED"].includes(t.status),
);
console.log(final.status, final.operationId);

// 5. Download the receipt
const receipt = await fetch(
  `${BASE}/v3/bills/transactions/${started.transactionId}/receipt`,
  { headers: { "X-Access-Token": KEY } },
);
await writeFile("receipt-sbx.bin", Buffer.from(await receipt.arrayBuffer()));

import os
import time
import requests

BASE = 'https://billapi.oneclickdz.com'
KEY = os.getenv('ONECLICKDZ_SANDBOX_API_KEY')
HEADERS = {'X-Access-Token': KEY, 'Content-Type': 'application/json'}


def call(method, path, payload=None):
    response = requests.request(method, f'{BASE}{path}', headers=HEADERS, json=payload)
    body = response.json()
    if not body['success']:
        raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
    return body


def wait_for(transaction_id, predicate, timeout_s=120):
    deadline = time.monotonic() + timeout_s
    while time.monotonic() < deadline:
        data = call('GET', f'/v3/bills/transactions/{transaction_id}')['data']
        if predicate(data):
            return data
        time.sleep(2)
    raise TimeoutError('Timed out')


# 0. Confirm the environment
identity = call('GET', '/v3/validate')['data']
assert identity['key']['type'] == 'SANDBOX', 'Not a sandbox key'

# 1. Discover
started = call('POST', '/v3/bills/discover', {
    'partner': 'ADE',
    'account': {'reference': '0123456789012345678901234'},
    'ref': 'disc-sbx-001'
})['data']

# 2. Wait for the bills
ready = wait_for(started['transactionId'], lambda t: t['status'] == 'READY')
print(ready['bills'])  # 1 bill @ 443.39 DZD

# 3. Pay the first one, with a NEW ref
call('POST', '/v3/bills/pay', {
    'transactionId': started['transactionId'],
    'billId': ready['bills'][0]['billId'],
    'ref': 'pay-sbx-001'
})

# 4. Wait for a final state
final = wait_for(
    started['transactionId'],
    lambda t: t['status'] in ('SUCCESS', 'FAILED', 'REFUNDED')
)
print(final['status'], final.get('operationId'))

# 5. Download the receipt
receipt = requests.get(
    f"{BASE}/v3/bills/transactions/{started['transactionId']}/receipt",
    headers={'X-Access-Token': KEY}
)
with open('receipt-sbx.bin', 'wb') as handle:
    handle.write(receipt.content)

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

function call(string $method, string $path, ?array $payload = null): array
{
    $ch = curl_init(BASE . $path);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json',
        'X-Access-Token: ' . getenv('ONECLICKDZ_SANDBOX_API_KEY')
    ]);
    if ($payload !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
    }

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

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

    return $body;
}

function waitFor(string $transactionId, callable $predicate, int $timeoutSeconds = 120): array
{
    $deadline = time() + $timeoutSeconds;
    while (time() < $deadline) {
        $data = call('GET', "/v3/bills/transactions/$transactionId")['data'];
        if ($predicate($data)) {
            return $data;
        }
        sleep(2);
    }
    throw new Exception('Timed out');
}

// 0. Confirm the environment
$identity = call('GET', '/v3/validate')['data'];
if ($identity['key']['type'] !== 'SANDBOX') {
    throw new Exception('Not a sandbox key');
}

// 1. Discover
$started = call('POST', '/v3/bills/discover', [
    'partner' => 'ADE',
    'account' => ['reference' => '0123456789012345678901234'],
    'ref'     => 'disc-sbx-001'
])['data'];

// 2. Wait for the bills
$ready = waitFor($started['transactionId'], fn($t) => $t['status'] === 'READY');
print_r($ready['bills']); // 1 bill @ 443.39 DZD

// 3. Pay the first one, with a NEW ref
call('POST', '/v3/bills/pay', [
    'transactionId' => $started['transactionId'],
    'billId'        => $ready['bills'][0]['billId'],
    'ref'           => 'pay-sbx-001'
]);

// 4. Wait for a final state
$final = waitFor(
    $started['transactionId'],
    fn($t) => in_array($t['status'], ['SUCCESS', 'FAILED', 'REFUNDED'], true)
);
echo $final['status'] . ' ' . ($final['operationId'] ?? '');

// 5. Download the receipt
$ch = curl_init(BASE . "/v3/bills/transactions/{$started['transactionId']}/receipt");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Access-Token: ' . getenv('ONECLICKDZ_SANDBOX_API_KEY')
]);
file_put_contents('receipt-sbx.bin', curl_exec($ch));
curl_close($ch);
?>