Discovering Bills

curl -X POST https://api.oneclickdz.com/v3/bills/discover \
  -H "X-Access-Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "partner": "ADE",
    "account": { "electronic_payment_key": "0123456789012345678901234" },
    "ref": "disc-20260920-0001"
  }'

const response = await fetch("https://api.oneclickdz.com/v3/bills/discover", {
  method: "POST",
  headers: {
    "X-Access-Token": process.env.ONECLICKDZ_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    partner: "ADE",
    account: { electronic_payment_key: "0123456789012345678901234" },
    ref: "disc-20260920-0001",
  }),
});

const body = await response.json();
if (!body.success) throw new Error(`${body.error.code}: ${body.error.message}`);

const { transactionId } = body.data; // status is PENDING

import os, requests

response = requests.post(
    "https://api.oneclickdz.com/v3/bills/discover",
    headers={"X-Access-Token": os.environ["ONECLICKDZ_API_KEY"]},
    json={
        "partner": "ADE",
        "account": {"electronic_payment_key": "0123456789012345678901234"},
        "ref": "disc-20260920-0001",
    },
)

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

transaction_id = body["data"]["transactionId"]  # status is PENDING

<?php
$ch = curl_init("https://api.oneclickdz.com/v3/bills/discover");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "X-Access-Token: " . getenv("ONECLICKDZ_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "partner" => "ADE",
        "account" => ["electronic_payment_key" => "0123456789012345678901234"],
        "ref" => "disc-20260920-0001",
    ]),
]);

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

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

$transactionId = $body["data"]["transactionId"]; // status is PENDING
?>