اختبار Sandbox - OneClickDz Flexy API

كيف تعمل Sandbox

يستخدم مفتاح Sandbox عنوان URL الأساسي نفسه والمسارات نفسها والغلاف نفسه والحالات نفسها وآلية استطلاع الحالة نفسها المعتمدة في الإنتاج. الفروق:

لا يُتواصل مع أي مُصدِر فاتورة ولا تُنقل أي أموال.
تُحدَّد النتيجة وفق معرّف الحساب الذي ترسله (الجداول أدناه). أي معرّف آخر يُعيد فاتورة واحدة بمبلغ 500.00 DZD ودفعة ناجحة.
يكتمل الاكتشاف في نحو 0.2 s والدفع في نحو 0.5 s، لذا يظل على آلية استطلاع الحالة لديك التعامل مع PENDING وPROCESSING.
تُفيد GET /v3/bills/partners بأن جميع مُصدِري الفواتير بالحالة ACTIVE.
الإيصالات صور PNG.
معاملات Sandbox والإنتاج منفصلة تمامًا. لا يرى مفتاح Sandbox أبدًا معاملة إنتاج، والعكس صحيح.

تحقّق من البيئة التي ينتمي إليها مفتاح ما باستخدام التحقّق من رمز الوصول.

حسابات الاختبار

ADE

account: { "electronic_payment_key": "<value>" }

`electronic_payment_key`	الاكتشاف	الدفع
`0123456789012345678901234`	فاتورة واحدة، 443.39 DZD	`SUCCESS`
`0123456789012340000000001`	فاتورة واحدة، 320.00 DZD	`SUCCESS`
`0123456789012340000000002`	`READY`، `bills: []`	—
`0123456789012341111111111`	`READY`، `bills: []`	—
`0123456789012340000000004`	فاتورة واحدة، 400.00 DZD	`FAILED`، `PAYMENT_DECLINED`
`0123456789012340000000005`	فاتورة واحدة، 550.00 DZD	`REFUNDED`، `PAYMENT_DECLINED`
`0001234567890000000000000`	فاتورة واحدة، 600.00 DZD	`REFUNDED`، `PAYMENT_DECLINED`
`0123456789012340000000006`	`409 BILL_ALREADY_PAID`	—
`0123456789012347777777777`	`409 BILL_ALREADY_PAID`	—
`0123456789012345005005005`	`503 PARTNER_UNAVAILABLE`	—
`abc0000000000000000000000`	`400 INVALID_ACCOUNT`	—

SONELGAZ

account: { "sonelgaz": { "invoice_number": "<value>", "amount_without_stamp": "1200.00", "ebb_key": "123456" } } — تتوقّف النتيجة على invoice_number؛ ويكفي أن يكون الحقلان الآخران موجودين.

`invoice_number`	الاكتشاف	الدفع
`9876543210`	فاتورتان، 1200.00 و850.00 DZD	`SUCCESS`
`4004004004`	فاتورة واحدة، 500.00 DZD	`FAILED`، `PAYMENT_DECLINED`
`6006006006`	فاتورة واحدة، 900.00 DZD	`UNKNOWN` لمدة 60 s تقريبًا، ثم `REFUNDED`
`0000000003`	`READY`، `bills: []`	—

SEAAL

account: { "seaal": { "code_client": "<value>", "code_contrat": "446563" } } — تتوقّف النتيجة على code_client؛ ويكفي أن يتكوّن code_contrat من 2 إلى 10 أرقام.

`code_client`	الاكتشاف	الدفع
`100001`	5 فواتير فصلية (456.33 × 3، 327.00 × 2)	`SUCCESS` (اختبر `billIds` هنا)
`100002`	فاتورة واحدة، 512.75 DZD	`SUCCESS`
`100003`	`FAILED`، `BILL_ALREADY_PAID`	—
`100004`	فاتورة واحدة، 389.10 DZD	`FAILED`، `PAYMENT_DECLINED`
`100005`	`FAILED`، `INVALID_ACCOUNT`	—

AADL

account: { "aadl": { "codeloc": "<value>" } }

`codeloc`	الاكتشاف	الدفع
`1112223334`	إشعار واحد، 5400.00 DZD، مع `breakdown`	`SUCCESS`
`2223334445`	إشعار واحد، 12000.00 DZD، مع `breakdown` يُظهر فترتين غير مدفوعتين	`SUCCESS`
`3334445556`	`READY`، `bills: []`	—
`4445556667`	`FAILED`، `BILL_ALREADY_PAID`	—

نقطة النهاية الخاصة بإشعار AADL (/avis) غير متاحة في Sandbox.

SEOR

account: { "seor": { "contrat": "100001", "facture": "<value>" } } — تتوقّف النتيجة على facture؛ ويكفي أن يتكوّن contrat من 1 إلى 6 أرقام.

`facture`	الاكتشاف	الدفع
`00102026S000000001`	فاتورة واحدة، 1003.20 DZD، الفترة `2/2026`	`SUCCESS`
`00102026S000000002`	`FAILED`، `BILL_ALREADY_PAID`	—
`00102026S000000003`	`FAILED`، `INVALID_ACCOUNT`	—
`00102026S000000004`	فاتورة واحدة، 850.40 DZD	`UNKNOWN`، لا يُسترد تلقائيًا أبدًا

Algérie Télécom

account: { "phone_number": "<value>" }

`phone_number`	الاكتشاف	الدفع
`023456789`	فاتورة واحدة، 300.00 DZD	`SUCCESS`

أخطاء يمكنك إثارتها

الطريقة	النتيجة
احذف الترويسة `X-Access-Token`	`401 MISSING_ACCESS_TOKEN`
أرسل مفتاحًا خاطئًا	`401 INVALID_ACCESS_TOKEN`
أرسل قيمة `ref` نفسها مرتين إلى `discover` للشريك نفسه	`403 DUPLICATED_REF`
أرسل معرّفين في `account`	`400 ERR_VALIDATION`
أعد استخدام `ref` الاكتشاف في `pay`	`403 DUPLICATED_REF`
ادفع معاملة ليست بالحالة `READY` (ما زالت `PENDING`، أو مدفوعة مسبقًا)	`404 NOT_FOUND`
ادفع بـ `billId` غير موجود في `bills[]` الخاصة بالمعاملة	`404 NOT_FOUND`

تشغيل كامل في Sandbox

# 1. Discover
curl -X POST https://api.oneclickdz.com/v3/bills/discover \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY" -H "Content-Type: application/json" \
  -d '{"partner":"SONELGAZ","account":{"sonelgaz":{"invoice_number":"9876543210","amount_without_stamp":"1200.00","ebb_key":"123456"}},"ref":"test-0001"}'

# 2. Read the bills (repeat until READY)
curl https://api.oneclickdz.com/v3/bills/transactions/{transactionId} \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY"

# 3. Pay one of the bills
curl -X POST https://api.oneclickdz.com/v3/bills/pay \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY" -H "Content-Type: application/json" \
  -d '{"transactionId":"{transactionId}","billId":"{billId}","ref":"test-0001-pay"}'

# 4. Confirm (repeat until SUCCESS / FAILED / REFUNDED)
curl https://api.oneclickdz.com/v3/bills/transactions/{transactionId} \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY"

# 5. Receipt
curl https://api.oneclickdz.com/v3/bills/transactions/{transactionId}/receipt \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY" --output receipt.png

قبل الانتقال إلى الإنتاج

تتعامل آلية استطلاع الحالة لديك مع كل حالة، بما فيها UNKNOWN (SONELGAZ 6006006006).
لا تترك الدفعة بالحالة FAILED أو REFUNDED أي مبلغ محصّل من عميلك.
لا يؤدي الرمز 409 أو 403 أو انتهاء المهلة أبدًا إلى استدعاء pay ثانٍ.
يستخدم كل استدعاء pay قيمة ref جديدة.
تعرض الطلبات متعددة الفواتير selectedBills بشكل صحيح (SEAAL 100001).
تُخزَّن الإيصالات مع operationId.
يُحمَّل مفتاح الإنتاج من الإعدادات، وليس من الشيفرة البرمجية أبدًا.

​كيف تعمل Sandbox

​حسابات الاختبار

​ADE

​SONELGAZ

​SEAAL

​AADL

​SEOR

​Algérie Télécom

​أخطاء يمكنك إثارتها

​تشغيل كامل في Sandbox

​قبل الانتقال إلى الإنتاج