المطوّرون

إصدار تجريبي

أضف الدفع بكف اليد إلى نظام POS خلال ساعات.

يطلب نظام POS من تطبيق VenaPass على الجهاز نفسه التعرّف على العميل. فتحصل على رقم العميل الخاص بك ورمز موقّع يمكن لمزوّد خدمات الدفع الوثوق به.

أجهزة POS بنظام Android: افتح شاشة الدفع

يعرض VenaPass المبلغ ويمسح الكف ويُعيد النتيجة. المبالغ بالوحدات الصغرى مع رمز عملة وفق ISO 4217.

val pay = Intent("com.venapass.action.PAY")
    .putExtra("amount", 500000L)        // NGN 5,000.00
    .putExtra("currency", "NGN")
    .putExtra("terminal_id", "LEKKI-POS-1")
    .putExtra("request_id", UUID.randomUUID().toString())
startActivityForResult(pay, PAY_WITH_PALM)

// Result extras: success, customer_ref,
// assertion, receipt_id (gateway mode), message

عنوان البوابة: استدعِ التطبيق على الجهاز

لبرامج POS التي تتيح ضبط عنوان بوابة الدفع. أعِد المحاولة بقيمة request_id نفسها، ولا تستخدم قيمة جديدة أبدًا.

POST http://127.0.0.1:9090/api/pay_direct
{ "amount": 500000, "currency": "NGN",
  "terminal_id": "LEKKI-POS-1",
  "request_id": "6f1c2e9a-…" }

200 OK
{ "success": true,
  "customer_ref": "CUST-1042",
  "assertion": "eyJhbGciOiJFZERTQSIs…",
  "receipt_id": null,
  "message": "Identity verified" }

لمزوّدي خدمات الدفع: تحقّق من الرمز

التأكيد هو رمز JWT قياسي موقّع (EdDSA)، ويمكن لأي مكتبة JWT التحقق منه باستخدام مفاتيحنا العامة:

https://api.venapass.com/.well-known/venapass-keys

الحقل sub هو مرجع العميل الخاص بك، فتخصم من وسيلة الدفع المسجّلة لديك لهذا العميل.

  1. 1التوقيع صحيح بمفتاح VenaPass ساري المفعول.
  2. 2الرمز لم تنتهِ صلاحيته (تبقى الرموز صالحة نحو دقيقتين).
  3. 3txn يطابق تمامًا المبلغ والعملة اللذين ستخصمهما.
  4. 4terminal_id يطابق جهاز POS الذي أرسل عملية البيع.
  5. 5لم يسبق لك قبول قيمة jti هذه من قبل.

وضع البوابة: استقبل طلبات الخصم من VenaPass

إذا اخترت وضع البوابة، نرسل كل عملية بيع تم التحقق من صاحبها إلى عنوانك، موقّعة بسرّ لا يعرفه سوانا وأنت. تعامل مع request_id كمفتاح لمنع التكرار.

POST https://your-provider.example/venapass
X-VenaPass-Signature: sha256=<HMAC of the body>
{ "assertion": "eyJ…", "customer_ref": "CUST-1042",
  "amount": 500000, "currency": "NGN",
  "terminal_id": "LEKKI-POS-1", "request_id": "6f1c…" }

Reply: { "approved": true, "reference": "PSP-88213",
         "message": "Approved" }

سجّل العملاء من نظام POS

شغّل com.venapass.action.ENROLL مع قيمة customer_refالخاصة بك. يرشد VenaPass العميل خلال ثلاث مسحات للكف ثم يُعيد نتيجة النجاح. لا يُرسَل إلينا أي اسم أو رقم هاتف.

اطلب الوصول إلى بيئة الاختبار