محتويات يخفي
5 كوس webخطافات

منصة API

البدء

1. مرحباً

جديد! جمهور كروس ريفر مع طلبات مسبقة الصنع لمجموعة كروس بوستمان
نهر. نقاط نهاية واجهة برمجة التطبيقات

مرحباً بكم في كروس ريفر التوثيق

اكتشف واستكشف وابدأ في دمج منتجاتنا بكل سهولة

البدء السريع استكشف جميع المنتجات


يحصل بدأت
قم بإعداد وبدء تشغيل رحلة باستخدام واجهات برمجة تطبيقات Cross River

المفاهيم
اكتشف كيف يمكن لحلول Cross River أن تحول رحلتك في مجال التكنولوجيا المالية

واجهات برمجة التطبيقات
التطوير باستخدام الخدمات المصرفية عبر النهر
منصة ومجموعات API القوية

دروس تعليمية
تعلم كيفية استخدام Cross
واجهات برمجة تطبيقات النهر خطوة بخطوة

2. البدء السريع 

الخطوة 1
الخطوة 2
الخطوة 3
الخطوة 4

الحصول على رمز الوصول

استخدام رمز الوصول

بناء Sampلو التطبيق

الحصول على بيانات اعتماد API: خطوتك الأولى للعمل مع واجهات برمجة التطبيقات Cross River هي التسجيل للحصول على بيانات اعتماد واجهة برمجة التطبيقات.

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

استخدم رمز الوصول: بمجرد المصادقة بنجاح، رمز الوصول يتم إرجاعه إليك. قم بتضمين هذا الرمز في رأس مكالمات واجهة برمجة التطبيقات (API) الخاصة بك.

Webخطافات: Webتُعد الخطافات جزءًا مهمًا من أي تكامل مع Cross River. بينما تتيح لك واجهات برمجة التطبيقات طلب البيانات عند الطلب، webتدفع الخطافات التحديثات في الوقت الفعلي مباشرة إلى نظامك - مما يزيل الحاجة إلى الاستطلاع المستمر ويقلل من زمن الوصول.

بيئات Sandbox: صندوق الرمل عبارة عن بيئة معزولة تمامًا، لذا لا تتردد في

2.1. الحصول على بيانات اعتماد API

الخطوة 1
الحصول على بيانات اعتماد API

الخطوة 2
الحصول على رمز الوصول

الخطوة 3
استخدام رمز الوصول

الخطوة 4
بناء Sampلو التطبيق

خطوتك الأولى لاستخدام واجهات برمجة تطبيقات Cross River هي التسجيل للحصول على بيانات اعتماد واجهة برمجة التطبيقات. باستخدام هذه البيانات، يمكنك طلب واستلام رمز وصول لاستخدامه في إرسال واجهات برمجة التطبيقات في بيئة الاختبار الخاصة بنا.

مهم

يجب أن يكون عنوان IP الخاص بك عامًا وثابتًا، ومدرجًا في قائمتنا المسموح بها. يجب أن يكون قسم تكنولوجيا المعلومات الداخلي لديك قادرًا على تزويدك بهذا العنوان. تعرّف على المزيد حول عناوين IP الثابتة.

SandboxAccess

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

بمجرد إضافة عنوان IP الثابت الخاص بك إلى القائمة المسموح بها لدينا، سنرسل إليك رسالتين بريد إلكتروني مشفرتين تحتويان على بيانات اعتمادك:

يحتوي بريد إلكتروني واحد على معرف العميل معرف الشريك ومعلومات أخرى قد تحتاجها اعتمادًا على ما طلبته.

البريد الإلكتروني الثاني، والذي تم تشفيره، يحتوي على سر العميل و webسر الخطاف سوف تحتاج إلى هذه العناصر للمصادقة والعمل في بيئة الحماية.

ملحوظة

إذا طلبت الوصول إلى مدفوعات البطاقة، فسوف تتلقى مجموعة إضافية من بيانات الاعتماد بما في ذلك رقم تعريف شخصي ثانٍ معرف العميل و سر العميل

2.2. الحصول على رمز الوصول

الخطوة 1
الحصول على بيانات اعتماد API

الخطوة 2
الحصول على رمز الوصول

الخطوة 3

استخدام رمز الوصول

الخطوة 4
بناء Sampلو التطبيق

يستخدم كروس ريفر بروتوكول OAuth 2.0 للمصادقة والتفويض. يُتحكم هذا البروتوكول في الدخول إلى نظامنا ويضمن وصول الجهات المُصرّح لها فقط إلى واجهات برمجة التطبيقات (APIs) والموارد المحمية الأخرى. المعلومات التي تُدخلها في نظام المصادقة لدينا سرية، ولا يُمكن الوصول إليها من أي تطبيقات أخرى تابعة لكروس ريفر.

بمجرد استلامك، وقبل أن تتمكن من استخدام واجهات برمجة التطبيقات الخاصة بنا، يجب عليك الحصول على بيانات اعتماد واجهة برمجة التطبيقات رمز الوصول باستخدام معرف العميل و سر العميل استلمتَه عند التسجيل. يُمكّنك رمز الوصول هذا من إرسال المعلومات بأمان ككائن JSON لاستخدامها في واجهات برمجة التطبيقات (APIs) الخاصة بنا. يجب عليك تضمين هذا الرمز في عنوان كل طلب واجهة برمجة تطبيقات.

هناك عدة طرق لطلب رمز الوصول واستلامه:

استخدام واجهة سطر الأوامر (CLI) مع cURL أو أي لغة أخرى

استخدم Postman أو أي أداة اختبار API أخرى

بعد الحصول على رمز الوصول، انسخه إلى الحافظة. تأكد من حفظه.

واجهة سطر الأوامر

لطلب الرمز أرسل اتصال/رمز POST الأمر الذي يحتوي على معرف العميل و سر العميل و نوع_المنحة إلى (خادم المصادقة) لخادم المصادقة صندوق الرمل المناسب، كما هو موضح في الصورةampأدناه.

راجع للحصول على شرح لهذه tags. جدول مكونات HTTP

المثال التاليampيستخدم cURL لطلب رمز من أحد خوادم المصادقة.

Sampطلب في جURL لـ COS

curl –الموقع –طلب 'POST https://idptest.crbcos.com/connect/token' –header 'نوع المحتوى: application/x-www-form-urlمُرمَّز \ -بيانات-urlترميز 'client_id=[معرفك هنا]' \

 -بيانات-urlترميز 'client_secret=[سرك هنا]' \

 -بيانات-urlترميز 'نوع المنحة=بيانات اعتماد العميل' \

 -بيانات-urlترميز 'الجمهور=https://api.crbcos.com/'

Sampالرد من جURL طلب

"رمز الوصول""يحتوي على العديد من الشخصيات"، \

 "ينتهي في"86400، \

 "نوع الرمز المميز""حامل" }

ساعي البريد

لطلب رمز مميز باستخدام Postman، أرسل اتصال/رمز POST الأمر إلى المصادقة الخادم من صندوق الرمل المناسب. أضف نوع_المنحة النطاق (اختياري) ,

معرف العميل و سر العميل إلى المكالمة.

راجع للحصول على شرح لهذه tags. جدول مكونات HTTP

إذا كان المصادقة ناجحة، فسيكون رمز الحالة هو 200 (موافق).

مستكشف COS

في ، انقر فوق السهم لأسفل بجوار تسجيل الدخول الخاص بك وانقر فوق نسخ رمز الوصول. مستكشف COS

تم نسخ رمز الوصول إلى الحافظة الخاصة بك، وجاهز للاستخدام في . Sandbox

استجابة طلب الرمز

وصف السمة

الوصول إلى

كين

JSON موقع رقميًا web الرمز المميز (JWT) المرسل من خادم oAuth الذي يسمح بالوصول إلى موارد Cross River المحددة

نِطَاق

مجموعة من الخدمات التي يمكن للمستخدم الوصول إليها

تنتهي صلاحيتها

n

مقدار الوقت حتى انتهاء صلاحية الرمز.

– سيقوم فريق التكامل الخاص بنا بإعلامك بموعد انتهاء الصلاحية أو يمكنك فك تشفير رمز الوصول الخاص بك أيضًا.

- نوصيك باسترداد رمز وصول جديد قبل فترة قصيرة من انتهاء صلاحية الرمز القديم.

- إعادة استخدام الرموز طوال فترة حياتها بدلاً من الحصول على رمز جديد لكل استدعاء لنفس المورد المحمي (API).

مهم:

لا تقم أبدًا بفك تشفير الرمز الخاص بك على موقع مستضاف بشكل عام webموقع

نوع الرمز

رمز حامل

مكونات HTTP

يتم استخدام مكونات HTTP التالية في كل من طلبات API وPostman.

HTTP

عنصر

Tag وصف

نقطة النهاية

بريد

/connect/toke n

نقطة نهاية لاسترجاع رمز الوصول

رأس الصفحة

محتوى

يكتب

التطبيق/x-www-form- urlمُشفّر

جسم

معرف العميل

المعرف الفريد للعميل

جسم

سر العميل

سلسلة مشفرة من الأحرف تستخدم لتوقيع رموز الهوية والتحقق منها.

مهم: لا يمكن استرداد الأسرار بواسطة CR. في حال فقدان سر، يجب إنشاء سر جديد.

لا قم بإدخال أسرارك إلى نظام التحكم بالمصادر.

جسم

نوع_المنحة

سيكون لهذا الحقل دائمًا قيمة

بيانات اعتماد العميل

جسم

جمهور

خياري

طريقة للمستخدم للتحقق من أن رمز الوصول المحدد مخصص له.

جسم

نِطَاق

خياري

نطاق محدد أو مجموعة محدودة من الخدمات التي يمكن للمستخدم الوصول إليها باستخدام رمز الوصول.

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

ملحوظة: يمكن إرسال نطاقات متعددة في نفس الطلب بإضافة مسافة بين اسم كل نطاق. على سبيل المثالampلو: 'النطاق = النطاق 1 النطاق 2 النطاق 3'

خادم المصادقةURLs

خادم مصادقة الوحدة النمطية URL

الحسابات

https://idptest.crbcos.com/connect/token

أي سي إتش

https://idptest.crbcos.com/connect/token

الأسلاك

https://idptest.crbcos.com/connect/token

الشيكات

https://idptest.crbcos.com/connect/token

جوهر

https://idptest.crbcos.com/connect/token

المدفوعات الفورية

https://idptest.crbcos.com/connect/token

إصدار البطاقة

https://idptest.crbcos.com/connect/token

مدفوعات البطاقات

https://crbcos-sandbox.auth0.com/oauth/token

الإقراض https://oauthtest.crbnj.net/connect/token

استكشاف الأخطاء وإصلاحها

إذا كان رمز المصادقة صالحًا، فسوف يعيد 200. إذا لم يكن رمز المصادقة صالحًا، فسوف يعيد 401.

إذا لم تتمكن من الحصول على رمز حامل ولم تتلق واحدًا في الماضي:

تأكيد URL.

تأكد من أن معرف العميل و سر العميل تمت كتابتها بشكل صحيح. وهي حساسة لحالة الأحرف.

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

اتصل بنا إذا تم قفل حسابك نتيجة تسجيل دخول غير صحيح لفريق التكامل المحاولات.

2.3. استخدم رمز الوصول

الخطوة 1
الحصول على بيانات اعتماد API

الخطوة 2
الحصول على رمز الوصول

الخطوة 3
استخدام رمز الوصول

الخطوة 4
بناء Sampلو التطبيق

بمجرد نجاحك، سيتم إنشاء رمز الوصول يتم إرجاعها إليك. تشمل المصادقة هذا الرمز في رأس مكالمات واجهة برمجة التطبيقات الخاصة بك.

تنتهي صلاحية رمز الوصول بعد فترة زمنية محددة. كما يُحدد الرد الذي يحتوي على الرمز وقت انتهاء الصلاحية بالثواني. خزّن رمز الوصول الخاص بك واستخدمه حتى انتهاء صلاحيته. نوصي باستخدام الرمز حتى تتلقى خطأ 401 غير مصرح به، ثم اطلب رمزًا جديدًا.

مهم

1. لا تطلب رمزًا جديدًا لكل طلب API.

2. تأكد من حماية رمزك. أي شخص يسرق رمزك يمكنه انتحال شخصية عميلك طوال مدة الرمز.

رأس طلب واجهة برمجة التطبيقات

في رأس كل طلب API، قم بتضمين رمز الوصول على النحو التالي:

Sampطلب دفع سلكي في جURL

curl –location –request 'POST https://sandbox.crbcos.com/Wires/v1/payments' –header 'التفويض: حامل [رمزك هنا]' \

–header 'نوع المحتوى: application/x-www-form-urlمُرمَّز \

–البيانات الخام ‘{

 رقم الحساب: 2255685659

 "businessFunctionCode": "CTR"،

 "رقم توجيه المتلقي": "021000021"،

 "المستفيدFi": {

 “idCode”: “F”،

 "المعرف": "021000021"،

 "الاسم": "جي بي مورغان تشيس"

 },

 "المستفيد": {

 “idCode”: “D”،

 "المعرف": "123456789"،

 "الاسم": "بيتر جريفين"

 },

 "المرجع المستفيد": "XYZ123"،

 "المبلغ": 10000،

 "الغرض": "الدفع"

}'

ساعي البريد

لاستخدام رمز مميز في Postman، انتقل إلى التفويض علامة التبويب في طلبك، حدد رمز حامل كنوع المصادقة، ثم ألصق الرمز الخاص بك في الحقل المُخصص. سيضيف بوستمان الرمز تلقائيًا حامل البادئة والرمز إلى الرمز المميز مجال.

2.4. Webخطافات

Webتُعد الخطافات جزءًا مهمًا من أي تكامل مع Cross River. بينما تتيح لك واجهات برمجة التطبيقات طلب البيانات عند الطلب، webتُرسل الخطافات التحديثات الفورية مباشرةً إلى نظامك، مما يُلغي الحاجة إلى الاستطلاعات المستمرة ويُقلل زمن الوصول. في كثير من الحالات، webتعد الخطافات أكثر كفاءة وموثوقية من واجهات برمجة التطبيقات وحدها، مما يضمن بقاء تطبيقك متزامنًا مع الأحداث الهامة مثل تغييرات الحساب وتحديثات المعاملات ونتائج المعالجة.

يستخدم webخطافات ضمن أنظمة كروس ريفر لإعلامك عند وقوع أحداث مختلفة. يُرجع الحدث كائن مورد يحتوي على تفاصيل ذات صلة بموضوع كل حدث. تُضمَّن تفاصيل الحدث كاملةً وتُرسَل إلى نظامك.

نحن نستخدم webخطافات لتحديثك بشأن الحالة والإبلاغ عن تغييرات المعاملات. Webترسل الخطافات تقريرًا إلى نظامك بإشعارات في الوقت الفعلي عند حدوث حدث ما.

يجب عليك التسجيل عبر واجهة برمجة التطبيقات (API) لاستخدامها webالخطافات:

التسجيل للحصول على الحسابات والبطاقات وفعاليات الدفع

سجل للحصول على فعاليات الدفع بالبطاقة

سجل لفعاليات الإقراض

2.5. بيئات Sandbox

بيئة العمل لدينا معزولة تمامًا، لذا لا تتردد في التجربة. عندما تكون مستعدًا للانتقال إلى بيئة الإنتاج، أخبرنا وسنزودك ببيانات الإنتاج اللازمة للوصول إلى بيئة العمل المباشرة.

إدارة العملاء

قاعدة الوحدة URL لمكالمات API

إدارة العملاء https://sandbox.crbcos.com/core/ الحسابات

قاعدة الوحدة URL لمكالمات API

حسابات الودائع

https://sandbox.crbcos.com/core/

عمليات مسح الودائع https://sandbox.crbcos.com/sweepsintrafi/ بطاقات

قاعدة الوحدة URL لمكالمات API

البطاقات https://sandbox.crbcos.com/cardmanagement/المدفوعات

قاعدة الوحدة URL لمكالمات API

المدفوعات الفورية

https://sandbox.crbcos.com/rtp/

مدفوعات البطاقات: ادفع للدفع

https://pushtopaystaging.crbnj.net/

مدفوعات البطاقة: سحب

https://pullfromcardapistg.crbnj.net/

المدفوعات الدولية

https://sandbox.crbcos.com/international/

أي سي إتش

https://sandbox.crbcos.com/ach/

الأسلاك

https://sandbox.crbcos.com/wires/

الشيكات https://sandbox.crbcos.com/checks/ كوسwebخطافات

قاعدة الوحدة URL لمكالمات API

كوس webخطافات

https://sandbox.crbcos.com/webhooks/

الإقراض

قاعدة الوحدة URL لمكالمات API

نشأة القرض

https://arixapisandbox.crbnj.net

اتخاذ القرار بشأن التطبيق https://lendingsandbox.crbcos.com/preapproval/v1

2.6. مجموعة ساعي البريد

لتسهيل التطوير، قمنا بتجميع مجموعة من العناصر المبنية مسبقًا

مجموعة ساعي البريد طلبات لجميع خدمات نهر كروس. استخدم هذه المجموعة لاستكشاف نقاط نهاية واجهة برمجة التطبيقات (API) واختبارها وبنائها. التكامل الخاص بك مباشرة في Postman. مع الحد الأدنى من الترميز الإضافي والإعداد المطلوب. لتقسيم مجموعتنا على الفور، انقر فوق

ما عليك سوى إكمال تفاصيل الإعداد والبدء في إجراء المكالمات في مجموعة Sandbox Postman خلال .

ساعي البريد

رمز الوصول (الحامل)

لقد أنشأنا بيئة اختبار مطوري Postman لتوفير مساحة آمنة لاختبار واجهات برمجة تطبيقات Cross River. في مجموعة Cross River Postman، يمكنك إجراء المصادقة باستخدام رمز حامل.

للحصول على المعرفات، يتعين عليك إعداد رمز الوصول (الحامل) المطلوب لتشغيل المجموعة:

1. :باستخدام هذه البيانات يمكنك طلب رمز الوصول واستلامه

الحصول على بيانات اعتماد API
لاستخدامها في إرسال واجهات برمجة التطبيقات في بيئة الحماية الخاصة بنا

2. :بمجرد استلام بيانات اعتماد واجهة برمجة التطبيقات الخاصة بك وقبل أن تتمكن من استخدام

الحصول على رمز الوصول
واجهات برمجة التطبيقات، يمكنك الحصول على رمز وصول باستخدام معرف العميل و سر العميل لقد تلقيت عندما قمت بالتسجيل.

مجموعة فورك كروس ريفر

توجه مباشرة إلى فرعنا لتجميع مجموعتنا.

مساحة عمل ساعي البريد

بمجرد التشعب، لا تنسَ تعيين متغيرات البيئة الخاصة بك لصندوق الحماية.

قم بتكوين بيئة Postman الخاصة بك

لاستخدام المجموعة التي قمت بإنشائها للتو، انتقل إليها وانقر فوق البيئات، وحدد صندوق الرمل. انسخ معرف عميل Cross River وسر العميل، ثم ألصقهما في معرف العميل و سر العميل بالنسبة لمدفوعات البطاقات، ألصقها في الحقول معرف عميل ptpe و سر عميل ptpe الحقول.

أنت الآن جاهز للحصول على الرمز والبدء في إرسال الطلبات.

1. يجري التفويض/الحصول على الرمز لتوليد رمزك المميز. لمدفوعات البطاقات، شغّل مدفوعات البطاقات/التفويض/الحصول على رمز P2PE .

2. المتغير {{token}} (أو رمز ptpe للدفع بالبطاقات، تتم إضافته تلقائيًا إلى بيئتك عبر نص برمجي للرد. عند انتهاء صلاحية الرمز، عليك اتباع الخطوة ١ مرة أخرى.

3. هناك عدة متغيرات قد تحتاج إلى ملؤها حسب نقطة النهاية التي تستخدمها. على سبيل المثالampليه معرف الشريك معرف المنتج معرف التكوين و أتصل مرة أخرى_url .

4. هناك أيضًا بعض المتغيرات التي يتم ملؤها من خلال البرامج النصية، مثل الرمز المميز و رمز ptpe والتي لا ينبغي أن يتم ملؤها يدويًا.

بينغثيساندابوكس

قم بإجراء اختبار بسيط للتأكد من إمكانية الاتصال بصندوق الحماية Cross River.

لإرسال طلب Ping، افتح في Postman المجموعات > مجموعة API الخاصة بـ Cross River > التفويض وتشغيل بينغ نقطة النهاية.

تعديل الطلبات

لتحديث الطلب، قم بإجراء التغييرات على جسم جدول القيم بحرف c المزدوجurlأقواس y تُستخرج من متغيرات بيئتك. راجع موقعنا لمعرفة الحقول التي تحتوي عليها كل وثيقة API.

نقطة النهاية تقبل، و view الطلبات باللغة المفضلة لديك.

3. بناء كـampالتطبيق

الخطوة 1
الحصول على بيانات اعتماد API يثبت

الخطوة 2
الحصول على رمز الوصول

الخطوة 3
استخدام رمز الوصول

الخطوة 4
بناء Sampلو التطبيق

قبل البدء، راجع دليل البدء السريع للاتصال بواجهات برمجة التطبيقات (APIs) الخاصة بنا. لاختبار استدعاءات واجهة برمجة التطبيقات، يمكنك استخدام cURL من سطر الأوامر، أو خدمة مثل Postman أو Swagger في صندوق الحماية الخاص بنا.

العملاء والحسابات
:قبل استخدام خدمات Cross River، تحتاج إلى إنشاء سجل العملاء لكل عميل من عملائك

بطاقات
:قم بإدارة بطاقات عملائك من خلال العمل مع Cross River لتحديد ما تريد تقديمه، مثل البطاقات المادية أو الافتراضية.

الإقراض
:يتضمن الإقراض مجموعة من استدعاءات واجهات برمجة تطبيقات الإقراض للسماح لك بإنشاء وتحديث وإدارة قروضك.

3.1. يثبت

قبل البدء، راجع دليلنا للاتصال بواجهات برمجة التطبيقات (APIs) الخاصة بنا. لاختبار واجهة برمجة التطبيقات (API) بسرعة،

مكالمات، يمكنك استخدام جURL من سطر الأوامر، أو خدمة مثل Postman أو Swagger في صندوق الحماية الخاص بنا.

لإنشاء تطبيق بطاقة أو دفع، يجب عليك إنشاء عملاء وحسابات.

استكشاف صندوق الرمل

لدينا كل ما يمكنك استكشافه. بيئة اللعب معزولة تمامًا. من بيئة الإنتاج، فلا تتردد في التجربة. عندما تكون مستعدًا للانتقال إلى بيئة الإنتاج، تواصل مع مدير علاقاتك، الذي سيزودك ببيانات اعتماد الإنتاج للوصول إلى بيئة العمل المباشرة.

سجل ذات الصلة web أحداث الخطاف

Webتُعد الخطافات جزءًا مهمًا من أي تكامل مع Cross River. بينما تتيح لك واجهات برمجة التطبيقات طلب البيانات عند الطلب، webتُرسل الخطافات التحديثات الفورية مباشرةً إلى نظامك، مما يُلغي الحاجة إلى الاستطلاعات المستمرة ويُقلل زمن الوصول. في كثير من الحالات، webتعد الخطافات أكثر كفاءة وموثوقية من واجهات برمجة التطبيقات وحدها، مما يضمن بقاء تطبيقك متزامنًا مع الأحداث الهامة مثل تغييرات الحساب وتحديثات المعاملات ونتائج المعالجة.

يسجل لتلقي webأحداث الخطاف. عندما webيتم تشغيل أحداث الخطاف، الحدث يتم إرسال الكائنات إلى المسجل URLs.

3.2. العملاء والحسابات

الخطوة 1
الحصول على بيانات اعتماد API

الخطوة 2
الحصول على رمز الوصول

الخطوة 3
استخدام رمز الوصول

الخطوة 4
بناء Sampلو التطبيق

إنشاء سجل العميل وحساب ممول:

إنشاء سجل العميل

إنشاء حساب إيداع

تمويل حساب

إنشاء سجل العميل

قبل استخدام خدمات Cross River، يتعين عليك إنشاء سجل عميل لكل من

عملائك. تتضمن عملية دمج العملاء إنشاء سجل العميل مع معلومات العملاء ذات الصلة.

يتم فحص جميع العملاء تلقائيًا لأغراض الامتثال التنظيمي، لذا يتعين عليك التسجيل للحصول على الخدمات ذات الصلة webربط الأحداث لتلقي تحديثات حالة سجل العميل.

يمكن أن يكون سجل العميل لأي منهما شخصي or عمل العملاء. بمجرد التسجيل، يمكن ربط العميل بحساب واحد أو أكثر.

Webخطافات

يسجل ل webالخطافات. ما يلي webيتم استخدام الخطافات:

Webوصف الخطاف

العميل الأساسي.تم إدخاله

يخطرك بأنه تم إنشاء سجل العميل

تم تغيير Core.Customer.Ofac

يخطرك بأنه تم تحديث حالة OFAC الخاصة بالعميل

Core.Customer.PepScan.Chan ged

Nيخبرك بأنه تم تحديث حالة PEP الخاصة بالعميل

Exampإنشاء سجل leof

في هذا المثال السابقampسنضيف جون سميث. أولًا، لننشئ سجل عملاء. سنسجل جون كـ شخصي عميل.

لإضافة عميل تجاري، قم أولاً بإنشاء سجل عميل شخصي لـ المالك الأساسي بعد ذلك، أنشئ حساب عميل تجاري وأضف سجله الشخصي كمالك مستفيد.

يتصل نشر /core/v1/cm/العملاء .

في المثال التاليampيمكنك أن ترى أن السمات المطلوبة هي:

مهم

نوصيك بشدة بتضمين مفتاح idempotency في رأس طلبك

لتوفير الحماية المكررة في حالة الفشل.

Curl

curl -X نشر /core/v1/cm/العملاء –header 'نوع المحتوى: application/j {

 معرف الشريك“6e80b097-693c-4592-8440-02f345335bbf”,

 "اسم"{

 "الاسم الأول""جون",

 "اسم العائلة""سميث"

 },

 "تصنيف""شخصي",

 "المؤيدةfile”{

 "ريجو"خطأ شنيع،

 "شخص مكشوف سياسيًا"خطأ شنيع،

 "نوع معرف الضريبة"رقم الضمان الاجتماعي,

 "معرف الضريبة""119988776",

 "تاريخ الميلاد""1953-09-22",

 "تقييم المخاطر""قليل"

 "العنوان الأساسي"{

 "نوع العنوان""بيت",

 "تصنيف""سكني",

 "isPrimary"حقيقي،

 "شارع 1"123 أي شارع,

 "مدينة""في أي مكان",

 "ولاية""نيويورك",

 "رمز بريدي""12345",

 "رمز البلد""نحن"

 },

 "الهاتف الأساسي"{

 "isPrimary"حقيقي،

 "نوع الهاتف""بيت",

 "رقم التليفون""2015551234"

 },

 "البريد الإلكتروني الأساسي"{

 "isPrimary"حقيقي،

 "نوع البريد الإلكتروني""شخصي",

 "عنوان البريد الإلكتروني""جون سميث@xxxxx.com"

 }

}

تُرجع مكالمة API الناجحة استجابة JSON تحتوي على مُعرّف العميل الفريد في السطر الأول من نص الاستجابة. تم إنشاء عميلك.

إعداد هيئة استجابة العملاء

{

 "بطاقة تعريف"“9052b6a5-3f09-41d1-b526-ade80104eb79”,

 "رقم سيف""32653745014",

 "تصنيف""شخصي",

 "الحالة""نشيط",

 "مكتب مراقبة الأصول الأجنبية""قيد الانتظار",

 "بيبسكان""قيد الانتظار",

 "اسم": {

 "الاسم الأول""جون",

 "اسم العائلة""سميث",

 "الاسم الكامل""جون سميث"

 },

 "المؤيدةfile”: {

 "ريجو"خطأ شنيع,

 "شخص مكشوف سياسيًا"خطأ شنيع,

 "تمكين الاحتفاظ بالنسخة الاحتياطية"خطأ شنيع,

 "نوع معرف الضريبة"رقم الضمان الاجتماعي,

 "معرف الضريبة""119988776",

 "تاريخ الميلاد""1953-09-22",

 "تقييم المخاطر""قليل"

 },

 "تم إنشاؤه في"“2021-01-25T17:55:24.4422582-05:00”,

 "آخر تعديل في"“2021-01-25T17:55:24.4432543-05:00”,

 معرف الشريك“6e80b097-693c-4592-8440-02f345335bbf”

}

ال العميل الأساسي.تم إدخاله webيتم تشغيل حدث الخطاف عند إنشاء سجل العميل.

حدث تم فيه إدخال العميل

{

 "بطاقة تعريف"“3d9c5e1a-623b-4cf2-812e-ade80105048e”,

 "اسم الحدث""تم دمج العميل الأساسي",

 "الحالة""قيد الانتظار",

 معرف الشريك“30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 "تم إنشاؤه في"“2021-11-22T10:50:20.553-05:00”,

 "موارد":[

 “core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79”  ],

 "تفاصيل":[]

}

تقوم شركة Cross River بفحص سجل العميل الجديد للتأكد من امتثاله لـ OFAC و PEP.

في بعض الأحيان تتطلب نتائج الفحص إعادةview من قبل فريق مكافحة غسيل الأموال لدينا.

عند اكتمال المسح، تم تغيير Core.Customer.Ofac و

Core.Customer.PepScan.Changed webتعود أحداث الخطاف بحالة. يُظهر العملاء الذين لا يواجهون أي مشاكل في الامتثال واضح حالة.

تم تغيير فحص OFAC للعميل

{

 "بطاقة تعريف"“45db5592-56ee-41f5-85e7-ade8010571ce”,

 "اسم الحدث""تم تغيير Core.Customer.Ofac",

 "الحالة""قيد الانتظار",

 معرف الشريك“30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 "تم إنشاؤه في"“2021-11-22T10:51:53.657-05:00”,

 "موارد":[

 “core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79”  ],

 "تفاصيل":[]

}

تم تغيير فحص PEP للعميل

{

 "بطاقة تعريف"“a5000831-3e01-4231-9ec2-ade8010571c5”,

 "اسم الحدث""Core.Customer.PepScan.Changed",

 "الحالة""قيد الانتظار",

 معرف الشريك“30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 "تم إنشاؤه في"“2021-11-22T10:51:53.597-05:00”,

 "موارد":[

 “core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79”  ],

 "تفاصيل":[]

}

لقد قمت الآن بإنشاء سجل العميل.

تحديث سجل العميل

من الممكن تحديث بيانات العميل، مثل العنوان ورقم الهاتف والبريد الإلكتروني. تُعتبر هذه البيانات أساسي المعلومات. إذا أضفت عنوانًا ثانيًا، فسيكون هذا ثانوي.

استخدم معرف العميل الذي تم إرجاعه عند إنشاء سجل العميل للاتصال نشر /core/v1/cm/customers/{id}/العناوين لإضافة عنوان العميل الأول

العنوان الذي تضيفه هو أساسي العنوان. في المثال التاليampيمكنك الآن رؤية السمات المطلوبة.

تحديث عنوان العميل

POST /core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79/addresse {

 "نوع العنوان""بيت",

 "تصنيف""سكني",

 "isPrimary"حقيقي،

 "شارع 1"123 أي شارع,

 "مدينة""في أي مكان",

 "ولاية""نيويورك",

 "رمز بريدي""12345",

 "رمز البلد""نحن"

}

يتصل نشر /core/v1/cm/customers/{id}/phones لإضافة

هاتف العميل

. رقم الهاتف الأول الذي تضيفه هو أساسي رقم التليفون.

رقم

تحديث رقم هاتف العميل

 POST /core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79/phones {

 "isPrimary"حقيقي،

 "نوع الهاتف""متحرك",

 "رقم التليفون""2015552345"

}

يتصل نشر /core/v1/cm/customers/{id}/email لتحديث البريد الإلكتروني للعميل

تحديث البريد الإلكتروني للعميل

 POST /core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79/email {

 "isPrimary"حقيقي،

 "نوع البريد الإلكتروني""شخصي",

 "عنوان البريد الإلكتروني""john.jones@xxx.com"

}

إنشاء حساب إيداع

يوفر CR عددًا من أنواع الحسابات المختلفة، بما في ذلك الحسابات الشيكاتية وحسابات التوفير، وشهادات الإيداع (CDs أو حسابات الودائع لأجل)، والمزيد.

لفتح أي نوع من حسابات الإيداع، يجب أن يكون لديك معرف منتج صالح لنوع الحساب الذي ترغب في فتحه، ومعرف عميل (معرف سجل العميل المُدرج) لصاحب الحساب. يُرجى العلم أنه يجب أن يكون لدى صاحب الحساب عنوان ورقم هاتف واحد على الأقل في سجل العميل، وأن تكون حالته لدى مكتب مراقبة الأصول الأجنبية (OFAC) واضحبالإضافة إلى ذلك، يجب أن يتطابق تصنيف العميل مع التصنيف المُعدّ للمنتج. على سبيل المثالampنعم، لا يمكن إضافة سوى عملاء الأعمال إلى منتج الأعمال.

قبل أن تبدأ

تأكد من أن لديك:

بيانات اعتماد واجهة برمجة التطبيقات

معرف الشريك (الذي تلقيته عند التسجيل)

معرف العميل

معرف المنتج (يحدد نوع الحساب الذي يتم فتحه)

مهم

نوصي بشدة بتضمين مفتاح idempotency في رأس الطلب لمنع تكرار الدفعات في حالة الفشل.

نقاط النهاية و webخطافات

يتم استخدام نقطة نهاية API التالية:

وصف API

فتح حساب إيداع يفتح حساب إيداع للعميل

التالي webيتم استخدام الخطاف:

Webوصف الخطاف

الحساب الأساسي مفتوح تم فتح حساب جديد

افتح حسابًا

في السيناريو التالي، ستفتح حسابًا لجون سميث، وهو أحد العملاء الذين قمت بإضافتهم بنجاح.

لفتح حساب

يتصل POST core/v1/dda/accounts لهذه المكالمة، بعض السمات مطلوبة. انظر الملف الكامل.

قائمة السمات

Sampطلب لو

نشر /core/v1/dda/الحسابات

{

 "معرف العميل"“59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 "معرف المنتج"“44015e68-1afb-40fc-9497-abc1014f52da”,

 "عنوان""جون سميث",

 "عنوان البيان"{

 "شارع 1""257 دالتون غروفز",

 "مدينة""مدينة بارتون",

 "ولاية""مي",

 "رمز بريدي""48705",

 "رمز البلد""نحن"

 }

}

تعيد مكالمة API الناجحة استجابة JSON تحتوي على تفاصيل الحساب الجديد.

Sampلو الرد

بريد /جوهر/v1/ددا/الحسابات

{

 "معرف العميل"“59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 "معرف المنتج"“44015e68-1afb-40fc-9497-abc1014f52da”,

 "عنوان""جون سميث",

 "عنوان البيان": {

 "شارع 1""257 دالتون غروفز",

 "مدينة""مدينة بارتون",

 "ولاية""مي",

 "رمز بريدي""48705",

 "رمز البلد""نحن"

 }

}

ال رقم الحساب يوفر الحقل رقم الحساب للحساب الجديد.

في الرد السابقample، يتم تصنيف الحساب على أنه شخصي لأن المستخدم قام بتكوين تصنيف المنتج على أنه شخصيتصنيف الحساب يتطابق دائمًا مع تصنيف المنتج الذي تم تكوينه.

يتم تحديث حالة الحساب تلقائيًا إلى نشيط ، وهو متاح للاستخدام فورًا. هذا يؤدي إلى تفعيل الحساب الأساسي مفتوح حدث.

تفاصيل حدث Core.Account.Opened

{

 "بطاقة تعريف"“259cdbca-6a89-4af8-a50e-ada3010fb13f”,

 "اسم الحدث""تم فتح الحساب الأساسي",

 "الحالة""قيد الانتظار",

 معرف الشريك“e6c3824a-377f-44d5-a2f6-a9a600c9b37e”,

 "تم إنشاؤه في"“2021-01-26T09:48:10.1011462-05:00”,

 "موارد":[

 "core/v1/dda/accounts/2235223803"

 ],

 "تفاصيل":[]

}

حساب فاندانا

عند العمل في بيئة الاختبار لاختبار مسارات الدفع وسلوك الحساب، يجب أن يكون لديك أموال في الحساب.

يمكنك استخدام أي سكة حديدية مزودة بنقطة نهاية محاكاة واردة لتمويل حساب تجريبي، إذا كان الحساب مُهيأً لذلك. على وجه الخصوص، يمكنك:

محاكاة مدفوعات ACH الواردة

محاكاة سلك داخلي

لأي محاكاة، ستحتاج إلى رقم حساب كروس ريفر التجريبي الذي ترغب في تمويله. معلومات المُنشئ غير مهمة، وفي بعض الحالات قد تكون وهمية تمامًا.

الخطوات التالية

تحقق من الدفع لدينا.

دروس تعليمية

3.3. بطاقات

الخطوة 1
الحصول على بيانات اعتماد API

الخطوة 2
الحصول على رمز الوصول

الخطوة 3
استخدام رمز الوصول

الخطوة 4
بناء Sampلو التطبيق

تعرّف على كيفية العمل مع واجهات برمجة تطبيقات كروس ريفر. توضح لك هذه الصفحة كيفية:

إنشاء بطاقة

تفعيل البطاقة

إنشاء بطاقة

أدر بطاقات عملائك بالتعاون مع كروس ريفر لتحديد ما ترغب في تقديمه، سواءً بطاقات مادية أو افتراضية. هذا هو تكوين البطاقة. يقوم Cross River بإنشاء برنامج تكوين البطاقةfile لك ولكل نوع تختاره لأداتك المالية عملاء.

قبل أن تبدأ

تأكد من أنك قمت بما يلي:

إنشاء سجل العميل

إنشاء حساب إيداع

رقم حساب حامل البطاقة

معرف العميل (يمكنك الحصول عليه عند إنشاء عميل)

معرف التكوين (يوفر لك Cross River معرفًا عند تكوين النوع/البطاقة الخاصة بك)

ونوصيك أيضًا بالمعلومات ذات الصلة webأحداث الخطاف. التسجيل

نقاط النهايةwebخطافات

يسجل ل webيتم استخدام نقاط نهاية واجهة برمجة التطبيقات التالية:

وصف API

إنشاء بطاقة جديدة يطلب إنشاء بطاقة خصم جديدة

التالي webيتم استخدام الخطافات:

Webوصف الخطاف

بطاقات.بطاقة.تم إنشاؤها تم إنشاء بطاقة الخصم

طلب بطاقة

ستتعلم كيفية طلب/إنشاء بطاقة خصم جديدة عن طريق إنشاء بطاقة لجون سميث.

يتصل نشر /cardmanagement/v1/cards .

في المثال التاليampيمكنك معرفة السمات المطلوبة. اطلع على تفاصيل واجهة برمجة التطبيقات الكاملة.

إضافة بطاقة

Sampإنشاء بطاقة

curl -X نشر /cardmanagement/v1/cards –header 'نوع المحتوى: التطبيق "رقم الحساب": "2608927303"، \  

 “customerId”: “2b15a695-13dc-4b10-b4e5-af5b0138873c”, \  

 معرف التكوين: "a6b5a94c-f8f9-462b-8ce8-afa400f5b640"، \ "الاسم الأول": "جون"، \  

 "الاسم الأخير": "سميث"، \  

 "هاتف": { \  

 "phoneType": "الصفحة الرئيسية"، \  

 رقم الهاتف: "9133413131" \  

 }, \  

 "عنوان البريد الإلكتروني": "John.Smith@xxxxx.com"، \  

 "عنوان الشحن": { \  

 "street1": "Lane Ave"، \  

 "street2": "سلسلة"، \  

 "المدينة": "المدينة الكبيرة"، \  

 "الولاية": "IL"، \  

 الرمز البريدي: 72410  

 "رمز البلد": "الولايات المتحدة" \  

 }, \  

 "عنوان الفاتورة": { \  

 "street1": "Lane Ave"، \  

 "street2": "سلسلة"، \  

 "المدينة": "المدينة الكبيرة"، \  

 "الولاية": "IL"، \  

 الرمز البريدي: 72410  

 "رمز البلد": "الولايات المتحدة" \  

 }, \  

 "nameOnCard": "جون سميث"، \  

 "نوع الشحن": "عادي"، \  

 "معرف العميل": "سلسلة" \  

 }' 'https://sandbox.crbcos.com/CardManagement/v1/cards'

تُرجع مكالمة API الناجحة استجابة JSON بتفاصيل البطاقة الجديدة. ستظل حالة البطاقة غير مُفعّلة حتى تُفعّلها. المُعرّف هو مُعرّف البطاقة، في هذه الحالة. example 8709163d-140c-4d95-a111-afa8009e9cd1، والتي سوف تحتاج إليها فعل البطاقة.

Sampطلب بطاقة رد

{

 "بطاقة تعريف"“8709163d-140c-4d95-a111-afa8009e9cd1”,  معرف الشريك“cd9c12f4-7691-424a-b38b-af5b0134c611”,  "معرف المنتج"“83bed086-8182-4151-a1e3-af5b01362783”,  "رقم الحساب""2608927303",

 "الحالة""غير نشط",

 "رمز سبب الحالة""غير مضبوط",

 "الاسم الأول""جون",

 "اسم العائلة""سميث",

 "عنوان الشحن": {

 "شارع 1""شارع لين",

 "شارع 2""خيط",

 "مدينة""المدينة الكبيرة",

 "ولاية""ايل",

 "رمز بريدي""72410",

 "رمز البلد""نحن"

 },

 "عنوان الفاتورة": {

 "شارع 1""شارع لين",

 "شارع 2""خيط",

 "مدينة""المدينة الكبيرة",

 "ولاية""ايل",

 "رمز بريدي""72410",

 "رمز البلد""نحن"

 },

 "هاتف": {

 "نوع الهاتف""بيت",

 "رقم التليفون""9133413131"

 },

 "عنوان البريد الإلكتروني""john@anygoogle.com",

 "الاسم على البطاقة""جون سميث",

 "isPinSet"خطأ شنيع,

 تم حظر المسؤولخطأ شنيع,

 "المشتبه به في الاحتيال"خطأ شنيع,

 معرف التكوين“a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  "فئة""ائتمان",

 "أداة الدفع""VirtualPan",

 "المعالج""اسم المعالج",

 "نوع الشحن""طبيعي",

 "حالة الطلب""الطلب معلق",

 "حالة الاستبدال""غير قابل للتطبيق",

 "معرف العميل"“2b15a695-13dc-4b10-b4e5-af5b0138873c”,  "معرف العميل""خيط",

 "تم إنشاؤه في"“2023-02-13T04:37:29.4869172-05:00”,

 "آخر تعديل في"“2023-02-13T04:37:29.4869172-05:00”

}

ال بطاقات.تم إنشاء البطاقة webيتم تشغيل حدث الخطاف عند إنشاء البطاقة في المعالج.

Sampحدث تم إنشاؤه بواسطة البطاقات

{

 "بطاقة تعريف"“cea6c5b5-13e7-4c2f-ba75-afce01110fe5”,

 "اسم الحدث""تم إنشاء البطاقات",

 "الحالة""قيد الانتظار",

 معرف الشريك“cd9c12f4-7691-424a-b38b-af5b0134c611”,

 "تم إنشاؤه في"“2023-02-13T04:42:29.4869172-05:00”,

 "موارد":[

 “cardmanagement/v1/cards/8709163d-140c-4d95-a111-afa8009e9cd1”  ],

 "تفاصيل":[

 {

 "معرف البطاقة"“8709163d-140c-4d95-a111-afa8009e9cd1”,

 "الحالة""غير نشط",

 "رمز سبب الحالة""غير مضبوط"

 }

 ]

}

تفعيل البطاقة

قبل أن تبدأ

تأكد من أن لديك:

بيانات اعتماد واجهة برمجة التطبيقات

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

نقاط النهايةwebخطافات

وصف API

POST /cardmanagement/v1/cards/{id}/activate يقوم بتنشيط البطاقة باستخدام معرف البطاقة يستخدم البرنامج التعليمي هذه webالخطافات:

Webوصف الخطاف

بطاقات.بطاقة.مفعلة تم تفعيل بطاقة الخصم

تفعيل البطاقة

قم بتفعيل البطاقة التي قمت بإنشائها فيtage.

إنشاء بطاقة

يتصل نشر /cardmanagement/v1/cards/{id}/تفعيل . ال id يجب ضبط السمة على معرف البطاقة. فيample أدناه المعرف هو 8709163d-140c-4d95-a111 afa8009e9cd1.

Sampطلب تفعيل البطاقة

curl -X بريد  

–header 'قبول: application/json'

–header 'التفويض: الحامل'<الرمز المميز>'

https://sandbox.crbcos.com/CardManagement/v1/cards/8709163d-140c-4d95-a1

تُرجع مكالمة API الناجحة استجابة JSON تحتوي على تفاصيل البطاقة. البطاقة حالة هو الان تم تفعيله. ال حالة الطلب is مكتمل.

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

{

 "بطاقة تعريف"“8709163d-140c-4d95-a111-afa8009e9cd1”,  معرف الشريك“cd9c12f4-7691-424a-b38b-af5b0134c611”,  "معرف المنتج"“83bed086-8182-4151-a1e3-af5b01362783”,  "معرف بطاقة المعالج""804951250206718",

 "رقم الحساب""2608927303",

 "الحالة""نشيط",

 "رمز سبب الحالة""غير مضبوط",

 "الاسم الأول""جون",

 "اسم العائلة""سميث",

 "عنوان الشحن": {

 "شارع 1""شارع لين",

 "شارع 2""خيط",

 "مدينة""المدينة الكبيرة",

 "ولاية""ايل",

 "رمز بريدي""72410",

 "رمز البلد""نحن"

 },

 "عنوان الفاتورة": {

 "شارع 1""شارع لين",

 "شارع 2""خيط",

 "مدينة""المدينة الكبيرة",

 "ولاية""ايل",

 "رمز بريدي""72410",

 "رمز البلد""نحن"

 },

 "هاتف": {

 "نوع الهاتف""بيت",

 "رقم التليفون""9133413131"

 },

 "عنوان البريد الإلكتروني""john@anygoogle.com",

 "الاسم على البطاقة""جون سميث",

 "بان لاست فور""3629",

 "isPinSet"خطأ شنيع,

 "تاريخ انتهاء الصلاحية""2026-02-13",

 تم حظر المسؤولخطأ شنيع,

 "المشتبه به في الاحتيال"خطأ شنيع,

 معرف التكوين“a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  "فئة""ائتمان",

 "أداة الدفع""VirtualPan",

 "المعالج""اسم المعالج",

 "نوع الشحن""طبيعي",

 "حالة الطلب""مكتمل",

 "حالة الاستبدال""غير قابل للتطبيق",

 "معرف العميل"“2b15a695-13dc-4b10-b4e5-af5b0138873c”,

 "معرف العميل""خيط",

 "معرف العميل للمعالج"“T83E9D675A3N3N9O8RZ1”,

 "تم إنشاؤه في"“2023-02-13T04:37:29.487-05:00”,

 "التنشيط الأولي"“2023-02-13T00:00:00-05:00”,

 "تم التنشيط في"“2023-02-13T04:43:19.282287-05:00”,

 "آخر تعديل في"“2023-02-13T04:43:19.2962845-05:00”

}

عندما تتغير حالة البطاقة إلى نشيط ، ال بطاقات.بطاقة.مفعلة webحرائق حدث الخطاف.

بطاقات.بطاقة.مفعلة webحدث الخطاف

{

 "بطاقة تعريف"“95ac33ca-3d7f-49aa-bfc2-afce01113310”,

 "اسم الحدث""تم تفعيل البطاقات",

 "الحالة""قيد الانتظار",

 معرف الشريك“cd9c12f4-7691-424a-b38b-af5b0134c611”,

 "تم إنشاؤه في"“2023-02-13T04:44:31.282287-05:00”,

 "موارد":[

 “cardmanagement/v1/cards/8709163d-140c-4d95-a111-afa8009e9cd1”  ],

 "تفاصيل":[

 {

 "معرف البطاقة"“8709163d-140c-4d95-a111-afa8009e9cd1”,

 "الحالة""نشيط",

 "رمز سبب الحالة""غير مضبوط"

3.4. الإقراض

الخطوة 1
الحصول على بيانات اعتماد API

الخطوة 2
الحصول على رمز الوصول

الخطوة 3
استخدام رمز الوصول

الخطوة 4
بناء Sampلو التطبيق

يتضمن الإقراض مجموعة من المكالمات التي تسمح لك بإنشاء واجهة برمجة تطبيقات الإقراض وتحديثها وإدارتها قروضك.

للبدء في العمل بالإقراض، تأكد من:

احصل على بيانات اعتماد API مع النطاقات المطلوبة للإقراض

إذا قمت بإنشاء بيانات اعتماد واجهة برمجة التطبيقات، باستخدام إدارة الخدمة الذاتية

، فيجب عليك أيضًا إرسال طلب إلى

arix.support@crossriver.com

المنظمة، إلى جانب معرف العميل وMPLID الخاص بك، لإكمال الخلق.

استخدم النطاق الصحيح لواجهات برمجة التطبيقات التي تريد استخدامها.

نطاق واجهة برمجة التطبيقات لصندوق الحماية هو: CosLending:PreApproval:stg

صندوق الرمل

قاعدة الوحدة URL لوصف مكالمات API

يُقرض النشأة

اتخاذ القرار بشأن التطبيق

https://arixapisandbox.crbnj. net

القاعدة URL لمكالمات واجهة برمجة التطبيقات لإنشاء القروض إلى بيئة Arix sandbox

https://lendingsandbox.crbco s.com/preapproval/v1

القاعدة URL لصندوق الرمل

اتخاذ القرار بشأن التطبيق

اختيال

رابط وحدة Swagger

مرجع واجهة برمجة التطبيقات

التوثيق

https://arixapisandbox.crbnj.net/swagger-ui

خطافات

https://lendingsandbox.crbcos.com/hooks/swagger/inde x.html

بيع https://lendingsandbox.crbcos.com/selling/swagger/inde x.html

صفحة الحالة

لرؤية قائمة بالإصدارات القادمة، ومراقبة حالة واجهة برمجة التطبيقات الحالية، view تقارير الحوادث، أو الحصول على إشعارات بشأن الصيانة المجدولة، قم بزيارة صفحة الحالة واشترك في التنبيهات

4. إعداد البرنامج

إعداد SFTP: استخدم SFTP لإرسال fileأو تنزيلها من Cross River، وفقًا لاحتياجاتك واحتياجاتنا.

دمج العملاء: إدارة معلومات عملائك في كروس ريفر نظام التشغيل (COS) باستخدام واجهات برمجة التطبيقات أو مستكشف COS

أنواع منتجات COS ومعرفاتها: شرح أنواع منتجات COS ومعرفاتها.

مستكشف COS: كيفية العمل مع COS Explorer الخاص بنا.

بوابة إدارة المنظمة: كيفية العمل مع بوابة إدارة المنظمة الخاصة بنا.

4.1. إعداد SFTP

عندما تحتاج إلى تبادل معلومات حساسة في file التنسيق مع Cross River، نطلب منك استخدام Secure File بروتوكول النقل (SFTP). استخدم SFTP لإرسال fileأو لتنزيلها من كروس ريفر، وفقًا لاحتياجاتك واحتياجاتنا. في بعض الحالات، سنقوم أنت أو نحن بتشفير هذه الملفات. fileوخاصةً إذا كانت تحتوي على أي معلومات تعريف شخصية (PII).

استخدام SFTP

يتيح لك SFTP إرسال واستقبال البيانات الحساسة بشكل آمن fileالملفات والتقارير باستخدام مجلد مخصص لشركتك على خادم آمن. التحميل والتنزيل fileمن خلال هذا المجلد أو المجلدات الفرعية لهذا المجلد، وفقًا لاحتياجاتك المحددة.

استخدام التشفير

تشفير fileيضيف s طبقة حماية إضافية. لن يتمكن من فك تشفير البيانات المشفرة إلا الأشخاص المخولون الذين لديهم المفتاح الصحيح. fileفي Cross River نستخدم تشفير PGP.

البدء

هناك عدة خطوات لتمكينك من تشغيل خادم SFTP الخاص بنا.

أكمل نموذج طلب الوصول إلى IP لخدمات Cross River SFTP (من RM الخاص بك).

إذا كنت بحاجة إلى المشاركة fileمع Cross River، سيرسل إليك مدير علاقاتك نموذج طلب وصول IP لخدمات CRB SFTP. من بين معلومات أخرى، ستحتاج إلى تقديم عناوين IP العامة الثابتة التي ستستخدمها للوصول إلى مجلد SFTP، ومفتاح PGP عام للتشفير وفك التشفير. fileس. أرسل النموذج المكتمل إلى مدير العلاقات الخاص بك

مهم

سيسمح لك كروس ريفر بخمسة عناوين IP فقط، لذا خذ ذلك في الاعتبار. يجب أن تكون عناوين IP ثابتة. لذلك، عليك استخدام أي عنوان غير ثابت لديك كوكيل.

لقد قمنا بإعداد بنية مجلد SFTP الخاص بك.

بمجرد حصول كروس ريفر على بياناتك، يُنشئ قسم هندسة تكنولوجيا المعلومات لدينا مجموعة قياسية من المجلدات والمجلدات الفرعية لك. هذا المسار الفريد مخصص لشركتك فقط، ولا يمكن لأي شريك آخر الوصول إليه. سيرسل لك قسم هندسة تكنولوجيا المعلومات بريدًا إلكترونيًا بالمعلومات اللازمة للوصول إلى المجلدات. يتضمن البريد الإلكتروني رابطًا لبيانات اعتمادك. لا تحفظ كروس ريفر كلمة مرورك!

مهم

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

تصبح بيانات الاعتماد غير صالحة أيضًا إذا قام أكثر من شخصين بالوصول إلى الرابط.

اختبار تحميل SFTP.

إذا كنت سوف تقوم بالتزويد fileبالنسبة إلى Cross River، يجب على قسم تكنولوجيا المعلومات الخاص بك إنشاء حساب خدمة بعملية آلية لتحميل تلك البيانات fileإلى مجلدات SFTP الخاصة بك. نوصي بشدة بتجربة هذا قبل محاولة إرسال بيانات حقيقية. تواصل مع مدير علاقاتك لأي استفسارات أو مشاكل، أو افتح تذكرة مع فريق الدعم المباشر.

إعداد PGP للإرسال أو الاستقبال fileمن كروس ريفر. (هذه الخطوة ضرورية فقط إذا كنت ترسل أو تستقبل معلومات تعريف شخصية. يُرجى مراجعة مدير علاقات العملاء الخاص بك.)

إذا كنت بحاجة إلى إرسال نهر كروس fileس، سوف نرسل إليك أولاً مفتاح PGP العام الخاص بنا لاستخدامه في تشفير تلك files.

يجب أن تكون قد أرسلت بالفعل مفتاحك العام PGP إلى Cross River لتلقيه fileمنا.

شارك بياناتك.

بمجرد إعداد مجلد SFTP الخاص بك ووضع عمليتك في مكانها، يمكنك البدء في المشاركة fileتواصل معنا. سيخبرك مدير علاقاتك إذا كان هناك أي إجراء أكثر تحديدًا تحتاج إلى القيام به لتلقي التقارير، أو كيفية إعداد البيانات لإرسالها إلينا.

تقارير محددة

تعرف على المزيد حول إعداد التقارير وإرسالها fileل:

الحسابات والمدفوعات

مدفوعات البطاقات

مخاطر الائتمان

الإقراض

دفعات XML المدفوعة (ISO 20022)

4.2. دمج العملاء

أدر معلومات عملائك في نظام تشغيل كروس ريفر (COS) باستخدام واجهات برمجة التطبيقات (APIs) أو . تتضمن هذه المعلومات التفاصيل الأساسية اللازمة لفتح حساب بنكي في نظام تشغيل كروس ريفر (COS Explorer).

حساب أو استخدام بطاقة ائتمان، بالإضافة إلى بيانات أكثر تفصيلاً عن العميل، حسب الحاجة. نُطلق على هذا سجل العميل.

قبل أن تتمكن من فتح حساب إيداع أو إنشاء بطاقة، يجب عليك إنشاء سجل العميل، والذي يُطلق عليه أحيانًا التوجيهيمكنك بعد ذلك تعيين عميل واحد أو أكثر لحساب من خلال خدمة العملاء العلاقات.

تتضمن عملية دمج العملاء إنشاء سجل عميل ذي صلة معلومات العميل. اتبع هذا البرنامج التعليمي لإنشاء سجل عميل لكل منكم..

خطوات اختيارية

إضافة تفاصيل الهوية

إضافة مالك مفيد

رموز الخطأ

انظر، إلى جانب الكثير من المعلومات المرجعية الأخرى، حول رموز خطأ نظام COS COS

صفحة أكواد المرجع.

4.2.1. سجل العميل

سجل العميل

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

السابقampيوضح الشكل أدناه كيفية دمج العميل مع عميل شخصي.

طلب شخص على متن الطائرة

نشر /core/v1/cm/العملاء {

 معرف الشريك“7cc038be-fde9-4455-b27b-1497cf667362”,

 "اسم"{

 "بادئة""السيد.",

 "الاسم الأول""جون",

 "الاسم الأوسط""روبرت",

 "اسم العائلة""سميث",

 "اللاحقة""جونيور",

 "الاسم المفضل""جيم" },

 "تصنيف""شخصي",

 "المؤيدةfile”{

 "ريجو"خطأ شنيع،

 "رمز البلد والجنسية""نحن",

 "شخص مكشوف سياسيًا"خطأ شنيع،

 "تمكين الاحتفاظ بالنسخة الاحتياطية"خطأ شنيع،

 "النسبة المئوية للخصم الاحتياطي"0,

 "نوع معرف الضريبة"رقم الضمان الاجتماعي,

 "معرف الضريبة""123456789",

 "تاريخ الميلاد""1965-09-15",

 "تقييم المخاطر""قليل",

 "اختيار الخروج من الخصوصية"حقيقي }

} قم بإدخال عميل تجاري مثل شركة أو شركة ذات مسؤولية محدودة باستخدام نفس نقطة النهاية مع سمات مختلفة قليلاً.

Curl

نشر /core/v1/cm/العملاء {

 معرف الشريك“a24cba49-2bb6-431d-a867-1de81d6e4127”,

 "اسم"{

 "اسم الكيان"شركة أكمي, },

 "تصنيف""عمل",

 "المؤيدةfile”{

 "رمز البلد والجنسية""نحن",  

 "تمكين الاحتفاظ بالنسخة الاحتياطية"خطأ شنيع،

 "النسبة المئوية للخصم الاحتياطي"0,  

 "نوع معرف الضريبة""عين",

 "معرف الضريبة""123456789",

 "تاريخ التشكيل""2019-09-10",

 "نوع الكيان""مؤسَّسة",

 "تقييم المخاطر""قليل",

 "نوع الملكية""الكيان القانوني",

 "معرف العميل الرئيسي"“f9321f7f-3712-46e1-b965-2b79ead64dc9”، } }

بغض النظر عما إذا كنت تقوم بإدراج عميل شخصي أو عميل تجاري، معرف العميل للمالك الأساسي يجب أن تحتوي السمة على مُعرّف عميل يُشير إلى سجل عميل من نوع "شخصي". لذلك، لإنشاء شركة، يجب عليك أولًا إنشاء سجل عميل شخصي للمالك الرئيسي لتلك الشركة.

مهم

تتضمن بعض نقاط نهاية العملاء العناية الواجبة مورد قد يكون ضروريًا أو غير ضروري عند دمج العملاء الشخصيين. يُبلغك مسؤول الامتثال المُعيّن لك بمتطلبات أيٍّ من مجالات العناية الواجبة أثناء عملية دمج العملاء.

المالكين المستفيدين

المالك المستفيد هو الشخص الذي يمتلك ٢٥٪ أو أكثر من شركة. لأسباب تنظيمية، يجب عليك توفير الموارد اللازمة عمل سجل العميل ينشئ مالكًا مفيدًا

لكل مالك منتفع من تلك الشركة. معرف العميل المالك تشير السمة إلى سجل العميل الشخصي لكل مالك مستفيد. عادةً ما تُضاف موارد المالك المستفيد إلى سجل عميل الشركة فورًا بعد تسجيل الشركة.

Curl

نشر /core/v1/cm/customers/{customerId}/المالكين المستفيدين {

 "معرف العميل المالك"“c1210a2d-932e-43ca-be29-f358a4382385”,

 "لقب المالك""رئيس" }

عنوان

يمكن أن تكون العناوين الفعلية المرتبطة بالعميل .

تم التحديث

Curl

نشر /core/v1/cm/customers/{customerId}/العناوين

{

 "isPrimary"حقيقي،

 "الحالة""نشيط",

 "تصنيف""سكني",

 "نوع العنوان""بيت",

 "شارع 1"123 شارع مابل,

 "شارع 2""الشقة 12",

 "شارع 3""",

 "مدينة""نيويورك",

 "ولاية""نيويورك",

 "رمز بريدي""10025",

 "رمز البلد""نحن",

}

عناوين البريد الإلكتروني

تحديث البريد الإلكتروني

معلومات الاتصال بالعميل.

Curl

نشر /core/v1/cm/customers/{customerId}/البريد الإلكتروني {

 "isPrimary"حقيقي،

 "نوع البريد الإلكتروني""شخصي",

 "عنوان البريد الإلكتروني""john.smith@crossriver.com" }

الهواتف

تحديث الهاتف Curl

معلومات الاتصال بالعميل.

نشر /core/v1/cm/customers/{customerId}/phones

{

 "نوع الهاتف""بيت",

 "isPrimary"حقيقي،

 "رقم التليفون""2015551234"

}

التعريفات

تُستخدم الهويات لتتبع البيانات الوصفية لمستندات تعريف العميل، مثل رخص القيادة وجوازات السفر. ويمكن استخدامها لإضافة تفاصيل هوية جديدة. إضافة تفاصيل الهوية.

Curl

نشر /core/v1/cm/customers/{customerId}/identifications {

 "isPrimary"حقيقي،

 "رقم الهوية"“DL123456789”,

 "النوع""رخصة السائق",

 "تاريخ الإصدار""2018-08-30",

 "تاريخ الانتهاء""2018-08-30",

 "تاريخ التحقق""2018-08-30",

 "سلطة الإصدار""إدارة المركبات في نيوجيرسي",

 "الولاية أو المقاطعة المصدرة""نيوجيرسي",

 "رمز البلد المصدر""نحن",

}

4.2.2. أنواع منتجات COS ومعرفاتها

في كروس ريفر، نوع المنتج هو منتج مالي فريد من نوعه تقدمه لعملائك. على سبيل المثالampيمكنك اختيار نوع المنتج المناسب، سواءً كان بطاقة خصم أو حساب توفير، وفقًا لاحتياجاتك ومواصفاتك. يمكنك فتح حسابات لعملائك تحت أي نوع منتج تُحدده وتُهيئه معنا. تواصل مع مدير علاقاتك لمزيد من التفاصيل، بما في ذلك كيفية إعداد أنواع المنتجات لعملائك.

على سبيل المثالampقد ترغب في تكوين نوع المنتج ليكون حساب توفير يستخدم التحويلات البنكية والمدفوعات الآلية. يمكنك بعد ذلك تقديم حسابات توفير لعملائك مع هذه الخدمات والتكوينات.

يوفر لك كروس ريفر معرف منتج لكل نوع من المنتجات التي ترغب في تقديمها لعملائك. لفتح أي نوع من حسابات الإيداع، يجب أن يكون لديك معرف منتج صالح ومعرف عميل (معرف سجل العميل المُدرج) لصاحب الحساب. يُرجى العلم أنه يجب أن يكون لدى صاحب الحساب عنوان ورقم هاتف واحد على الأقل في سجل العميل، وأن تكون حالته لدى مكتب مراقبة الأصول الأجنبية (OFAC) واضحبالإضافة إلى ذلك، يجب أن يتطابق تصنيف العميل مع التصنيف المُعدّ للمنتج. على سبيل المثالampنعم، لا يمكن إضافة سوى عملاء الأعمال إلى منتج الأعمال.

4.2.3. مستكشف COS

بمجرد دخولك إلى نظام Cross River وتلقيك رسالة بريد إلكتروني تحتوي على معلومات التسجيل

لك معرف العميل و سر أنت جاهز لتسجيل الدخول إلى COS Explorer. الوصول إلى بوابة COSExplorer

إنتاج:

https://api.crbcos.com/explorer2/

صندوق الرمل:

https://sandbox.crbcos.com/explorer2/

مرحباً بالبريد الإلكتروني

سوف تتلقى رسالة ترحيب بالبريد الإلكتروني من CrossRiver_DO_NOT_REPLY@crossriver.comإذا لم تتمكن من رؤية الرسالة في صندوق الوارد لديك، فتحقق من مجلد البريد العشوائي أو مجلد البريد المحظور.

انقر قم بإنشاء حساب كروس ريفر الخاص بك.

إذا غادرت المعالج في أي وقت، فانقر فوق الرابط الموجود في البريد الإلكتروني الأصلي للعودة إلى المكان الذي توقفت عنده.

الشروط والأحكام

اقرأ الشروط والأحكام، وتحقق يقبل، وانقر التالي.

التحقق من الرسائل النصية القصيرة

سنرسل إليك رسالة نصية قصيرة (SMS) إلى جهازك للتحقق من هويتك. أدخل الرمز المكون من 6 أرقام الذي تلقيته في شاشة تسجيل الدخول، ثم انقر على رمز التحقق.

إنشاء كلمة المرور الخاصة بك

1. أدخل كلمة مرور تتوافق مع المتطلبات التي تظهر على الشاشة وأعد إدخال كلمة المرور. 

2. انقر إنشاء كلمة المرور.

إعداد تطبيق المصادقة

يجب عليك إكمال هذه الخطوة لمواصلة عملية التسجيل والتمكن من تسجيل الدخول في المستقبل

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

إذا لم يكن لديك تطبيق مصادقة على جهازك بالفعل، فيجب عليك تنزيله قبل المتابعة.

بالنسبة لنظامي التشغيل Android وiOS، نوصي باستخدام تطبيق المصادقة التالي:

أداة مصادقة جوجل

مايكروسوفت أوثنيكيتور

بمجرد تثبيت تطبيق المصادقة الخاص بك، ستحتاج إلى إما مسح رمز الاستجابة السريعة or أدخل المفتاح يدويًا في تطبيق المصادقة.

رمز الاستجابة السريعة

1. قم بمسح رمز الاستجابة السريعة QR في تطبيق المصادقة الخاص بك، وإذا لزم الأمر، أدخل الرمز المكون من 6 أرقام في صفحة المصادقة متعددة العوامل.

2. انقر فوق متابعة.

يدوي

1. انقر إظهار المفتاح

2. انسخ المفتاح كما هو سر في تطبيق المصادقة الخاص بك.

3. أدخل الرمز المكون من 6 أرقام.

4. انقر يكمل.

رمز MFA غير صالح

إذا أدخلت رمز MFA غير صالح، ستظهر رسالة حمراء لإعلامك بمحاولة مرة أخرى.

عفواً! لقد أدخلت رمز MFA غير صحيح. إليك بعض الأمور التي يجب عليك التحقق منها:

1. هل انتهت مهلة الكود قبل النقر فوق يكمليتم الإشارة إلى الوقت المتبقي بواسطة دائرة العد التنازلي الموجودة على يمين اسم الحساب ورمز MFA.

2. إذا قمت بإعداد تطبيق المصادقة لعدة بيئات أو تطبيقات، فتأكد من إدخال الرمز الصحيح.

1. إذا لم يكن واضحًا من أسماء اتصال MFA الخيار الصحيح، فقد تحتاج إلى تجربة رموز مختلفة حتى تجد الرمز الذي يعمل.

2. بمجرد العثور على الاتصال الصحيح، يمكنك إعادة تسمية اتصال MFA في التطبيق. سينقلك رمز القلم الرصاص أعلى شاشة تطبيق MFA إلى وضع التحرير. في بعض التطبيقات، ستحتاج أولاً إلى تحديد (أو الضغط باستمرار) الاتصال المراد تحريره، ثم ستظهر الأيقونة.

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

4. احفظ أي تغييرات، وفي المرة القادمة سيكون من الأسهل فهم الكود الذي يجب استخدامه.

رموز الاسترداد

استخدم رموز الاسترداد للمصادقة في حالة فقدان جهازك.

1. قم بتنزيل أو نسخ رموز الاسترداد الخاصة بك واحتفظ بها في مكان آمن يمكنك تذكره.

2. تأكد من أنك قمت بتخزين رموز الاسترداد الخاصة بك

3. انقر إنشاء حساب.

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

يمكنك تنزيل رموز الاسترداد مرة واحدة فقط.

حسابك نشط الآن ويمكنك استخدامه لتسجيل الدخول إلى أي من تطبيقات CR الخاصة بك.

قائمة السماح بعناوين IP

يمكنك استخدام عنوان IP ثابت فقط للوصول إلى COS Explorer. تواصل مع فريق دعم عناوين IP إذا كنت بحاجة إلى مساعدة في هذا الشأن.

عناوين IP لخادم الهوية هي:

172.67.26.222 104.22.40.134 104.22.41.134

يتم توكيل الخادم عبر Cloudflare.

يمكنك السماح بأسماء النطاق المؤهلة بالكامل التالية:

idptest.crbcos.com

استكشاف الأخطاء وإصلاحها

هل نسيت كلمة السر

1. انقر هل نسيت كلمة السر؟ وأدخل بريدك الإلكتروني.

2. أدخل رمز المصادقة المكون من 6 أرقام من تطبيق المصادقة الخاص بك. 3. لقد حصلت على هل نسيت كلمة السر البريد الإلكتروني. انقر فوق إعادة تعيين كلمة المرور.

4. في صفحة إعادة تعيين كلمة المرور، أدخل كلمة مرور جديدة، ثم انقر فوق إعادة تعيين كلمة المرور، و متابعة إلى التطبيق.

إعادة تعيين المصادقة متعددة العوامل

إذا كان لديك بالفعل MFA مُهيأً:

1. في Identity Server، انتقل إلى إعادة تعيين MFA وانقر إعادة تعيين جهاز MFA الخاص بك2. سيتم فتح صفحة المصادقة متعددة العوامل ويمكنك إعادة تعيين المصادقة متعددة العوامل.

يمكنك أيضًا إنشاء رموز استرداد مصادقة متعددة العوامل جديدة.

1. انقر إنشاء رموز استرداد جديدة للمصادقة متعددة العوامل.

2. سيتم فتح صفحة رموز الاسترداد ويمكنك نسخ أو تنزيل رموز الاسترداد العشرة الجديدة.

إذا لم تقم بتكوين مصادقة العوامل المتعددة بعد، فيمكنك تمكين المصادقة متعددة العوامل من إعدادات الحساب.

1. انقر إعادة تعيين طريقة MFA.

2. انقر تكوين MFA.

3. اتبع التعليمات الموجودة في المصادقة متعددة العوامل/المصادقة المكونة من خطوتين.

إذا كان MFA الحالي لديك هو SMS، فيمكنك تفعيل MFA باستخدام تطبيق المصادقة. إعدادات الحساب

1. انقر إعادة تعيين طريقة MFA.

2. انقر تكوين MFA.

3. اتبع التعليمات الموجودة في المصادقة متعددة العوامل/المصادقة المكونة من خطوتين.

استخدم رمز الاسترداد

إذا لم يكن لديك حق الوصول إلى المصادقة متعددة العوامل (2-factor)، فيمكنك تسجيل الدخول باستخدام أحد رموز الاسترداد الخاصة بك.

1. تسجيل الدخول كالمعتاد

2. في صفحة المصادقة متعددة العوامل، لديك خيار استخدام رمز الاسترداد كخيار للمصادقة.

3. أدخل أحد رموز الاسترداد في مربع النص. رمز الاسترداد مُخصص للاستخدام مرة واحدة فقط ولا يُمكن إعادة استخدامه. لتجنب أي لبس في المستقبل، نوصي بوضع علامة على رمز الاسترداد بأنه مُستخدم.

قفل الحساب

إذا أدخلت كلمة مرور خاطئة لاسم المستخدم خمس مرات، فسيغلق النظام حسابك لمدة خمس دقائق تقريبًا. إذا لم تتمكن من الوصول إلى حسابك بعد مرور خمس دقائق، فتواصل مع دعم كروس ريفر.

خطأ المتصفح - جدار الحماية

تقوم بتسجيل الدخول إلى COS Explorer وتحصل على شاشة الخطأ التالية:

لقد تم حظرك بواسطة جدار الحماية.

1. تواصل مع قسم تكنولوجيا المعلومات الداخلي لديك لمعرفة ما إذا كانت مؤسستك تطبق قواعد جدار الحماية على حركة المرور الصادرة. إذا لم تكن هناك قواعد جدار حماية لحركة المرور الصادرة، فإليك ما يلي:

2. تواصل مع قسم تكنولوجيا المعلومات الداخلي لديك للتأكد من اتصالك ببوابة Cross River COS Explorer من عنوان IP معتمد. إذا كنت بحاجة إلى تسجيل المزيد من عناوين IP، فأرسل بريدًا إلكترونيًا إلى دعم COS.

4.2.3.1. إدارة المستخدمين

إدارة المستخدمين

يمكنك استخدام المستخدمون شاشة مسؤل استخدم علامة التبويب هذه لتجميع مجموعة من الموارد، مثل العملاء والمنتجات والحسابات. بمجرد تعيين مورد (مثل منتج أو عميل) لك، لا يمكن تغييره.

يمكنك استخدام هذه المنطقة لدعم عملائك وإجراء تغييرات عليهم. يمكننا تزويدك بمستخدمَين إداريَّين لإنشاء مستخدمين حسب الطلب لعملائك. يمنحك هذا استقلالية في إدارة عملائك، ويتيح لك إجراء تغييرات خارج ساعات العمل، بناءً على طلبهم.

يمكنك أيضًا إنشاء مستخدمين جدد أو دمجهم.

إنشاء مستخدم جديد

في مسؤل علامة التبويب، انقر فوق المستخدمون لفتح المستخدمون شاشة البحث. انقر + مستخدم جديد. ال إنشاء مستخدم يعرض على الشاشة.

In إنشاء مستخدم أدخل بيانات المستخدم بريد إلكتروني، ثم يتم عرض الحقول التالية الاسم الأولاسم العائلة و رقم التليفون.

انقر حالة وحدد نشيط.

ال رقم التليفون يجب أن يكون الحقل رقم هاتف محمول حيث سيتم استخدامه للتحقق من صحة المستخدم من خلال MFA.

حقل الوصف

اسم

اسم المستخدم. أدخل اسم المستخدم الكامل ليظهر في نافذة المتصفح عند تسجيل الدخول إلى Explorer.

بريد إلكتروني

عنوان بريد المستخدم الإلكتروني. يُستخدم هذا العنوان لتسجيل الدخول إلى متصفح إكسبلورر، كما يُستخدم كبريد إلكتروني احتياطي لإعادة تعيين كلمة المرور.

حالة

حدد حالة المستخدم. حالة المستخدم هي غير نشط افتراضيًا. غيّره إلى نشيط عند إنشاء مستخدم.

نوع المستخدم

يعرض هذا الحقل شريك عندما يتم إنشاء المستخدم.

الأدوار

حدد الأدوار التي تريد إضافتها إلى المستخدم، أو انقر فوق تضمين جميع الأدوار لإضافة جميع الأدوار المتاحة للمستخدم.

ملحوظة: ستظهر فقط الأدوار المُخصصة لك. بعض الأدوار تحتوي على أذونات تُمكّنك من إجراء المدفوعات في Explorer. مسؤولو Explorer مسؤولون عن التأكد من إعداد المستخدمين بشكل صحيح بأدوارهم المناسبة فقط، بالإضافة إلى الحدود المسموح بها.

الحدود المسموح بها

لكل حقل، حدد حدًا للدولار (إن أمكن)

انقر حالة وحدد نشيط.

انقر الأدوار وحدد المستخدم الجديد الذي تريد تعيينه. انقر فوق يحفظ الأدوار التغييرات.

الجميع يجب تكوين المستخدمين باستخدام جاهز للشريك الأساسي فقط دور.

إذا تم تعيين المستخدم شريك توليد الأسلاك يجب عليك تكوين حد المنشأ الخاص بهذا المستخدم.

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

عند الانتهاء من تكوين جميع الحقول، انقر فوق حفظ التغييرات.

إذا قمت بإنشاء مستخدم جديد بنجاح، ستظهر شاشة تأكيد. 

10 لإكمال إضافة وتكوين مستخدم، يجب على مسؤول مختلف الموافقة على التغييرات.

11 ال الموافقة على التغييرات المعلقة تظهر الشاشة. انقر يتأكد

12 Viewمعلومات المستخدم

المستندات / الموارد

منصة API عبر النهر [بي دي اف] دليل المستخدم
منصة API، منصة API، منصة

مراجع

اترك تعليقا

لن يتم نشر عنوان بريدك الإلكتروني. تم وضع علامة على الحقول المطلوبة *