بيئة الاختبار

مسار 10 دقائق

• سجّل تاجراً → أكمل onboarding → أنشئ مفتاح sk_test_ من المطورين
• أنشئ رابط دفع أو Checkout session عبر API / SDK
• ادفع ببطاقة 4242… أو PayPal / تحويل بنكي / BTC / USDT / موبايل موني
• للإثباتات اليدوية: ارفع إيصالاً → أدمن → إثباتات الدفع → قبول/رفض
• أضف webhook وافتح deliveries بعد حدث test

وسائل الدفع (test)

• Card — 4242… نجاح · 4000…0002 رفض
• PayPal — نجاح فوري في test بدون مفاتيح
• Bank transfer — يعرض حساب بنكك التجريبي → ارفع إيصال → pending_review
• BTC / USDT — عنوان إيداع تجريبي → TxID أو لقطة → pending_review
• Mobile Money — SMS verify (رمز محاكى) ثم دفع بنقرة

مثال SDK (Node)

import { ZolnaPay } from '@zolnapay/sdk';

const zp = new ZolnaPay({
  secretKey: 'sk_test_…',
  baseUrl: 'https://api.zolnapay.com/v1',
});

const session = await zp.checkout.sessions.create({
  amountCents: 2000,
  currency: 'usd',
  description: 'Sandbox charge',
});

// Confirm with test card via Checkout UI, or:
await zp.payments.confirm(session.id, {
  type: 'card',
  card: { number: '4242424242424242', expMonth: 12, expYear: 2030, cvc: '123' },
});