API платформа

Започните

1. Добродошли

НОВО! Јавни сајт Крос Ривер са унапред направљеним захтевима за колекцију Крос Поштар
Река. Крајње тачке API-ја

Добродошли у Крос Ривер документацију

Откријте, истражите и почните са лакоћом да интегришете наше производе

Брзи почетак Истражите све производе

Гет започео
Подесите и покрените свој путовање користећи Cross River API-је

Концепти
Откријте како решења компаније Cross River могу трансформисати ваше финтех путовање

АПИ-ји
Развијте користећи банкарство Крос Ривера
платформа и робусни API сетови

Туториали
Научите како да користите Cross
Ривер АПИ-ји корак по корак

2. Куицкстарт 

Корак 1
Корак 2
Корак 3
Корак 4

Преузмите приступни токен

Користите приступни токен

Направите Сampле Апп

Преузмите API акредитиве: Ваш први корак у раду са Cross River API-јима је регистрација за API акредитиве.

Добијте приступни токен: Када добијете своје API акредитиве и пре него што будете могли да користите наше API-је, морате да добијете приступни токен користећи цлиент_ид и цлиент_сецрет које сте добили приликом регистрације.

Користите приступни токен: Када се успешно аутентификујете, аццесс_токен се враћа вама. Укључите овај токен у заглавље ваших API позива.

Webкуке: WebКуке су важна компонента сваке интеграције са Cross River-ом. Иако вам API-ји омогућавају да захтевате податке на захтев, webКуке шаљу ажурирања у реалном времену директно на ваш систем — елиминишући потребу за сталним анкетирањем и смањујући латенцију.

Песковита окружења: Песковник је потпуно изоловано окружење, зато слободно

2.1. Преузмите API акредитиве

Корак 1
Преузмите API акредитиве

Корак 2
Преузмите приступни токен

Корак 3
Користите приступни токен

Корак 4
Направите Сampле Апп

Ваш први корак у раду са Cross River API-јима је регистрација за API акредитиве. Са овим акредитивима можете затражити и добити приступни токен који ћете користити за слање API-ја у нашем sandbox окружењу.

ВАЖНО

Ваша IP адреса, која мора бити јавна и статична, мора бити на нашој листи дозвољених адреса. Ваше интерно ИТ одељење би требало да буде у могућности да вам пружи ову IP адресу. Сазнајте више о статичким IP адресама.

Приступ песковитом систему

Пошаљите захтев за приступ sandbox-у, да бисте добили API акредитиве.

Када ваша статичка ИП адреса буде додата на нашу листу дозвољених, послаћемо вам 2 шифрована имејла са вашим акредитивима:

Једна е-пошта садржи ваше цлиент_ид , ИД_партнера и остале информације које ће вам бити потребне у зависности од тога шта сте тражили.

Друга е-пошта, која је шифрована, садржи ваше цлиент_сецрет и webтајна_куке Биће вам потребно ово за аутентификацију и за рад у sandbox-у.

НАПОМЕНА

Ако сте тражили приступ плаћању картицама, добићете додатни сет акредитива, укључујући и други цлиент_ид и цлиент_сецрет

2.2. Добијте приступни токен

Корак 1
Преузмите API акредитиве

Корак 2
Преузмите приступни токен

Корак 3

Користите приступни токен

Корак 4
Направите Сampле Апп

Крос Ривер користи OAuth 2.0 за аутентификацију и ауторизацију. Ово контролише приступ нашем систему и осигурава да само овлашћени ентитети могу приступити нашим API-јима и другим заштићеним ресурсима. Информације које унесете у наш систем за аутентификацију су поверљиве и никада им се не може приступити из било које друге Крос Ривер апликације.

Када примите свој , и пре него што будете могли да користите наше API-је, морате да добијете API акредитиве. приступни токен користећи цлиент_ид и цлиент_сецрет који сте добили приликом регистрације. Овај приступни токен вам омогућава да безбедно шаљете информације као JSON објекат за употребу у нашим API-јима. Морате укључити овај токен у заглавље сваког API захтева.

Постоји неколико начина да затражите и добијете приступни токен:

Користите интерфејс командне линије (CLI) са cURL или било који други језик

Користите Постман или било који други алат за тестирање АПИ-ја

Када га добијете, копирајте приступни токен у међуспремник. Обавезно га сачувајте.

Интерфејс командне линије

Да бисте затражили токен, пошаљите POST конекција/токен команда која садржи цлиент_ид и цлиент_сецрет и грант_типе до (аутентификационог сервера) сервера за аутентификацију одговарајући песковник, као што је приказано уampле испод.

За објашњење ових погледајте tagsТабела HTTP компоненти

Следећи прampле користи цURL да затражи токен са једног од сервера за ауторизацију.

Sampзахтев у cURL за COS

curl –локација –захтев „POST https://idptest.crbcos.com/connect/token“ \ –заглавље „Тип садржаја: апликација/x-www-форма-“urlкодиран \ –подаци-urlкодирати 'client_id=[ваш ИД овде]' \

 –подаци-urlкодирати 'client_secret=[ваша тајна овде]' \

 –подаци-urlкодирати „grant_type=client_credentials“ \

 –подаци-urlкодирати публика=https://api.crbcos.com/

Sampодговор од cURL захтев

{ „access_token“: „садржи много знакова“, \

 „истиче_за“: 86400, \

 „тип_токена“: „Носилац“ }

поштар

Да бисте затражили токен користећи Постман, пошаљите POST конекција/токен команда за аутх сервер одговарајућег песковника. Додајте грант_типе , обим (опционо) ,

цлиент_ид и цлиент_сецрет на позив.

За објашњење ових погледајте tagsТабела HTTP компоненти

Ако је аутентификација успешна, статусни код је 200 (ОК).

COSExplorer

У , кликните на стрелицу надоле поред ваших пријавних података и кликните на Копирај токен приступаCOS истраживач

Приступни токен се копира у ваш међуспремник, спреман за употребу у .Sandbox-у.

Одговор на захтев за токен

Опис атрибута

приступ_до кен	Дигитално потписан JSON web токен (JWT) послат са oAuth сервера који омогућава приступ одређеним ресурсима Cross River-а
обим	Низ услуга којима корисник може приступити
истиче_и n	Време до истека токена. – Наш тим за интеграцију ће вас обавестити о времену истека или можете декодирати свој приступни токен. – Препоручујемо да преузмете нови приступни токен непосредно пре него што стари токен истекне. – Поново користите токене током целог њиховог животног века уместо да добијате нови токен за сваки позив истог заштићеног ресурса (API). ВАЖНО: Никада не декодирајте свој токен на јавно хостованом webсајту

тип токена

Токен на доносиоца

HTTP компоненте

Следеће HTTP компоненте се користе и у API и у Postman захтевима.

ХТТП

компонента

Tag Опис

Крајња тачка	ПОСТ /connect/toke n	Крајња тачка за преузимање приступног токена
Хеадер	садржаја тип	апликација/к-ввв-форм- 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.

Проверите да ли је цлиент_ид и цлиент_сецрет су правилно откуцани. Разликују велика и мала слова.

Проверите своје цлиент_ид и цлиент_сецрет у односу на онај који сте добили. Уверите се да нема проблема са мрежом или листом дозвољених.

Контактирајте наш тим за интеграцију ако је ваш налог закључан као резултат 3 погрешна пријављивања покушаји.

2.3. Користите приступни токен

Корак 1
Преузмите API акредитиве

Корак 2
Преузмите приступни токен

Корак 3
Користите приступни токен

Корак 4
Направите Сampле Апп

Када успешно завршите, добићете приступни токен вам се враћа. Укључите аутентификовано овај токен у заглављу ваших API позива.

Приступни токен истиче након одређеног временског периода. Одговор који садржи токен такође наводи време истека у секундама. Чувајте и користите свој приступни токен док не истекне. Препоручујемо вам да користите токен док не добијете неовлашћену грешку 401, а затим затражите нови токен.

ВАЖНО

1. Не захтевајте нови токен за сваки API захтев.

2. Обавезно заштитите свој токен. Свако ко украде ваш токен може се представљати као ваш клијент док траје токен.

Заглавље захтева за API

У заглављу сваког API захтева, укључите приступни токен на следећи начин:

Sampпозив за банковно плаћање у цURL

curl –локација –захтев „ПОШАЉИ https://sandbox.crbcos.com/Wires/v1/payments“ –заглавље „Ауторизација: Носилац [ВАШ ТОКЕН ОВДЕ]“ \

–заглавље „Тип садржаја: апликација/x-www-форма-“urlкодиран \

–необрађени-датаци ‘{

 „Број рачуна“: „2255685659“,

 „ПословниФункционалниКод“: „CTR“,

 „број усмеравања пријемника“: „021000021“,

 „корисникФи“: {

 „ИДКод“: „Ф“,

 „идентификатор“: „021000021“,

 „име“: „Џеј Пи Морган Чејс“

 },

 „корисник“: {

 „ИДКод“: „Д“,

 „идентификатор“: „123456789“,

 „име“: „Питер Грифин“

 },

 „Референца корисника“: „XYZ123“,

 „износ“: 10000,

 „Сврха“: „плаћање“

}'

поштар

Да бисте користили токен у Постману, идите на Ауторизација картицу у вашем захтеву, изаберите Токен носиоца као тип аутентификације и налепите свој токен у предвиђено поље. Постман ће аутоматски додати Носилац префикс и токен за Токен поље.

2.4. Webкуке

WebКуке су важна компонента сваке интеграције са Cross River-ом. Иако вам API-ји омогућавају да захтевате податке на захтев, web„hooks“ шаљу ажурирања у реалном времену директно на ваш систем, елиминишући потребу за сталним анкетирањем и смањујући латенцију. У многим случајевима, webКуке су ефикасније и поузданије од самих API-ја, осигуравајући да ваша апликација остане синхронизована са критичним догађајима као што су промене на налогу, ажурирања трансакција и резултати обраде.

Користите web„hooks“ унутар система Cross River-а да би вас обавестио када се догоде различити догађаји. Догађај враћа објекат ресурса који садржи релевантне детаље о теми сваког догађаја. Комплетни детаљи догађаја су укључени и послати вашем систему.

Користимо 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. Поштарска колекција

Да бисмо олакшали развој, саставили смо са унапред изграђеним

Поштарска колекција захтеви за све Cross River. Користите ову колекцију за истраживање, тестирање и изградњу API крајњих тачака вашу интеграцију директно у Postman-у. уз минимално додатно кодирање и подешавање. Да бисте одмах развили нашу колекцију, кликните

Само попуните детаље подешавања и почните да обављате позиве у Sandbox Postman колекцији кроз .

поштар

Приступни (носилац) токен

Направили смо наше програмерско окружење за „песчаник“ за Постмен како бисмо обезбедили безбедан простор за тестирање Крос Ривер АПИ-ја. У колекцији Крос Ривер Постмен, аутентификацију вршите помоћу токена носиоца.

Да бисте добили ИД-ове, потребно је да подесите токен за приступ (носилац) потребан за покретање колекције:

1. Са овим акредитивима захтевате и добијате приступни токен

Преузмите API акредитиве
за коришћење за слање API-ја у нашем sandbox окружењу

2. Када примите своје API акредитиве и пре него што будете могли да користите наше

Добијте приступни токен
API-ји, добијате приступни токен користећи цлиент_ид и цлиент_сецрет које сте добили приликом регистрације.

Колекција Форк Крос Ривер

Идите директно на нашу да поделите нашу колекцију.

Радни простор поштара

Када се једном направи форк, не заборавите да подесите променљиве окружења за sandbox.

Конфигуришите своје окружење за поштаре

Да бисте користили колекцију коју сте управо креирали, идите до ње, кликните Окружења, и изаберите СандбокКопирајте свој ИД клијента и тајни код клијента из Крос Ривера и налепите их у client_Id и цлиент_сецрет поља. За плаћања картицама, налепите их у ptpe_client_id и ptpe_client_secret поља.

Сада сте спремни да добијете токен и почнете да шаљете захтеве.

1. Трчи Ауторизација/Добијање токена да бисте генерисали свој токен. За плаћања картицама, покрените Плаћање картицама/Ауторизација/Добијање P2PE токена .

2. Променљива {{token}} (или ptpe_token за плаћања картицама) се аутоматски додаје у ваше окружење помоћу скрипте за пост-одговор. Када токен истекне, потребно је поново да пратите корак 1.

3. Постоји неколико променљивих које ћете можда морати да попуните у зависности од тога коју крајњу тачку вежбате. На примерampле, ИД_партнера , ИД_продукта , идентификатор_конфигурације и повратни_позивurl .

4. Такође постоје неке променљиве које се попуњавају путем скрипти, као што су токен и ptpe_token које не треба ручно попуњавати.

Пингтхесандрок

Покрените једноставан тест да бисте проверили да ли можете да се повежете са песком Cross River.

Да бисте послали Ping захтев, отворите Postman у Колекције > Колекција Cross River API-ја > Овлашћење и покрените Пинг крајња тачка.

Захтеви за измене

Да бисте ажурирали захтев, извршите измене на Тело tab. Вредности у дуплом curlY заграде се преузимају из ваших променљивих окружења. Проверите нашу документацију да бисте видели која поља сваки API

крајња тачка прихвата, и view захтеве на вашем жељеном језику.

3. Изгради каоampле апп

Корак 1
Преузмите API акредитиве Сетуп

Корак 2
Преузмите приступни токен

Корак 3
Користите приступни токен

Корак 4
Направите Сampле Апп

Пре него што почнете, погледајте наш водич за брзи почетак да бисте се повезали са нашим API-јима. Да бисте тестирали API позиве, можете користити cURL из командне линије или сервиса као што су Postman или Swagger у нашем sandbox-у.

Муштерије и рачуни
Пре него што почнете да користите услуге Крос Ривера, потребно је да креирате евиденција купаца за сваког од ваших купаца

Карте
Управљајте картицама својих купаца тако што ћете сарађивати са компанијом Cross River како бисте одлучили шта желите да понудите, као што су физичке или виртуелне картице.

позајмљивање
Позајмљивање укључује скуп позива API-ја за позајмљивање који вам омогућавају да креирате, ажурирате, и управљајте својим кредитима.

3.1. Сетуп

Пре него што почнете, погледајте наш водич да бисте се повезали са нашим API-јима. Да бисте тестирали брзи почетак API-ја

позиве, можете користити цURL из командне линије или сервиса као што су Postman или Swagger у нашем sandbox-у.

Да бисте креирали апликацију за картицу или плаћање, морате да креирате клијенте и налоге.

Истражите песковито окружење

Имамо пуно тога за истраживање. Песковито окружење је потпуно изоловано песковито окружење. из продукционог окружења, зато слободно експериментишите. Када будете спремни да пређете на продукцију, разговарајте са својим менаџером за односе са клијентима, који ће вам обезбедити продукцијске акредитиве за приступ живом окружењу.

Релевантно за регистрацију web догађаји са куком

WebКуке су важна компонента сваке интеграције са Cross River-ом. Иако вам API-ји омогућавају да захтевате податке на захтев, webКуке директно шаљу ажурирања у реалном времену на ваш систем — елиминишући потребу за сталним анкетирањем и смањујући латенцију. У многим случајевима, webКуке су ефикасније и поузданије од самих API-ја, осигуравајући да ваша апликација остане синхронизована са критичним догађајима као што су промене на налогу, ажурирања трансакција и резултати обраде.

Региструјте се примати webдогађаји закачивања. Када webдогађаји куке се покрећу, догађај објекти се шаљу регистрованим URLs.

3.2. Муштерије и рачуни

Корак 1
Преузмите API акредитиве

Корак 2
Преузмите приступни токен

Корак 3
Користите приступни токен

Корак 4
Направите Сampле Апп

Креирајте евиденцију клијента и финансирани рачун:

Креирајте евиденцију клијента

Направите депозитни рачун

Уплатите средства на рачун

Креирај запис о купцу

Пре него што почнете да користите услуге Крос Ривера, потребно је да за сваку од њих креирате евиденцију о купцу.

ваших купаца. Процес увођења купаца укључује креирање евиденција купаца са релевантним информацијама о купцима.

Сви купци се аутоматски скенирају ради усклађености са прописима, тако да је потребно да се региструјете за релевантне webповезује догађаје за примање ажурирања статуса евиденције купаца.

Запис о купцу може бити за било које од Лично or Посао купци. Након регистрације, купац може бити повезан са једним или више налога.

Webкуке

Региструјте се за webкуке. Следеће webкуке се користе:

WebОпис куке

Core.Customer.Onboarded	Обавештава вас да је креиран запис купца
Језгро.Купац.Офац.Промењено	Обавештава вас да је OFAC статус клијента ажуриран

Core.Customer.PepScan.Chan ged

Nобавештава вас да је PEP статус клијента ажуриран

Exampлеоф рекордеринг

У овом екampнпр., укључићемо Џона Смита. Прво, хајде да направимо запис о купцу. Региструјемо Џона као Лично купац.

Да бисте укључили пословног клијента, прво креирајте лични запис клијента за њега главни власник тог предузећа. Након тога, креирајте пословног клијента и додајте лични запис као стварног власника.

1 Цалл ПОСТ /core/v1/cm/customers .

У следећем прampкоје можете видети су обавезни. који атрибути

ВАЖНО

Топло препоручујемо да у заглавље захтева укључите кључ идемпотенције

да обезбеди дуплирану заштиту у случају квара.

Curl

curl -X ПОСТ /core/v1/cm/customers –заглавље „Тип садржаја: апликација/ј“ {

 „ИД партнера“: “6e80b097-693c-4592-8440-02f345335bbf”,

 "име": {

 „Име“: „Џон“,

 „Презиме“: „Смит“

 },

 „класификација“: „Лично“,

 „проfile„: {

 „регО“: лажно,

 „Политички експонирана особа“: лажно,

 „ТипПорескогИдентификатора“: „СБГ“,

 „порески број“: “119988776”,

 „Датум рођења“: „1953-09-22“,

 „Оцена ризика“: „Ниско“

 „Примарна адреса“: {

 „Тип адресе“: “Кућа”,

 „класификација“: „Стамбени“,

 „јеПримарно“: истина,

 „улица1“: „123 Any St“,

 „град“: „Било где“,

 „држава“: „Њујорк“,

 „Поштански број“: “12345”,

 „Позивни број земље“: „САД“

 },

 „ПримарниТелефон“: {

 „јеПримарно“: истина,

 „Тип телефона“: “Кућа”,

 „Број телефона“: “2015551234”

 },

 „Примарна имејл адреса“: {

 „јеПримарно“: истина,

 „Тип имејла“: „Лично“,

 „Имејл адреса“: „Џон.Смит@xxxxx.com“

 }

}

Успешан API позив враћа JSON одговор са јединственим ID-ом клијента у првом реду тела одговора. Ваш клијент је креиран.

Укључивање тела за одговоре купаца

{

 „ИД“: “9052b6a5-3f09-41d1-b526-ade80104eb79”,

 „cifNumber“: “32653745014”,

 „класификација“: „Лично“,

 "статус": „Активан“,

 „ОФАК“: „На чекању“,

 „pepScan“: „На чекању“,

 "име": {

 „Име“: „Џон“,

 „Презиме“: „Смит“,

 „Пуно име“: „Џон Смит“

 },

 „про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”

}

2 Тхе Core.Customer.Onboarded webДогађај „hook“ се покреће када се креира запис о купцу.

Догађај упознавања купаца

{

 „ИД“: “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”  ],

 „детаљи“: []

}

Крос Ривер скенира евиденцију нових купаца ради усклађености са OFAC и PEP прописима.

Понекад резултати скенирања захтевају поновноview од стране нашег тима за спречавање прања новца (AML).

По завршетку скенирања, Језгро.Купац.Офац.Промењено и

Core.Customer.PepScan.Changed webhook догађаји се враћају са статусом. Корисници без проблема са усклађеношћу показују Јасно статус.

Промењено је скенирање OFAC-а корисника

{

 „ИД“: “45db5592-56ee-41f5-85e7-ade8010571ce”,

 „Назив догађаја“: „Основни.Купац.Офац.Промењено“,

 "статус": „На чекању“,

 „ИД партнера“: “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”  ],

 „детаљи“: []

}

Сада сте креирали запис о купцу.

Ажурирај запис о купцу

Могуће је ажурирати податке о купцу као што су адреса, број телефона и имејл адреса. Ови подаци се узимају у обзир примарни информације. Ако додате другу адресу, ово је секундарни.

1 Користите ИД клијента враћен приликом креирања записа клијента за позив POST /core/v1/cm/customers/{id}/addresses да додате . Прва адреса купца

адреса коју додајете је примарни адреса. У следећем примеруampможете видети који су атрибути потребни.

Ажурирајте адресу купца

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

 „Тип адресе“: “Кућа”,

 „класификација“: „Стамбени“,

 „јеПримарно“: истина,

 „улица1“: „123 Any St“,

 „град“: „Било где“,

 „држава“: „Њујорк“,

 „Поштански број“: “12345”,

 „Позивни број земље“: „САД“

}

2 Цалл ПОСТ /core/v1/cm/customers/{id}/phones да додате

телефон корисника

Први број телефона који додате је примарни број телефона.

број

Ажурирајте број телефона клијента

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

 „јеПримарно“: истина,

 „Тип телефона“: „Мобилни“,

 „Број телефона“: “2015552345”

}

3 Цалл ОБЈАВА /core/v1/cm/customers/{id}/email да ажурирате имејл адресу клијента.

Ажурирајте имејл адресу клијента

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

 „јеПримарно“: истина,

 „Тип имејла“: „Лично“,

 „Имејл адреса“: „john.jones@xxx.com“

}

Направи депозитни рачун

CR нуди низ различитих врста рачуна, укључујући чекове и штедне рачуне, депозитне сертификате (CD-ове или рачуне орочених депозита) и још много тога.

Да бисте отворили било коју врсту депозитног рачуна, морате имати важећи ИД производа за врсту рачуна коју желите да отворите и ИД клијента (ИД регистрованог клијента) за власника рачуна. Имајте на уму да власник рачуна мора имати барем једну адресу и број телефона у свом евиденцији клијента, а његов OFAC статус мора бити ЈасноПоред тога, класификација купца мора да се подудара са конфигурисаном класификацијом за производ. На примерampтј. само пословни корисници могу бити додати пословном производу.

Пре него што почнете

Уверите се да имате:

API акредитиви

ИД партнера (који сте добили приликом регистрације)

ИД клијента

ИД производа (дефинише тип налога који се отвара)

ВАЖНО

Топло препоручујемо да у заглавље захтева укључите кључ идемпотентности како би се спречило дупло плаћање у случају квара.

Крајње тачке и webкуке

Користи се следећа крајња тачка API-ја:

АПИ опис

Отварање депозитног рачуна Отвара депозитни рачун за клијента

Следеће webкука се користи:

WebОпис куке

Основни.Налог.Отворен Отворен је нови налог

Отвори рачун

У следећем сценарију, отворићете налог за Џона Смита, клијента кога сте успешно укључили.

Отварање налога

1 Цалл ПОСТ core/v1/dda/accounts За овај позив су потребни неки атрибути. Погледајте цео .

листа атрибута

Sampле рекуест

ПОСТ /core/v1/dda/accounts

{

 „ИД купца“: “59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 „ИД производа“: “44015e68-1afb-40fc-9497-abc1014f52da”,

 „Наслов“: „Џон Смит“,

 „Адреса изјаве“: {

 „улица1“: „257 Далтон Гроувс“,

 „град“: „Бартон Сити“,

 „држава“: „МИ“,

 „Поштански број“: “48705”,

 „Позивни број земље“: „САД“

 }

}

2 Успешан API позив враћа JSON одговор са детаљима новог налога.

Sampле одговор

ПОСТ /језгро/v1/споразум о дистрибуцији података/рачуни

{

 „ИД купца“: “59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 „ИД производа“: “44015e68-1afb-40fc-9497-abc1014f52da”,

 „Наслов“: „Џон Смит“,

 „Адреса изјаве“: {

 „улица1“: „257 Далтон Гроувс“,

 „град“: „Бартон Сити“,

 „држава“: „МИ“,

 „Поштански број“: “48705”,

 „Позивни број земље“: „САД“

 }

}

3 Тхе Број рачуна поље садржи број рачуна за нови рачун.

4 У одговору нпр.ampтј. рачун је класификован као Лично јер је корисник конфигурисао класификацију производа као ЛичноКласификација налога увек одговара конфигурисаној класификацији производа.

5 Статус налога се аутоматски ажурира на Активан , и одмах је доступан за употребу. Ово покреће Основни.Налог.Отворен догађај.

Детаљи догађаја 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“

 ],

 „детаљи“: []

}

Фондацон

Када радите у „пешчанику“ да бисте тестирали начине плаћања и понашање налога, потребно је да имате средства на рачуну.

Можете користити било коју железницу која има долазну крајњу тачку симулације за финансирање sandbox налога, ако је налог конфигурисан за то. Конкретно, можете:

Симулирајте долазне ACH уплате

Симулирајте долазну жицу

За било коју симулацију, потребан вам је број Cross River sandbox налога који желите да финансирате. Подаци о пошиљаоцу нису важни, а у неким случајевима могу бити чак и потпуно измишљени.

Следећи кораци

Погледајте нашу уплату.

туториали

3.3. Карте

Корак 1
Преузмите API акредитиве

Корак 2
Преузмите приступни токен

Корак 3
Користите приступни токен

Корак 4
Направите Сampле Апп

Упознајте се са радом са Cross River API-јима. Ова страница вам показује како да:

Направи картицу

Активирајте картицу

Креирај картицу

Управљајте картицама својих купаца тако што ћете сарађивати са Cross River-ом како бисте одлучили шта желите да понудите, као што су физичке или виртуелне картице. Ово је конфигурација картицеКрос Ривер креира професионалца за конфигурацију картицаfile за вас за сваку врсту коју одаберете за свој финансијски инструмент купаца.

Пре него што почнете

Уверите се да имате и да имате:

Креирајте евиденцију клијента

Направите депозитни рачун

Број рачуна власника картице

ИД купца (добијате га када креирате купца)

ИД конфигурације (Cross River вам даје ИД када конфигуришете свој тип/карту)

Такође вам препоручујемо да за релевантне webдогађаји куке. региструј се

Крајње тачке иwebкуке

Региструјте се за webкуке. Користе се следеће API крајње тачке:

АПИ опис

Креирај нову картицу Захтева креирање нове дебитне картице

Следеће webкуке се користе:

WebОпис куке

Картице.Картица.Креирана Дебитна картица је креирана

Orderacard

Научићете како да наручите/креирате нову дебитну картицу креирањем картице за Џона Смита.

1 Цалл ПОШТА /управљањекартицама/в1/картице .

У следећем прampможете видети који су атрибути потребни. Погледајте детаље комплетног API-ја.

Додај картицу

Sampкреирајте картицу

curl -X ПОШТА /управљањекартицама/в1/картице –заглавље „Тип садржаја: апликација „бројрачуна“: „2608927303“, \  

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

 „ИД конфигурације“: „a6b5a94c-f8f9-462b-8ce8-afa400f5b640“, \ „Име“: „Јован“, \  

 „презиме“: „Смит“, \  

 „телефон“: { \  

 „Тип телефона“: „Кућа“, \  

 „Број телефона“: „9133413131“ \  

 }, \  

 „Имејл адреса“: „Џон.Смит@xxxxx.com“, \  

 „Адреса за испоруку“: { \  

 „улица1“: „Лејн авенија“, \  

 „улица2“: „низ“, \  

 „град“: „Велики град“, \  

 „држава“: „Иллиноис“, \  

 „поштански број“: „72410“, \  

 „Код земље“: „САД“ \  

 }, \  

 „Адреса за наплату“: { \  

 „улица1“: „Лејн авенија“, \  

 „улица2“: „низ“, \  

 „град“: „Велики град“, \  

 „држава“: „Иллиноис“, \  

 „поштански број“: „72410“, \  

 „Код земље“: „САД“ \  

 }, \  

 „имеНаКартици“: „Џон Смит“, \  

 „Врста испоруке“: „Нормално“, \  

 „Идентификатор клијента“: „стринг“ \  

 }' 'хттпс://сандрбок.црбцос.цом/ЦардМанагемент/в1/цардс'

2 Успешан 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”,  „категорија“: „Кредит“,

 „Инструмент плаћања“: „Виртуелни Пан“,

 „процесор“: „Име процесора“,

 „Врста испоруке“: “нормално”,

 „Статус поруџбине“: „Поруџбина на чекању“,

 „Статус замене“: „Није применљиво“,

 „ИД купца“: “2b15a695-13dc-4b10-b4e5-af5b0138873c”,  „Идентификатор клијента“: „низа“,

 „Креирано у“: “2023-02-13T04:37:29.4869172-05:00”,

 „Последња измена у“: “2023-02-13T04:37:29.4869172-05:00”

}

3 Тхе Картице.Картица.креирана webДогађај „hook“ се покреће када се картица генерише у процесору.

Sampдогађај „Cards.Card.Created“

{

 „ИД“: “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”,

 "статус": „Неактивирано“,

 „КодРазлогаСтатуса“: „Није подешено“

 }

 ]

}

Активирај картицу

Пре него што почнете

Уверите се да имате:

API акредитиви

ИД картице из тренутка када сте наручили картицу

Крајње тачке иwebкуке

АПИ опис

POST /cardmanagement/v1/cards/{id}/activate Активира картицу користећи ИД картице. Упутство користи ове webкуке:

WebОпис куке

Картице.Картица.Активирана. Дебитна картица је активирана

Активирај картицу

Активирајте картицу коју сте креирали уtage.

направи картицу

1 Цалл ОБЈАВИ /cardmanagement/v1/cards/{id}/activate . Тхе id Атрибут мора бити подешен на ИД картице. У sampиспод ИД-а је 8709163d-140c-4d95-a111 afa8009e9cd1.

Sampзахтев за активацију картице

curl -X ПОСТ  

–заглавље „Прихвати: апликација/јсон“

–заглавље „Ауторизација: Носилац“<токен>'

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

2 Успешан 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“,

 „ИмеНаКартици“: „Џон Смит“,

 „panLastFour“: “3629”,

 „isPinSet“: лажно,

 „Датум истека“: „2026-02-13“,

 „АдминБлокиран“: лажно,

 „Осумњичени за превару“: лажно,

 „ИД конфигурације“: “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  „категорија“: „Кредит“,

 „Инструмент плаћања“: „Виртуелни Пан“,

 „процесор“: „Име процесора“,

 „Врста испоруке“: “нормално”,

 „Статус поруџбине“: „Завршено“,

 „Статус замене“: „Није применљиво“,

 „ИД купца“: “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”

}

3 Када се статус картице промени у Активан , тхе Картице.Картица.Активирана. 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
Направите Сampле Апп

Позајмљивање укључује скуп позива који вам омогућавају да креирате, ажурирате и управљате АПИ-јем за позајмљивање ваше кредите.

Да бисте почели да радите са кредитима, уверите се да:

Примите API акредитиве са опсезима потребним за позајмљивање

Ако сте креирали API акредитиве, користећи самостално управљање

, онда би требало да пошаљете и захтев на

arix.support@crossriver.com

Орг, заједно са вашим клијентским ИД-ом и MPLID-ом, да бисте завршили стварање.

Користите исправан опсег за API-је које желите да користите.

API опсег за sandbox је: CosLending:PreApproval:stg

Сандбок

База модула URL за API позиве Опис

Зајам порекло

Одлука о пријави

https://arixapisandbox.crbnj. net	База URL за позиве API-ја за одобравање кредита ка Arix sandbox окружењу
https://lendingsandbox.crbco s.com/preapproval/v1	База URL за песковник одлучивање о пријави

Сваггер

Модул Свагер Линк

АПИ референце документацију	https://arixapisandbox.crbnj.net/swagger-ui
Куке	https://lendingsandbox.crbcos.com/hooks/swagger/inde x.html

Продаје се https://lendingsandbox.crbcos.com/selling/swagger/inde x.html

СтатусПаге

Да бисте видели листу предстојећих издања, пратите тренутни статус API-ја, view извештаје о инцидентима или добијање обавештења о планираном одржавању, посетите нашу страницу са статусом и претплатите се на упозорења.

4. Подешавање програма

Подесите SFTP: Користите SFTP за слање fileили да их преузмете са Крос Ривера, према вашим и нашим потребама.

Увођење купаца: Управљајте подацима о својим клијентима у Крос Риверу оперативни систем (COS) користећи API-је или COS Explorer

Типови и ИД-ови COS производа: Објашњење типова и ИД-ова COS производа.

COS истраживач: Како радити са нашим COS Explorer-ом.

Портал за управљање организацијама: Како радити са нашим порталом за управљање организацијама.

4.1. Подесите SFTP

Када треба да размените осетљиве информације у file формату са Cross River-ом, захтевамо да користите Secure File Протокол за пренос података (SFTP). Користите SFTP за слање fileили да их преузмете са Крос Ривера, у складу са вашим и нашим потребама. У неким случајевима, ви или ми ћемо их шифровати fileс, посебно ако садрже било какве личне идентификационе податке (PII).

Коришћење SFTP-а

SFTP вам омогућава безбедно слање и примање осетљивих података fileи извештаје користећи фасциклу додељену посебно вашем предузећу на безбедном серверу. Отпремите и преузмите fileкроз ту фасциклу или подфасцикле те фасцикле, према вашим специфичним потребама.

Коришћење шифровања

Шифрирање fileс додаје додатни слој заштите. Само овлашћено особље са исправним кључем моћи ће да дешифрује шифровани fileУ Крос Риверу користимо PGP енкрипцију.

Започните

Постоји неколико корака за покретање и коришћење нашег SFTP сервера.

1 Попуњавате образац Захтев за IP приступ за Cross River SFTP услуге (са вашег RM-а).

Ако треба да поделите fileУколико сарађујете са компанијом Cross River, ваш менаџер за односе са клијентима ће вам послати образац Захтев за приступ IP адреси за CRB SFTP услуге. Између осталих информација, потребно је да наведете статичке јавне IP адресе које ћете користити за приступ SFTP фасцикли и јавни PGP кључ за шифровање и дешифровање. fileПошаљите попуњен образац назад свом менаџеру за односе са клијентима

ВАЖНО

Крос Ривер ће вам додати само 5 ИП адреса на дозвољену листу, зато узмите то у обзир. ИП адресе морају бити статичне. Стога, потребно је да проксирате све што није статично са ваше стране.

2 Поставили смо вашу SFTP структуру фолдера.

Када Cross River добије ваше податке, наше одељење за ИТ инжењеринг креира стандардни скуп фасцикли и подфасцикли за вас. Ова јединствена путања је само за ваше пословање. Ниједан други партнер не може да јој приступи. ИТ инжењеринг вам шаље имејл са информацијама које су вам потребне за приступ фасциклама. Имејл садржи везу до ваших акредитива. Cross River не чува вашу лозинку!

ВАЖНО

Линк важи само неколико дана, након чега ћете морати да затражите ресетовање лозинке ако га не користите.

Акредитиви такође постају неважећи ако више од две особе приступе линку.

3 Тестирајте SFTP отпремање.

Ако ћете снабдевати fileдо Крос Ривера, ваше ИТ одељење би требало да подеси налог за услугу са аутоматизованим процесом за отпремање тих fileу ваше SFTP фасцикле. Топло вам препоручујемо да ово тестирате пре него што покушате да пошаљете праве податке. Обратите се свом менаџеру за односе са клијентима уколико имате било каква питања или проблеме или отворите тикет код ваше прве линије подршке.

4 Подесите PGP за слање или примање fileиз Крос Ривера. (Овај корак је неопходан само ако шаљете или примате личне податке. Молимо вас да проверите са својим RM-ом.)

Ако треба да пошаљете Крос Ривер fileс, прво ћемо вам послати наш PGP јавни кључ за употребу у шифровању тих files.

Требало је већ да сте послали Cross River-у свој PGP јавни кључ да бисте га примили fileод нас.

5 Поделите своје податке.

Када подесите SFTP фасциклу и завршите процес, можете почети са дељењем fileса нама. Ваш менаџер за односе са клијентима ће вам рећи да ли постоји нешто конкретније што треба да урадите да бисте примали извештаје или како да припремите податке које ћете нам послати.

Специфични извештаји

Сазнајте више о припреми и слању извештаја и fileс за:

Рачуни и плаћања

Плаћања картицама

Кредитни ризик

позајмљивање

XML групна плаћања (ISO 20022)

4.2. Увођење купаца

Управљајте подацима о својим клијентима у оперативном систему Крос Ривер (COS) користећи API-је или [име сервиса]. Ове информације укључују основне податке потребне за отварање банкарског COS Explorer-а.

налог или користите кредитну картицу, као и прецизније податке о купцу, по потреби. Ово називамо евиденција купаца.

Пре него што отворите депозитни рачун или креирате картицу, морате креирати евиденцију клијента, понекад названу онбоардингЗатим можете доделити једног или више купаца налогу путем одељка за купце односима.

Процес увођења купаца укључује креирање релевантног записа купаца информације о купцима. Пратите овај водич да бисте за сваког од вас креирали евиденцију о купцима.

Опциони кораци

Додајте податке о идентификацији

Додајте стварног власника

Кодови грешака

Погледајте, заједно са многим другим референтним информацијама, о кодовима грешака COS COS система

страница са референтним кодовима.

4.2.1. Евиденција купаца

Евиденција купаца

Запис о купцу је примарни ресурс који садржи информације о купцима у систему Cross River. Стога, пре него што креирате налог за купца, морате га регистровати. Запис о купцу подржава класификације типа Лични или Пословни. Након регистрације, можете повезати купца са једним или више налога.

БившиampДоле је приказано како да се укључи клијент за личног клијента.

Захтев за особу у возачу

ПОСТ /core/v1/cm/customers {

 „ИД партнера“: “7cc038be-fde9-4455-b27b-1497cf667362”,

 "име": {

 „префикс“: „Господин.“,

 „Име“: „Џон“,

 „Средње име“: „Роберт“,

 „Презиме“: „Смит“,

 „суфикс“: „Јр.“,

 „ЖељеноИме“: „Џим“ },

 „класификација“: „Лично“,

 „проfile„: {

 „регО“: лажно,

 „ДржављанствоПозивни број земље“: „САД“,

 „Политички експонирана особа“: лажно,

 „омогући резервну копију“: лажно,

 „проценат задржавања резервне копије“: 0,

 „ТипПорескогИдентификатора“: „СБГ“,

 „порески број“: “123456789”,

 „Датум рођења“: „1965-09-15“,

 „Оцена ризика“: „Ниско“,

 „Одустајање од приватности“: истина }

} Укључите пословног клијента као што је корпорација или ДОО користећи исту крајњу тачку са мало другачијим атрибутима.

Curl

ПОСТ /core/v1/cm/customers {

 „ИД партнера“: “a24cba49-2bb6-431d-a867-1de81d6e4127”,

 "име": {

 „Назив ентитета“: „АКМЕ КО“, },

 „класификација“: „Посао“,

 „проfile„: {

 „ДржављанствоПозивни број земље“: „САД“,  

 „омогући резервну копију“: лажно,

 „проценат задржавања резервне копије“: 0,  

 „ТипПорескогИдентификатора“: „Ајн“,

 „порески број“: “123456789”,

 „Датум формирања“: „2019-09-10“,

 „Тип ентитета“: „Корпорација“,

 „Оцена ризика“: „Ниско“,

 „Тип власништва“: „Правно лице“,

 „ПримарниВласникИдентификаторКупца“: “f9321f7f-3712-46e1-b965-2b79ead64dc9”, } }

Без обзира да ли упознајете физичког или пословног клијента, ИД клијента примарног власника Атрибут мора да садржи ИД купца који се односи на запис купца типа Лични. Дакле, да бисте укључили предузеће, прво морате да креирате лични запис купца за примарног власника тог предузећа.

ВАЖНО

Неке крајње тачке корисника укључују дужна пажња ресурс који може, али и не мора бити потребан приликом укључивања личних клијената. Ваша додељена особа за усклађеност саопштава захтеве за сва поља дужне пажње током процеса укључивања.

Корисни власници

Стварни власник је особа која поседује 25% или више предузећа. Из регулаторних разлога, потребно је да обезбедите ресурсе у Посао евиденција о клијенту креира стварног власника

за сваког стварног власника тог предузећа. власник/идентификатор клијента Атрибут се односи на лични запис клијента за сваког стварног власника. Обично додајете ресурсе стварног власника у запис пословног клијента одмах након регистрације предузећа.

Curl

ПОСТ /core/v1/cm/customers/{customerId}/beneficial-owners {

 „власник/ИДкупца“: “c1210a2d-932e-43ca-be29-f358a4382385”,

 „Наслов власника“: „Председник“ }

Адреса

Физичке адресе повезане са купцем могу бити .

ажурирано

Curl

POST /core/v1/cm/customers/{customerId}/addresses

{

 „јеПримарно“: истина,

 "статус": „Активан“,

 „класификација“: „Стамбени“,

 „Тип адресе“: “Кућа”,

 „улица1“: „Јејплова улица 123“,

 „улица2“: „Стан 12“,

 „улица3“: “”,

 „град“: “Њујорк”,

 „држава“: „Њујорк“,

 „Поштански број“: “10025”,

 „Позивни број земље“: „САД“,

}

Имејл адресе

Ажурирајте е-пошту

контакт информације за купца.

Curl

ПОСТ /core/v1/cm/customers/{customerId}/emails {

 „јеПримарно“: истина,

 „Тип имејла“: „Лично“,

 „Имејл адреса“: „john.smith@crossriver.com“ }

Телефони

Ажурирај телефон Curl

контакт информације за купца.

ПОСТ /core/v1/cm/customers/{customerId}/phones

{

 „Тип телефона“: “Кућа”,

 „јеПримарно“: истина,

 „Број телефона“: “2015551234”

}

Идентификације

Идентификације се користе за праћење метаподатака за документа која идентификују купце, као што су возачке дозволе и пасоши. Могу се користити за додавање нових података о идентификацији. Додајте податке о идентификацији.

Curl

ПОСТ /core/v1/cm/customers/{customerId}/identifications {

 „јеПримарно“: истина,

 „ИД број“: „DL123456789“,

 „Тип иденфикатора“: „Возачка дозвола“,

 „Датум издавања“: „2018-08-30“,

 „Датум истека“: „2018-08-30“,

 „ВерификованиДатум“: „2018-08-30“,

 „Издавајући орган“: „Департамент моторних возила Њу Џерзија“,

 „ДржаваИлиПокрајинаИздаје“: „Њу Џерзи“,

 „КодЗемљеИздавања“: „САД“,

}

4.2.2. Типови и ИД-ови COS производа

У Крос Риверу, а тип производа је јединствено конфигурисан финансијски производ који нудите својим клијентима. На примерampТј. тип производа може бити дебитна картица или штедни рачун, конфигурисан према вашим потребама и спецификацијама. Отварате рачуне за своје клијенте под било којим типом производа који дефинишете и конфигуришете заједно са нама. Разговарајте са својим менаџером за односе са клијентима за више детаља, укључујући и како да подесите типове производа за своје клијенте.

Фор екampТј. можда ћете желети да конфигуришете тип производа као производ штедног рачуна који користи банковне трансфере и ACH плаћања. Затим можете понудити својим клијентима штедне рачуне са овим услугама и конфигурацијама.

Крос Ривер вам пружа ИД производа за сваку врсту производа коју желите да понудите својим купцима. Да бисте отворили било коју врсту депозитног рачуна, морате имати важећи ИД производа и ИД купца (ИД регистрованог купца) за власника рачуна. Имајте на уму да власник рачуна мора имати барем једну адресу и број телефона у свом евиденцији купаца, а његов OFAC статус мора бити ЈасноПоред тога, класификација купца мора да се подудара са конфигурисаном класификацијом за производ. На примерampтј. само пословни корисници могу бити додати пословном производу.

4.2.3. COS Explorer

Када се региструјете у систему Крос Ривер и примите имејл са пријавом

твој ИД клијента и Тајна Спремни сте да се пријавите на COS Explorer. Приступите COSExplorer порталу

Производња:

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

Песковник:

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

Добродошли имејл

Добићете имејл добродошлице од CrossRiver_DO_NOT_REPLY@crossriver.comАко га не видите у пријемном сандучету, проверите фасцикле за нежељену пошту или блокирану пошту.

Кликните Направите свој налог у Крос Риверу.

Ако у било ком тренутку напустите чаробњака, кликните на везу у оригиналној е-поруци да бисте се вратили тамо где сте стали.

Услови и одредбе

Прочитајте услове и одредбе, проверите Прихвати, и кликните Следеће.

СМС верификација (текстуална порука)

Шаљемо вам СМС (текстуалну поруку) на ваш уређај да бисмо потврдили ваш идентитет. Унесите шестоцифрени код који добијете на екрану за пријаву и кликните на Верификујте код.

Креирајте своју лозинку

1. Унесите лозинку која испуњава захтеве на екрану и поново је унесите. 

2. Кликните Цреате Пассворд.

Подешавање апликације Authenticator

Морате завршити овај корак да бисте наставили процес регистрације и могли се пријавити у будућности

Да бисмо заштитили ваш идентитет, ваш налог и информације, захтевамо да се пријавите помоћу вишефакторске/2-факторске аутентификације.

Ако већ немате апликацију за аутентификовање на свом уређају, потребно је да је преузмете пре него што наставите.

За Андроид и иОС препоручујемо коришћење апликације за аутентификовање:

Гоогле Аутхентицатор

Мајкрософт аутентификатор

Када инсталирате апликацију за аутентификовање, потребно је да урадите једно од тога скенирајте КР код or ручно унесите кључ у апликацију за аутентификатор.

КРцоде

1. Скенирајте QR код у апликацији за аутентификацију и, ако је потребно, унесите шестоцифрени код на страници за вишефакторску аутентификацију.

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 адресе Identity Server-а су:

172.67.26.222 104.22.40.134 104.22.41.134

Сервер је проксиран преко Cloudflare-а.

Можете дозволити ове FQDN-ове:

idptest.crbcos.com

Решавање проблема

Заборављена лозинка

1. Кликните Заборавили сте лозинку? и унесите своју имејл адресу.

2. Унесите шестоцифрени код за аутентификацију из апликације за аутентификацију. 3. Добијате а Заборавили сте лозинку имејл. Кликните Ресет Пассворд.

4. На страници за ресетовање лозинке унесите нову лозинку, кликните на Ресет Пассворд, и Наставите ка апликацији.

Ресетуј вишефакторску аутентификацију

Ако већ имате конфигурисан MFA:

1. У Identity Server-у идите на Ресетуј вишеструко обављена провера (MFA) и кликните Ресетујте свој MFA уређај. 2. Отвара се страница за вишефакторску аутентификацију и можете ресетовати своју МФА.

Такође можете да креирате нове кодове за опоравак вишефакторске аутентификације.

1. Кликните креирајте нове кодове за опоравак вишефакторске аутентификације.

2. Отвара се страница Кодови за опоравак и можете копирати или преузети својих 10 нових кодова за опоравак.

Ако још нисте конфигурисали вишефакторску аутентификацију, можете омогућити MFA из Подешавања налога.

1. Кликните Ресетуј МФА метод.

2. Кликните Конфигуришите вишеструко обављене фацетације (MFA).

3. Пратите упутства у одељку Вишефакторска аутентификација/аутентификација у 2 корака.

Ако је ваш тренутни MFA SMS, можете га омогућити помоћу апликације за аутентификовање. Подешавања налога

1. Кликните Ресетуј МФА метод.

2. Кликните Конфигуришите вишеструко обављене фацетације (MFA).

3. Пратите упутства у одељку Вишефакторска аутентификација/аутентификација у 2 корака.

Користите код за опоравак

Ако немате приступ свом вишефакторском (2-факторском) аутентификатору, можете се пријавити помоћу једног од својих кодова за опоравак.

1. Пријавите се као и обично

2. На страници Вишефакторска аутентификација имате могућност да користите код за опоравак као опцију аутентификације.

3. Унесите један од ваших кодова за опоравак у текстуално поље. Код за опоравак је за једнократну употребу и не може се поново користити. Да бисте избегли будућу забуну, препоручујемо да означите код за опоравак као искоришћен.

Закључавање налога

Ако 5 пута унесете погрешну лозинку за своје корисничко име, систем ће закључати ваш налог на приближно 5 минута. Ако након 5 минута и даље не можете да приступите свом налогу, контактирајте подршку Cross River-а.

Грешка прегледача - Заштитни зид

Пријавите се на COS Explorer и добијете следећи екран са грешком:

Блокиран/а сте заштитним зидом/фајерволом.

1. Обратите се свом интерном ИТ одељењу да бисте видели да ли ваша организација примењује правила заштитног зида (firewall) за одлазни саобраћај. Ако не постоје правила заштитног зида (firewall) за одлазни саобраћај, онда:

2. Обратите се свом интерном ИТ одељењу да бисте били сигурни да се повезујете на Cross River COS Explorer портал са одобрене IP адресе. Ако треба да региструјете још IP адреса, пошаљите имејл COS подршци.

4.2.3.1. Управљање корисницима

Управљање корисницима

Можете користити Корисници екран од Админ Притисните тастер Tab да бисте груписали скуп ресурса, као што су купци, производи и рачуни. Када вам је ресурс (нпр. производ или купац) додељен, не може се променити.

Овај простор можете користити за подршку и прављење измена за ваше клијенте. Можемо вам доделити 2 администраторска корисника како бисте могли да креирате кориснике по потреби за своје клијенте. Ово вам даје независност у управљању вашим клијентима и омогућава вам да правите измене ван радног времена, на њихов захтев.

Такође можете креирати или укључити нове кориснике.

Направи новог корисника

1 У Админ картицу, кликните Корисници да отворите Корисници екран за претрагу. 2 Кликните + Нови корисник. Тхе Креирај корисника прикази на екрану.

3 In Креирај корисника унесите корисников Емаил, затим се приказују следећа поља Име, Презиме и Број телефона.

4 Кликните Статус и изаберите Активан.

Тхе Број телефона Поље мора бити број мобилног телефона јер ће се ово користити за MFA за аутентификацију корисника.

Опис поља

Име	Корисничко име. Унесите пуно корисничко име које ће се приказивати у прозору прегледача када се корисник пријави у Explorer.
Емаил	Корисничка имејл адреса. Ова адреса се користи за пријављивање у Explorer, а служи и као имејл адреса за опоравак приликом ресетовања лозинке.
Статус	Изаберите статус корисника. Статус корисника је Неактиван подразумевано. Промените га у Активан приликом креирања корисника.
Тип корисника	Ово поље приказује Партнер када је корисник креиран.
Улоге	Изаберите улоге које желите да додате кориснику или кликните Укључи све улоге да бисте додали све доступне улоге кориснику. Напомена: Биће видљиве само улоге које су вам додељене. Неке улоге садрже дозволе које вам омогућавају да вршите плаћања у Explorer-у. Ваши администратори Explorer-а су одговорни за осигуравање да су ваши корисници правилно конфигурисани само са одговарајућим корисничким улогама, као и овлашћеним ограничењима.

Овлашћени лимити

За свако поље изаберите ограничење у доларима (ако је применљиво)

5 Кликните Статус и изаберите Активан.

6 Кликните Улоге и изаберите кога желите да доделите новом кориснику. Кликните Сачувај улоге Промене.

Све корисници морају бити конфигурисани са Само за партнерско језгро улога.

Ако је кориснику додељено Порекло партнерског трансфера улоге морате да конфигуришете ограничење порекла за тог корисника.

7 Ако додељујете кориснику Порекло партнерског трансфера улоге, унесите вредност у Банкарско.Плаћање.Порекло поље за означавање максималног лимита у доларима по трансферу. У супротном, можете игнорисати ово поље.

8 Када завршите са конфигурисањем свих поља, кликните Сачувај промене.

9 Ако сте успешно креирали новог корисника, приказаће се екран за потврду. 

10 Да би се завршило додавање и конфигурација корисника, други администратор мора Одобри измене.

11 Тхе Одобри промене на чекању екран се приказује. Кликните Потврди. 

12 ViewКорисничке информације

Документи / Ресурси

API платформа Крос Ривер [пдф] Упутство за употребу API платформа, API платформа, платформа

Референце

• Упутство за употребу