بيئة التجربة | مطورو AurMap

ما هي

بيئة التجربة نسخة كاملة من الواجهة، ببيانات منفصلة تماما. نفس القواعد ونفس الأخطاء ونفس الأحداث. الفرق الوحيد: لا مال حقيقي، ولا عملاء حقيقيون.

	التجربة	التشغيل
العنوان	`https://sandbox.partners.aurmap.com/v1` (متاح الآن)	`https://partners.aurmap.com/v1` (يفتح لكل مطور بعد اعتماده)
المفاتيح	`pk_test_xxx` / `sk_test_xxx`	`pk_live_xxx` / `sk_live_xxx`
`mode` في الردود والأحداث	`test`	`live`

عنوان التجربة يعمل الآن بمفاتيح التجربة. عنوان التشغيل يفتح لكل مطور بعد مراجعة تكامله واعتماده.

التجار التجريبيون

مع كل حساب شريك:

التاجر	الأماكن	يصلح لـ
مطعم تجريبي	فرعان: `plc_test_olaya` و`plc_test_malqa`	القوائم والطلبات
متجر تجريبي	فرع واحد	المنتجات والمخزون قريبا

تراها في لوحة المطورين تحت «بيئة التجربة»، وتستطيع فتح صفحاتها في تطبيق AurMap التجريبي.

موافقة الربط دون انتظار

أصدر رمزا كالعادة، ثم وافق عليه نيابة عن التاجر:

bash

aurmap POST /v1/sandbox/link-codes/7KQ2M9XA/approve '{"place_id":"plc_test_olaya"}'

json

{ "code": "7KQ2M9XA", "status": "redeemed", "link_id": "lnk_test_2h6j4n" }

ولتجربة الرفض: POST /sandbox/link-codes/{code}/decline.

اصنع طلبا

bash

aurmap POST /v1/sandbox/orders '{"place_id":"plc_test_olaya","items":[{"item_id":"chicken-burger","size_id":"l","qty":1,"options":[{"group_id":"sauce","option_id":"hot"}]}],"payment":{"method":"cash"},"customer":{"name":"عميل تجريبي","phone_e164":"+966500000099"}}'

json

{ "order_id": "ord_test_9k2p4a", "number": "M-1002", "status": "received", "accept_by": "2026-10-14T12:50:00Z", "totals": { "currency": "SAR", "total_minor": 3220 }, "payment": { "method": "cash", "status": "unpaid", "amount_minor": 3220 } }

الطلب يسعر من قائمتك المنشورة كما في التشغيل، ويصلك order.created.

const order = await aurmap('POST', '/v1/sandbox/orders', {
  place_id: 'plc_test_olaya',
  items: [{ item_id: 'chicken-burger', size_id: 'l', qty: 1, options: [{ group_id: 'sauce', option_id: 'hot' }] }],
  payment: { method: 'card' },
});

php

$order = aurmap('POST', '/v1/sandbox/orders', [
    'place_id' => 'plc_test_olaya',
    'items' => [['item_id' => 'chicken-burger', 'size_id' => 'l', 'qty' => 1, 'options' => [['group_id' => 'sauce', 'option_id' => 'hot']]]],
    'payment' => ['method' => 'card'],
]);

حاكي الطرف الآخر

الطلب	يحاكي	النتيجة
`POST /sandbox/orders/{id}/customer-cancel`	العميل يلغي قبل القبول	`order.cancelled` بسبب `customer`
`POST /sandbox/orders/{id}/expire`	انتهت مهلة القبول الآن	`order.cancelled` بسبب `timeout`
`POST /sandbox/orders/{id}/aurmap-refund`	دعم AurMap استرجع المبلغ	`order.cancelled` بسبب `aurmap_refund`

bash

aurmap POST /v1/sandbox/orders/ord_test_9k2p4a/customer-cancel

json

{ "order_id": "ord_test_9k2p4a", "status": "cancelled", "cancel": { "reason": "customer", "by": "customer" } }

إذا كان الطلب مقبولا، يرد customer-cancel بـ 409 ALREADY_ACCEPTED، تماما كما في التشغيل.

تستطيع أيضا تقصير مهلة القبول إلى دقيقة واحدة من اللوحة، لتجربة انتهاء المهلة بسرعة.

بطاقات الدفع التجريبية

لا تحتاج بطاقات لاختبار نظامك. POST /sandbox/orders يضع حالة الدفع مباشرة.

إذا أردت تجربة الدفع من تطبيق AurMap التجريبي بنفسك، استعمل البطاقات التجريبية المنشورة في لوحة المطورين:

النتيجة	البطاقة
دفع ناجح	قريبا
رفض من البنك	قريبا
تحقق إضافي (3-D Secure)	قريبا

إرسال حدث تجريبي

زر «إرسال تجربة» في صفحة Webhooks يرسل endpoint.test إلى عنوانك. استعمله لتتأكد من التحقق من التوقيع قبل أي شيء آخر.

البدء من جديد

bash

aurmap POST /v1/sandbox/reset

يحذف كل الطلبات والروابط والقوائم في بيئة التجربة لحسابك. التجار التجريبيون يبقون. البيانات الأقدم من 30 يوما تحذف تلقائيا.