API platforma

Započnite

1. Dobrodošli

NOVO! Javna lokacija Cross Rivera s unaprijed pripremljenim zahtjevima za kolekciju Cross Postman
Rijeka. API krajnje tačke

Dobrodošli u Cross River dokumentaciju

Otkrijte, istražite i počnite integrirati naše proizvode s lakoćom

Brzi početak Istražite sve proizvode

Get počeo
Postavite i pokrenite svoj putovanje korištenjem Cross River API-ja

Koncepti
Otkrijte kako Cross River rješenja mogu transformirati vaše fintech putovanje

API-ji
Razvijajte koristeći bankarstvo Cross Rivera
platforma i robusni API setovi

Tutorijali
Naučite kako koristiti Cross
Riječni API-ji korak po korak

2. Quickstart 

Korak 1
Korak 2
Korak 3
Korak 4

Nabavite pristupni token

Koristi pristupni token

Izgradite Sample App

Preuzmite API akreditive: Vaš prvi korak u radu s Cross River API-jima je registracija API akreditiva.

Nabavite token za pristup: Nakon što primite svoje API akreditive i prije nego što možete koristiti naše API-je, morate dobiti pristupni token koristeći client_id i client_secret koje ste dobili prilikom registracije.

Koristite token za pristup: Nakon što se uspješno autentifikujete, access_token se vraća vama. Uključite ovaj token u zaglavlje vaših API poziva.

Webkuke: Webkuke su važna komponenta svake integracije sa Cross Riverom. Dok vam API-ji omogućavaju da zatražite podatke na zahtjev, webHooks-ovi šalju ažuriranja u realnom vremenu direktno na vaš sistem, eliminirajući potrebu za stalnim ispitivanjem i smanjujući latenciju.

Sandbox okruženja: Pješčanik je potpuno izolirano okruženje, zato slobodno

2.1. Preuzmite API akreditive

Korak 1
Preuzmite API akreditive

Korak 2
Nabavite pristupni token

Korak 3
Koristi pristupni token

Korak 4
Izgradite Sample App

Vaš prvi korak u radu s Cross River API-jima je registracija API vjerodajnica. S ovim vjerodajnicama možete zatražiti i dobiti pristupni token koji ćete koristiti za slanje API-ja u našem sandbox okruženju.

VAŽNO

Vaša IP adresa, koja mora biti javna i statična, mora biti na našoj listi dozvoljenih adresa. Vaš interni IT odjel bi trebao biti u mogućnosti da vam dodijeli ovu IP adresu. Saznajte više o statičkim IP adresama.

Pristup sandboxu

Pošaljite zahtjev za pristup sandboxu, za primanje API akreditiva.

Nakon što vaša statička IP adresa bude dodana na našu listu dozvoljenih, poslat ćemo vam 2 šifrirana e-maila s vašim podacima za prijavu:

Jedan email sadrži vaše client_id , partner_id i ostale informacije koje će vam trebati u zavisnosti od onoga što ste tražili.

Druga e-poruka, koja je šifrirana, sadrži vašu client_secret i webtajna_kuke Trebat će vam ovo za autentifikaciju i za rad u sandboxu.

NAPOMENA

Ako ste zatražili pristup plaćanju karticama, dobit ćete dodatni set akreditacija, uključujući i drugi client_id i client_secret

2.2. Nabavite token za pristup

Korak 1
Preuzmite API akreditive

Korak 2
Nabavite pristupni token

Korak 3

Koristi pristupni token

Korak 4
Izgradite Sample App

Cross River koristi OAuth 2.0 za autentifikaciju i autorizaciju. Ovo kontroliše pristup našem sistemu i osigurava da samo ovlašteni subjekti mogu pristupiti našim API-jima i drugim zaštićenim resursima. Informacije koje unesete u naš sistem za autentifikaciju su povjerljive i nikada im se ne može pristupiti iz bilo koje druge Cross River aplikacije.

Nakon što primite svoj , a prije nego što možete koristiti naše API-je, morate dobiti API akreditive. pristupni token koji koristi client_id i client_secret koji ste primili prilikom registracije. Ovaj pristupni token vam omogućava sigurno slanje informacija kao JSON objekta za upotrebu u našim API-jima. Morate uključiti ovaj token u zaglavlje svakog API zahtjeva.

Postoji nekoliko načina za traženje i primanje pristupnog tokena:

Koristite interfejs komandne linije (CLI) sa cURL ili bilo koji drugi jezik

Koristite Postman ili bilo koji drugi alat za testiranje API-ja

Nakon što ga dobijete, kopirajte pristupni token u međuspremnik. Obavezno ga sačuvajte.

Interfejs komandne linije

Da biste zatražili token, pošaljite POST povezivanje/token komanda koja sadrži client_id i client_secret i grant_type na (autentifikacijski server) autentifikacijskog servera odgovarajući pješčanik, kao što je prikazano uample ispod.

Za objašnjenje ovih tagsTabela HTTP komponenti

Sljedeći prample koristi cURL zatražiti token od jednog od autentifikacijskih servera.

Sampzahtjev u cURL za COS

curl –lokacija –zahtjev 'POST https://idptest.crbcos.com/connect/token' \ –zaglavlje 'Vrsta sadržaja: aplikacija/x-www-form-urlkodiran \ –podaci-urlencode 'client_id=[vaš ID ovdje]' \

 –podaci-urlencode 'client_secret=[vaša tajna ovdje]' \

 –podaci-urlencode 'grant_type=client_credentials' \

 –podaci-urlencode 'publika=https://api.crbcos.com/'

Sampodgovor od cURL zahtjev

{ "pristupni_token": "sadrži mnogo znakova", \

 "ističe_za": 86400, \

 "tip_tokena": "Nosilac" }

Poštar

Da biste zatražili token koristeći Postman, pošaljite POST povezivanje/token naredba za auth server odgovarajućeg sandboxa. Dodajte grant_type , opseg (opciono) ,

client_id i client_secret na poziv.

Za objašnjenje ovih tagsTabela HTTP komponenti

Ako je autentifikacija uspješna, statusni kod je 200 (U redu).

COSExplorer

U odjeljku [Naziv datoteke] kliknite na strelicu prema dolje pored vaših prijavnih podataka i kliknite na [Naziv datoteke]. Kopiraj token za pristupCOS Explorer

Pristupni token se kopira u vaš međuspremnik, spreman za upotrebu u . Sandboxu.

Odgovor na zahtjev za token

Opis atributa

pristup_do ken	Digitalno potpisani JSON web token (JWT) poslan sa oAuth servera koji omogućava pristup određenim Cross River resursima
obim	Niz usluga kojima korisnik može pristupiti
isteče_i n	Vremenski period do isteka tokena. – Naš tim za integraciju će vas obavijestiti o vremenu isteka ili možete dekodirati svoj pristupni token. – Preporučujemo da preuzmete novi pristupni token neposredno prije isteka starog tokena. – Ponovo koristite tokene tokom cijelog njihovog životnog vijeka umjesto dobijanja novog tokena za svaki poziv istog zaštićenog resursa (API). VAŽNO: Nikada ne dekodirajte svoj token na javno hostovanoj platformi website

vrsta tokena

Token na nosioca

HTTP komponente

Sljedeće HTTP komponente se koriste i u API i u Postman zahtjevima.

HTTP

komponenta

Tag Opis

Krajnja tačka	POST /povezivanje/token n	Krajnja tačka za preuzimanje pristupnog tokena
Zaglavlje	sadržaj tip	aplikacija/x-www-forma- urlkodiran
Tijelo	client_id	Jedinstveni identifikator za klijenta
Tijelo	tajna_klijenta t	Šifrirani niz znakova koji se koristi za potpisivanje i validaciju ID tokena. Važno: Tajne se ne mogu oporaviti CR-om. Ako izgubite tajnu, morate generirati novu. Nemoj povjerite svoje tajne kontroli izvora.
Tijelo	grant_type	Ovo polje će uvijek imati vrijednost klijentski_akreditivi
Tijelo	publika opciono	Način na koji korisnik može provjeriti je li određeni token za pristup namijenjen njemu.
Tijelo	obim opciono	Određeni raspon ili ograničeni skup usluga kojima korisnik može pristupiti pomoću tokena za pristup. Ako opseg nije naveden, vraćeni token će sadržavati sve opsege povezane s vašim vjerodajnicama. Napomena: Višestruki opsezi se mogu poslati u istom zahtjevu dodavanjem razmaka između naziva svakog opsega. Na primjerample: 'scope=scope1 scope2 scope3'

Autorizacijski serverURLs

Modul za autentifikaciju servera URL

Računi	https://idptest.crbcos.com/connect/token
ACH	https://idptest.crbcos.com/connect/token
Žice	https://idptest.crbcos.com/connect/token
Čekovi	https://idptest.crbcos.com/connect/token
Core	https://idptest.crbcos.com/connect/token
Trenutna plaćanja	https://idptest.crbcos.com/connect/token
Izdavanje kartice	https://idptest.crbcos.com/connect/token
Plaćanja karticama	https://crbcos-sandbox.auth0.com/oauth/token

Pozajmljivanje https://oauthtest.crbnj.net/connect/token

Rješavanje problema

Ako je autentifikacijski token važeći, vratit će se kod 200. Ako autentifikacijski token nije važeći, vratit će se kod 401.

Ako ne možete dobiti token na donosioca i niste ga primili u prošlosti:

Potvrdite URL.

Proverite da li je client_id i client_secret su ispravno otkucani. Razlikuju velika i mala slova.

Provjerite svoje client_id i client_secret u odnosu na onaj koji ste primili. Provjerite da nema problema s mrežom ili listom dozvoljenih.

Kontaktirajte naš Tim za integraciju ako je vaš račun zaključan kao rezultat 3 netačne prijave. pokušaji.

2.3. Koristite token za pristup

Korak 1
Preuzmite API akreditive

Korak 2
Nabavite pristupni token

Korak 3
Koristi pristupni token

Korak 4
Izgradite Sample App

Nakon što uspješno završite, dobit ćete pristupni token vraćeno vam je. Uključite autentificirano ovaj token u zaglavlju vaših API poziva.

Pristupni token ističe nakon određenog vremenskog perioda. Odgovor koji sadrži token također navodi vrijeme isteka u sekundama. Sačuvajte i koristite svoj pristupni token dok ne istekne. Preporučujemo da koristite token dok ne dobijete neovlaštenu grešku 401, a zatim zatražite novi token.

VAŽNO

1. Nemojte tražiti novi token za svaki API zahtjev.

2. Obavezno zaštitite svoj token. Svako ko ukrade vaš token može se predstavljati kao vaš klijent tokom njegovog životnog vijeka.

Zaglavlje API zahtjeva

U zaglavlju svakog API zahtjeva, uključite token za pristup na sljedeći način:

Samppoziv za bankovno plaćanje u cURL

curl –lokacija –zahtjev 'POST https://sandbox.crbcos.com/Wires/v1/payments' –zaglavlje 'Autorizacija: Donosilac [VAŠ TOKEN OVDJE]' \

–zaglavlje 'Vrsta sadržaja: aplikacija/x-www-form-urlkodiran \

–sirovi-podaci ‘{

 „Broj računa“: „2255685659“,

 „PoslovniFunkcionalniKod“: „CTR“,

 „Broj usmjeravanja prijemnika“: „021000021“,

 "korisnikFi": {

 "ID kod": "F",

 „identifikator“: „021000021“,

 „ime“: „JP Morgan Chase“

 },

 "korisnik": {

 "ID kod": "D",

 „identifikator“: „123456789“,

 „ime“: „Peter Griffin“

 },

 „Referenca korisnika“: „XYZ123“,

 "iznos": 10000,

 „svrha“: „plaćanje“

}'

Poštar

Da biste koristili token u Postmanu, idite na Autorizacija u vašem zahtjevu, odaberite Token nosioca kao vrstu autentifikacije i zalijepite svoj token u predviđeno polje. Postman će automatski dodati Nosilac prefiks i token za Token polje.

2.4. Webkuke

Webkuke su važna komponenta svake integracije sa Cross Riverom. Dok vam API-ji omogućavaju da zatražite podatke na zahtjev, webHooks šalju ažuriranja u realnom vremenu direktno na vaš sistem, eliminirajući potrebu za stalnim ispitivanjem i smanjujući latenciju. U mnogim slučajevima, webHook-ovi su efikasniji i pouzdaniji od samih API-ja, osiguravajući da vaša aplikacija ostane sinhronizirana s kritičnim događajima poput promjena na računu, ažuriranja transakcija i rezultata obrade.

Koristi webkuke unutar Cross River sistema kako bi vas obavijestile kada se dogode različiti događaji. Događaj vraća objekt resursa koji sadrži relevantne detalje o temi svakog događaja. Potpuni detalji događaja su uključeni i poslani vašem sistemu.

Koristimo webkuke za ažuriranje statusa i prijavljivanje promjena transakcija. WebHooks izvještavaju vaš sistem s obavijestima u stvarnom vremenu kada se dogodi događaj.

Morate se registrovati putem API-ja da biste koristili webkuke:

Registrujte se za račune, kartice i događaje plaćanja

Registrujte se za događaje plaćanja karticama

Registrujte se za događaje kreditiranja

2.5. Sandbox okruženja

Naš sandbox je potpuno izolirano okruženje, zato slobodno eksperimentirajte. Kada budete spremni za prelazak na produkciju, javite nam i mi ćemo vam obezbijediti produkcijske akreditive za pristup živom okruženju.

Upravljanje kupcima

Baza modula URL za API pozive

Upravljanje korisnicima https://sandbox.crbcos.com/core/ Računi

Baza modula URL za API pozive

Depozitni računi

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

Depozitne akcije https://sandbox.crbcos.com/sweepsintrafi/ Karte

Baza modula URL za API pozive

Kartice https://sandbox.crbcos.com/cardmanagement/Plaćanja

Baza modula URL za API pozive

Trenutna plaćanja	https://sandbox.crbcos.com/rtp/
Plaćanje karticama: Push to pay	https://pushtopaystaging.crbnj.net/
Plaćanje karticama: Povlačenje	https://pullfromcardapistg.crbnj.net/
Međunarodna plaćanja	https://sandbox.crbcos.com/international/
ACH	https://sandbox.crbcos.com/ach/
Žice	https://sandbox.crbcos.com/wires/

Čekovi https://sandbox.crbcos.com/checks/ COSwebkuke

Baza modula URL za API pozive

COS webkuke

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

Pozajmljivanje

Baza modula URL za API pozive

Odobrenje kredita

https://arixapisandbox.crbnj.net

Odlučivanje o prijavi https://lendingsandbox.crbcos.com/preapproval/v1

2.6. Kolekcija poštara

Kako bismo olakšali razvoj, sastavili smo sa unaprijed izgrađenim

Kolekcija poštara zahtjevi za sve Cross River. Koristite ovu kolekciju za istraživanje, testiranje i izgradnju API krajnjih tačaka vašu integraciju direktno u Postmanu, uz minimalno dodatno kodiranje i podešavanje. Da biste odmah forknuli našu kolekciju, kliknite

Samo dovršite detalje podešavanja i počnite upućivati ​​pozive u Sandbox Postman kolekciji. kroz .

Poštar

Pristupni (nosilac) token

Kreirali smo naše Postman razvojno okruženje za testiranje kako bismo osigurali siguran prostor za testiranje Cross River API-ja. U Cross River Postman kolekciji, autentifikaciju vršite pomoću tokena nosioca.

Da biste dobili ID-ove, potrebno je postaviti token za pristup (nosač) potreban za pokretanje kolekcije:

1. S ovim akreditivima tražite i primate pristupni token

Preuzmite API akreditive
za korištenje za slanje API-ja u našem sandbox okruženju

2. Nakon što primite svoje API akreditive i prije nego što možete koristiti naše

Nabavite token za pristup
API-je, dobijate token za pristup koristeći client_id i client_secret koje ste dobili prilikom registracije.

Kolekcija Fork Cross River

Idite direktno na našu stranicu da podijelite našu kolekciju.

Radni prostor poštara

Nakon što se forkuje, ne zaboravite postaviti varijable okruženja za sandbox.

Konfigurišite svoje Postman okruženje

Da biste koristili kolekciju koju ste upravo kreirali, idite do nje, kliknite Okruženja, i odaberite SandboxKopirajte svoj Cross River ID klijenta i tajni kod klijenta i zalijepite ih u ID_klijenta i client_secret polja. Za plaćanja karticama, zalijepite ih u ptpe_client_id i tajna_klijenta_ptpe polja.

Sada ste spremni da dobijete token i počnete slati zahtjeve.

1. Trči Autorizacija/Dobijanje tokena da generirate svoj token. Za plaćanje karticama, pokrenite Plaćanje karticama/Autorizacija/Dobijanje P2PE tokena .

2. Varijabla {{token}} (ili ptpe_token za plaćanja karticama) se automatski dodaje u vaše okruženje putem skripte za naknadni odgovor. Kada token istekne, morate ponovo slijediti korak 1.

3. Postoji nekoliko varijabli koje ćete možda morati popuniti ovisno o tome koju krajnju tačku vježbate. Na primjerample, partner_id , ID_proizvoda , id_konfiguracije i povratni_pozivurl .

4. Postoje i neke varijable koje se popunjavaju putem skripti, kao što su token i ptpe_token koje ne treba ručno popunjavati.

Pingthesandbox

Pokrenite jednostavan test kako biste provjerili da li se možete povezati sa sandboxom Cross River.

Da biste poslali Ping zahtjev, otvorite Postman Kolekcije > Cross River API kolekcija > Autorizacija i pokrenite Ping krajnja tačka.

Zahtjevi za izmjenu

Da biste ažurirali zahtjev, izvršite promjene na Tijelo tab. Vrijednosti u dvostrukom curlY zagrade se izvlače iz vaših varijabli okruženja. Provjerite našu API dokumentaciju da vidite koja polja svaki

krajnja tačka prihvata i view zahtjeve na vašem željenom jeziku.

3. Izgradi kaoample app

Korak 1
Preuzmite API akreditive Setup

Korak 2
Nabavite pristupni token

Korak 3
Koristi pristupni token

Korak 4
Izgradite Sample App

Prije nego što počnete, pogledajte naš vodič za brzi početak kako biste se povezali s našim API-jima. Za testiranje API poziva možete koristiti cURL iz komandne linije ili servisa kao što su Postman ili Swagger u našem sandboxu.

Kupci i računi
Prije nego što počnete koristiti usluge Cross Rivera, potrebno je da kreirate evidenciju kupaca za svakog od vaših kupaca

Karte
Upravljajte karticama svojih kupaca tako što ćete sarađivati ​​sa Cross Riverom kako biste odlučili šta želite da ponudite, kao što su fizičke ili virtuelne kartice.

Pozajmljivanje
Kreditiranje uključuje skup poziva API-ja za kreditiranje koji vam omogućavaju kreiranje, ažuriranje, i upravljajte svojim kreditima.

3.1. Setup

Prije nego što počnete, pogledajte naš vodič za povezivanje s našim API-jima. Za brzi početak testiranja API-ja

pozive, možete koristiti cURL iz komandne linije ili servisa kao što su Postman ili Swagger u našem sandboxu.

Da biste kreirali aplikaciju za karticu ili plaćanje, morate kreirati korisničke račune i račune.

Istraži sandbox

Imamo sve što možete istražiti. Pješčanik je potpuno izolirano okruženje pješčanika. iz produkcijskog okruženja, tako da slobodno eksperimentišite. Kada budete spremni da pređete na produkciju, razgovarajte sa svojim menadžerom za odnose s klijentima, koji će vam obezbijediti produkcijske akreditive za pristup živom okruženju.

Relevantno za registraciju web događaji vezani za veze

Webkuke su važna komponenta svake integracije sa Cross Riverom. Dok vam API-ji omogućavaju da zatražite podatke na zahtjev, webHooks šalju ažuriranja u realnom vremenu direktno na vaš sistem – eliminirajući potrebu za stalnim ispitivanjem i smanjujući latenciju. U mnogim slučajevima, webHook-ovi su efikasniji i pouzdaniji od samih API-ja, osiguravajući da vaša aplikacija ostane sinhronizirana s kritičnim događajima poput promjena na računu, ažuriranja transakcija i rezultata obrade.

Registrirajte se primiti webdogađaji hook-a. Kada webdogađaji hook se aktiviraju, događaj objekti se šalju registrovanom URLs.

3.2. Kupci i računi

Korak 1
Preuzmite API akreditive

Korak 2
Nabavite pristupni token

Korak 3
Koristi pristupni token

Korak 4
Izgradite Sample App

Kreirajte evidenciju kupca i račun za finansiranje:

Kreirajte zapis o kupcu

Kreirajte depozitni račun

Uplatite sredstva na račun

Kreiraj zapis o kupcu

Prije nego što počnete koristiti usluge Cross Rivera, potrebno je da za svaku od njih kreirate evidenciju korisnika.

vaših kupaca. Proces uvođenja kupaca uključuje kreiranje evidencija kupaca sa relevantnim informacijama o kupcima.

Svi kupci se automatski skeniraju radi usklađenosti s propisima, tako da se morate registrirati za relevantne webspaja događaje za primanje ažuriranja statusa zapisa kupaca.

Zapis o kupcu može biti za bilo koji od Personal or Posao kupci. Nakon registracije, kupac može biti povezan s jednim ili više računa.

Webkuke

Registrirajte se za webkuke. Sljedeće webkuke se koriste:

WebOpis kuke

Core.Customer.Onboarded	Obavještava vas da je kreiran zapis o kupcu
Core.Customer.Ofac.Changed	Obavještava vas da je OFAC status klijenta ažuriran

Core.Customer.PepScan.Chan ged

Nobavještava vas da je PEP status klijenta ažuriran

Exampleof recordcreation

U ovom exampDakle, uključit ćemo Johna Smitha. Prvo, kreirajmo zapis o kupcu. Registriramo Johna kao Personal kupac.

Da biste uključili poslovnog klijenta, prvo kreirajte lični zapis klijenta za njega glavni vlasnik tog poslovanja. Nakon toga, kreirajte poslovnog klijenta i dodajte lični zapis kao stvarnog vlasnika.

1 Zovi POST /core/v1/cm/kupci .

U sljedećem prampkoje možete vidjeti su obavezni. Koji atributi

VAŽNO

Preporučujemo da u zaglavlje zahtjeva uključite ključ idempotentnosti.

kako bi se obezbijedila dupla zaštita u slučaju kvara.

Curl

curl -X POST /core/v1/cm/kupci –zaglavlje 'Vrsta sadržaja: aplikacija/j {

 "ID partnera": “6e80b097-693c-4592-8440-02f345335bbf”,

 "ime": {

 "Ime": "Džon",

 "Prezime": "Smith"

 },

 "klasifikacija": "Lično",

 “profile": {

 "regO": lažno,

 "Politički eksponirana osoba": lažno,

 "Vrsta poreznog ID-a": "Matični broj socijalnog osiguranja",

 "poreski broj": “119988776”,

 "Datum rođenja": “1953-09-22”,

 "Ocjena rizika": „Nisko“

 "Primarna adresa": {

 "Vrsta adrese": “Kuća”,

 "klasifikacija": "Stambeno",

 "jePrimarno": istina,

 "ulica1": "123 Any St",

 "grad": "Bilo gdje",

 "država": "NY",

 "Poštanski broj": “12345”,

 "Kod države": “SAD”

 },

 "PrimarniTelefon": {

 "jePrimarno": istina,

 "Vrsta telefona": “Kuća”,

 "Broj telefona": “2015551234”

 },

 "Primarna e-pošta": {

 "jePrimarno": istina,

 "Vrsta e-pošte": "Lično",

 "E-mail adresa": „John.Smith@xxxxx.com“

 }

}

Uspješan API poziv vraća JSON odgovor s jedinstvenim ID-om kupca u prvom redu tijela odgovora. Vaš kupac je kreiran.

Uvođenje tijela za odgovore kupaca

{

 "ID": “9052b6a5-3f09-41d1-b526-ade80104eb79”,

 "cifBroj": “32653745014”,

 "klasifikacija": "Lično",

 "status": “Aktivan”,

 "ofac": "Na čekanju",

 "pepScan": "Na čekanju",

 "ime": {

 "Ime": "Džon",

 "Prezime": "Smith",

 "Puno ime": "Džon Smit"

 },

 “profile": {

 "regO": false,

 "Politički eksponirana osoba": false,

 "omogući zadržavanje rezervnih kopija": false,

 "Vrsta poreznog ID-a": "Matični broj socijalnog osiguranja",

 "poreski broj": “119988776”,

 "Datum rođenja": “1953-09-22”,

 "Ocjena rizika": „Nisko“

 },

 "kreirano u": “2021-01-25T17:55:24.4422582-05:00”,

 "Posljednja izmjena u": “2021-01-25T17:55:24.4432543-05:00”,

 "ID partnera": “6e80b097-693c-4592-8440-02f345335bbf”

}

2 The Core.Customer.Onboarded webDogađaj hook se aktivira kada se kreira zapis o kupcu.

Događaj upoznavanja korisnika

{

 "ID": “3d9c5e1a-623b-4cf2-812e-ade80105048e”,

 "NazivDogađaja": "Osnovno.Kupac.Uključen",

 "status": "Na čekanju",

 "ID partnera": “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 "kreirano u": “2021-11-22T10:50:20.553-05:00”,

 "resursi": [

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

 "detalji": []

}

Cross River skenira nove podatke o kupcima radi usklađenosti sa OFAC i PEP propisima.

Ponekad rezultati skeniranja zahtijevaju ponovnoview od strane našeg tima za sprečavanje pranja novca (AML).

Po završetku skeniranja, Core.Customer.Ofac.Changed i

Core.Customer.PepScan.Changed webDogađaji hook-a se vraćaju sa statusom. Korisnici bez problema sa usklađenošću pokazuju Jasno status.

Promijenjeno je skeniranje OFAC-a korisnika

{

 "ID": “45db5592-56ee-41f5-85e7-ade8010571ce”,

 "NazivDogađaja": "Osnovni.Kupac.Ofac.Promijenjen",

 "status": "Na čekanju",

 "ID partnera": “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 "kreirano u": “2021-11-22T10:51:53.657-05:00”,

 "resursi": [

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

 "detalji": []

}

PEP skeniranje kupca je promijenjeno

{

 "ID": “a5000831-3e01-4231-9ec2-ade8010571c5”,

 "NazivDogađaja": "Osnovno.Kupac.PepScan.Promijenjeno",

 "status": "Na čekanju",

 "ID partnera": “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 "kreirano u": “2021-11-22T10:51:53.597-05:00”,

 "resursi": [

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

 "detalji": []

}

Sada ste kreirali zapis o kupcu.

Ažuriraj zapis korisnika

Moguće je ažurirati podatke o kupcu kao što su adresa, broj telefona i e-mail. Ovi podaci se smatraju primarni informacije. Ako dodate drugu adresu, ovo je sekundarno.

1 Koristite ID kupca vraćen prilikom kreiranja zapisa kupca za pozivanje POST /core/v1/cm/kupci/{id}/adrese da biste dodali . Prva adresa kupca

adresa koju dodajete je primarni adresa. U sljedećem primjeruampmožete vidjeti koji su atributi potrebni.

Ažuriranje adrese kupca

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

 "Vrsta adrese": “Kuća”,

 "klasifikacija": "Stambeno",

 "jePrimarno": istina,

 "ulica1": "123 Any St",

 "grad": "Bilo gdje",

 "država": "NY",

 "Poštanski broj": “12345”,

 "Kod države": “SAD”

}

2 Zovi POST /core/v1/cm/kupci/{id}/telefoni da dodate

telefon korisnika

Prvi broj telefona koji dodate je primarni broj telefona.

broj

Ažuriranje broja telefona kupca

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

 "jePrimarno": istina,

 "Vrsta telefona": "Mobilni",

 "Broj telefona": “2015552345”

}

3 Zovi POST /core/v1/cm/customers/{id}/email ažurirati e-mail adresu kupca.

Ažuriranje e-pošte kupca

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

 "jePrimarno": istina,

 "Vrsta e-pošte": "Lično",

 "E-mail adresa": „john.jones@xxx.com“

}

Kreirajdepozitniračun

CR nudi niz različitih vrsta računa, uključujući čekovne i štedne račune, depozitne certifikate (CD-ove ili račune oročenog depozita) i još mnogo toga.

Da biste otvorili bilo koju vrstu depozitnog računa, morate imati važeći ID proizvoda za vrstu računa koju želite otvoriti i ID korisnika (registrirani ID korisnika) za vlasnika računa. Imajte na umu da vlasnik računa mora imati barem jednu adresu i broj telefona u svom korisničkom dosijeu, a njegov OFAC status mora biti JasnoOsim toga, klasifikacija kupca mora odgovarati konfiguriranoj klasifikaciji za proizvod. Na primjeramptj. samo poslovni korisnici mogu biti dodani poslovnom proizvodu.

Prije nego što počnete

Pobrinite se da imate:

API akreditivi

ID partnera (koji ste dobili prilikom registracije)

ID klijenta

ID proizvoda (definiše vrstu računa koji se otvara)

VAŽNO

Preporučujemo da u zaglavlje zahtjeva uključite ključ idempotentnosti. kako bi se spriječilo dupliciranje plaćanja u slučaju kvara.

Krajnje tačke i webkuke

Koristi se sljedeća API krajnja tačka:

API opis

Otvorite depozitni račun Otvara depozitni račun za klijenta

Sledeće webkuka se koristi:

WebOpis kuke

Osnovni.Račun.Otvoren Otvoren je novi račun

Otvori račun

U sljedećem scenariju, otvorit ćete račun za Johna Smitha, kupca kojeg ste uspješno registrirali.

Otvoriti račun

1 Zovi POST core/v1/dda/accounts Za ovaj poziv potrebni su neki atributi. Pogledajte cijeli .

lista atributa

Sample request

POST /core/v1/dda/accounts

{

 "ID kupca": “59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 "ID proizvoda": “44015e68-1afb-40fc-9497-abc1014f52da”,

 "naslov": "Džon Smit",

 "Adresa izjave": {

 "ulica1": "257 Dalton Groves",

 "grad": "Barton City",

 "država": "MI",

 "Poštanski broj": “48705”,

 "Kod države": “SAD”

 }

}

2 Uspješan API poziv vraća JSON odgovor s detaljima novog računa.

Sample response

POST /jezgro/v1/ugovor o distribuciji (dda)/računi

{

 "ID kupca": “59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 "ID proizvoda": “44015e68-1afb-40fc-9497-abc1014f52da”,

 "naslov": "Džon Smit",

 "Adresa izjave": {

 "ulica1": "257 Dalton Groves",

 "grad": "Barton City",

 "država": "MI",

 "Poštanski broj": “48705”,

 "Kod države": “SAD”

 }

}

3 The Broj računa polje sadrži broj računa za novi račun.

4 U odgovoru examptj. račun je klasifikovan kao Personal jer je korisnik konfigurirao klasifikaciju proizvoda kao PersonalKlasifikacija računa uvijek odgovara konfiguriranoj klasifikaciji proizvoda.

5 Status računa se automatski ažurira na Aktivan , i odmah je dostupan za upotrebu. Ovo aktivira Osnovni.Račun.Otvoren događaj.

Detalji događaja Core.Account.Opened

{

 "ID": “259cdbca-6a89-4af8-a50e-ada3010fb13f”,

 "NazivDogađaja": "Osnovni.Račun.Otvoren",

 "status": "Na čekanju",

 "ID partnera": “e6c3824a-377f-44d5-a2f6-a9a600c9b37e”,

 "kreirano u": “2021-01-26T09:48:10.1011462-05:00”,

 "resursi": [

 „core/v1/dda/accounts/2235223803“

 ],

 "detalji": []

}

Fundanaccount

Kada radite u sandboxu kako biste testirali načine plaćanja i ponašanje računa, potrebno je da imate sredstva na računu.

Možete koristiti bilo koju željeznicu koja ima ulaznu krajnju tačku simulacije za finansiranje sandbox računa, ako je račun konfigurisan za to. Konkretno, možete:

Simulirajte dolazne ACH uplate

Simulirajte dolazni žični signal

Za bilo koju simulaciju, potreban vam je broj Cross River sandbox računa na koji želite uplatiti sredstva. Podaci o osnivaču nisu važni, a u nekim slučajevima mogu biti čak i potpuno izmišljeni.

Sljedeći koraci

Provjerite našu uplatu.

tutoriali

3.3. Karte

Korak 1
Preuzmite API akreditive

Korak 2
Nabavite pristupni token

Korak 3
Koristi pristupni token

Korak 4
Izgradite Sample App

Upoznajte se s načinom rada s Cross River API-jima. Ova stranica vam pokazuje kako:

Kreiraj karticu

Aktivirajte karticu

Kreiraj karticu

Upravljajte karticama svojih kupaca tako što ćete sarađivati ​​sa Cross Riverom kako biste odlučili šta želite da ponudite, kao što su fizičke ili virtuelne kartice. Ovo je konfiguracija karticeCross River kreira profesionalca za konfiguraciju karticafile za vas za svaku vrstu koju odaberete za svoj finansijski instrument kupaca.

Prije nego počnete

Pobrinite se da imate i da imate:

Kreirajte zapis o kupcu

Kreirajte depozitni račun

Broj računa vlasnika kartice

ID kupca (dobićete ga kada kreirate kupca)

ID konfiguracije (Cross River vam daje ID kada konfigurirate svoj tip/karticu)

Također vam preporučujemo da za relevantne webdogađaji hook-a. registrujte se

Krajnje tačke iwebkuke

Registrirajte se za webkuke. Koriste se sljedeće API krajnje tačke:

API opis

Kreiraj novu karticu Zahtjev za kreiranje nove debitne kartice

Sledeće webkuke se koriste:

WebOpis kuke

Kartice.Kartica.Kreirana Debitna kartica je kreirana

Orderacard

Naučit ćete kako naručiti/kreirati novu debitnu karticu kreiranjem kartice za Johna Smitha.

1 Zovi POST /upravljanje karticama/v1/kartice .

U sljedećem prampMožete vidjeti koji su atributi potrebni. Pogledajte detalje o kompletnom API-ju.

Dodaj karticu

Sampkreirajte karticu

curl -X POST /upravljanje karticama/v1/kartice –zaglavlje 'Vrsta sadržaja: aplikacija „broj računa“: „2608927303“, \  

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

 „Id konfiguracije“: „a6b5a94c-f8f9-462b-8ce8-afa400f5b640“, \ „Ime“: „John“, \  

 "Prezime": "Smith", \  

 "telefon": { \  

 „Vrsta telefona“: „Kućni“, \  

 "Broj telefona": "9133413131"  

 }, \  

 „e-mail adresa“: „John.Smith@xxxxx.com“, \  

 "Adresa za dostavu": { \  

 „ulica1“: „Lane Ave“, \  

 „ulica2“: „niz znakova“, \  

 „grad“: „Veliki grad“, \  

 „država“: „IL“, \  

 „poštanski broj“: „72410“, \  

 "Kod države": "SAD" \  

 }, \  

 "Adresa za naplatu": { \  

 „ulica1“: „Lane Ave“, \  

 „ulica2“: „niz znakova“, \  

 „grad“: „Veliki grad“, \  

 „država“: „IL“, \  

 „poštanski broj“: „72410“, \  

 "Kod države": "SAD" \  

 }, \  

 „imeNaKarti“: „John Smith“, \  

 „Vrsta dostave“: „Normalna“, \  

 „Identifikator klijenta“: „niz“ \  

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

2 Uspješan API poziv vraća JSON odgovor s detaljima nove kartice. Status kartice neće biti aktiviran dok je ne aktivirate. ID je ID kartice, u ovom slučaju example 8709163d-140c-4d95-a111-afa8009e9cd1, što će vam trebati aktivirati karticu.

Sampodgovor na narudžbu kartice

{

 "ID": “8709163d-140c-4d95-a111-afa8009e9cd1”,  "ID partnera": “cd9c12f4-7691-424a-b38b-af5b0134c611”,  "ID proizvoda": “83bed086-8182-4151-a1e3-af5b01362783”,  "Broj računa": “2608927303”,

 "status": "Neaktivirano",

 "KodRazlogaStatusa": "Nije postavljeno",

 "Ime": "Džon",

 "Prezime": "Smith",

 "Adresa za dostavu": {

 "ulica1": "Lane Ave",

 "ulica2": "niz",

 "grad": "Veliki grad",

 "država": "IL",

 "Poštanski broj": “72410”,

 "Kod države": “SAD”

 },

 "Adresa za naplatu": {

 "ulica1": "Lane Ave",

 "ulica2": "niz",

 "grad": "Veliki grad",

 "država": "IL",

 "Poštanski broj": “72410”,

 "Kod države": “SAD”

 },

 "telefon": {

 "Vrsta telefona": “Kuća”,

 "Broj telefona": “9133413131”

 },

 "E-mail adresa": „john@anygoogle.com“,

 "imeNaKarti": "Džon Smit",

 "isPinSet": false,

 "adminBlokiran": false,

 "Osumnjičeni za prevaru": false,

 "Id konfiguracije": “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  "kategorija": "Kredit",

 "Instrument plaćanja": "VirtualPan",

 "procesor": "Naziv procesora",

 "Vrsta dostave": “normalno”,

 "Status narudžbe": "Narudžba na čekanju",

 "Status zamjene": "Nije primjenjivo",

 "ID kupca": “2b15a695-13dc-4b10-b4e5-af5b0138873c”,  "Identifikator klijenta": "niz",

 "kreirano u": “2023-02-13T04:37:29.4869172-05:00”,

 "Posljednja izmjena u": “2023-02-13T04:37:29.4869172-05:00”

}

3 The Kartice.Kartica.kreirana webDogađaj hook se aktivira kada se kartica generiše u procesoru.

SampDogađaj Cards.Card.Created

{

 "ID": “cea6c5b5-13e7-4c2f-ba75-afce01110fe5”,

 "NazivDogađaja": "Karte.Kartica.Kreirana",

 "status": "Na čekanju",

 "ID partnera": “cd9c12f4-7691-424a-b38b-af5b0134c611”,

 "kreirano u": “2023-02-13T04:42:29.4869172-05:00”,

 "resursi": [

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

 "detalji": [

 {

 "ID kartice": “8709163d-140c-4d95-a111-afa8009e9cd1”,

 "status": "Neaktivirano",

 "KodRazlogaStatusa": "Nije postavljeno"

 }

 ]

}

Aktiviraj karticu

Prije nego što počnete

Pobrinite se da imate:

API akreditivi

ID kartice iz trenutka kada ste naručili karticu

Krajnje tačke iwebkuke

API opis

POST /cardmanagement/v1/cards/{id}/activate Aktivira karticu koristeći ID kartice. U tutorijalu se koriste ove funkcije. webkuke:

WebOpis kuke

Kartice.Kartica.Aktivirana Debitna kartica aktivirana

Aktiviraj karticu

Aktivirajte karticu koju ste kreirali u stage.

kreiraj karticu

1 Zovi POST /cardmanagement/v1/cards/{id}/activate . The id Atribut mora biti postavljen na ID kartice. U sampIspod ID-a je 8709163d-140c-4d95-a111 afa8009e9cd1.

Sampzahtjev za aktivaciju kartice

curl -X POST  

–zaglavlje 'Prihvati: aplikacija/json'

–zaglavlje 'Autorizacija: Nosilac'<token>'

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

2 Uspješan API poziv vraća JSON odgovor s detaljima kartice. Kartica status je sada aktiviran. The Status narudžbe is Završeno.

Sampodgovor na aktivaciju kartice

{

 "ID": “8709163d-140c-4d95-a111-afa8009e9cd1”,  "ID partnera": “cd9c12f4-7691-424a-b38b-af5b0134c611”,  "ID proizvoda": “83bed086-8182-4151-a1e3-af5b01362783”,  "IdProcesorskeKartice": “804951250206718”,

 "Broj računa": “2608927303”,

 "status": “Aktivan”,

 "KodRazlogaStatusa": "Nije postavljeno",

 "Ime": "Džon",

 "Prezime": "Smith",

 "Adresa za dostavu": {

 "ulica1": "Lane Ave",

 "ulica2": "niz",

 "grad": "Veliki grad",

 "država": "IL",

 "Poštanski broj": “72410”,

 "Kod države": “SAD”

 },

 "Adresa za naplatu": {

 "ulica1": "Lane Ave",

 "ulica2": "niz",

 "grad": "Veliki grad",

 "država": "IL",

 "Poštanski broj": “72410”,

 "Kod države": “SAD”

 },

 "telefon": {

 "Vrsta telefona": “Kuća”,

 "Broj telefona": “9133413131”

 },

 "E-mail adresa": „john@anygoogle.com“,

 "imeNaKarti": "Džon Smit",

 "panLastFour": “3629”,

 "isPinSet": false,

 "Datum isteka": “2026-02-13”,

 "adminBlokiran": false,

 "Osumnjičeni za prevaru": false,

 "Id konfiguracije": “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  "kategorija": "Kredit",

 "Instrument plaćanja": "VirtualPan",

 "procesor": "Naziv procesora",

 "Vrsta dostave": “normalno”,

 "Status narudžbe": “Završeno”,

 "Status zamjene": "Nije primjenjivo",

 "ID kupca": “2b15a695-13dc-4b10-b4e5-af5b0138873c”,

 "Identifikator klijenta": "niz",

 "IdKupcaProcesora": “T83E9D675A3N3N9O8RZ1”,

 "kreirano u": “2023-02-13T04:37:29.487-05:00”,

 "PočetnaAktivacija": “2023-02-13T00:00:00-05:00”,

 "aktivirano kod": “2023-02-13T04:43:19.282287-05:00”,

 "Posljednja izmjena u": “2023-02-13T04:43:19.2962845-05:00”

}

3 Kada se status kartice promijeni u Aktivan , the Kartice.Kartica.Aktivirana webdogađaj hook se aktivira.

Kartice.Kartica.Aktivirana webdogađaj kuke

{

 "ID": “95ac33ca-3d7f-49aa-bfc2-afce01113310”,

 "NazivDogađaja": "Kartica.Kartica.Aktivirana",

 "status": "Na čekanju",

 "ID partnera": “cd9c12f4-7691-424a-b38b-af5b0134c611”,

 "kreirano u": “2023-02-13T04:44:31.282287-05:00”,

 "resursi": [

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

 "detalji": [

 {

 "ID kartice": “8709163d-140c-4d95-a111-afa8009e9cd1”,

 "status": “Aktivan”,

 "KodRazlogaStatusa": "Nije postavljeno"

3.4. Pozajmljivanje

Korak 1
Preuzmite API akreditive

Korak 2
Nabavite pristupni token

Korak 3
Koristi pristupni token

Korak 4
Izgradite Sample App

Kreditiranje uključuje skup poziva koji vam omogućavaju kreiranje, ažuriranje i upravljanje API-jem za kreditiranje. vaše kredite.

Da biste započeli saradnju s kreditima, provjerite sljedeće:

Primite API akreditive sa opsezima potrebnim za kreditiranje

Ako ste kreirali API vjerodajnice, koristeći samostalno upravljanje

, onda biste trebali poslati i zahtjev na

arix.support@crossriver.com

Org, zajedno sa vašim klijentskim ID-om i MPLID-om, da biste dovršili stvaranje.

Koristite ispravan opseg za API-je koje želite koristiti.

API opseg za sandbox je: CosLending:PreApproval:stg

Sandbox

Baza modula URL za API pozive Opis

Zajam porijeklo

Odlučivanje o prijavi

https://arixapisandbox.crbnj. net	Baza URL za API pozive za odobravanje kredita prema Arix sandbox okruženju
https://lendingsandbox.crbco s.com/preapproval/v1	Baza URL za pješčanik od odlučivanje o prijavi

Swagger

Modul Swagger Link

API reference dokumentaciju	https://arixapisandbox.crbnj.net/swagger-ui
Kuke	https://lendingsandbox.crbcos.com/hooks/swagger/inde x.html

Prodaje se https://lendingsandbox.crbcos.com/selling/swagger/inde x.html

StatusPage

Da biste vidjeli listu nadolazećih izdanja, pratite trenutni status API-ja, view izvještaje o incidentima ili primajte obavještenja o planiranom održavanju, posjetite našu stranicu sa statusom i pretplatite se na obavještenja.

4. Podešavanje programa

Postavljanje SFTP-a: Koristite SFTP za slanje fileili da ih preuzmete sa Cross Rivera, u skladu sa vašim i našim potrebama.

Uvođenje korisnika: Upravljajte informacijama o svojim kupcima u Cross Riveru operativni sistem (COS) koristeći API-je ili COS Explorer

Vrste i ID-ovi COS proizvoda: Objašnjenje vrsta i ID-ova COS proizvoda.

COS istraživač: Kako raditi s našim COS Explorerom.

Portal za upravljanje organizacijama: Kako raditi s našim portalom za upravljanje organizacijama.

4.1. Postavljanje SFTP-a

Kada trebate razmijeniti osjetljive informacije u file formatu s Cross Riverom, zahtijevamo da koristite Secure File Protokol za prijenos (SFTP). Koristite SFTP za slanje fileili da ih preuzmete sa Cross Rivera, u skladu sa vašim i našim potrebama. U nekim slučajevima, vi ili mi ćemo ih šifrirati files, posebno ako sadrže bilo kakve lične identifikacijske podatke (PII).

Korištenje SFTP-a

SFTP vam omogućava sigurno slanje i primanje osjetljivih filei izvještaje koristeći mapu dodijeljenu posebno vašem poslovanju na sigurnom serveru. Otpremite i preuzmite filekroz tu mapu ili podmape te mape, prema vašim specifičnim potrebama.

Korištenje šifriranja

Šifriranje files dodaje dodatni sloj zaštite. Samo ovlašteno osoblje s ispravnim ključem moći će dešifrirati šifrirani fileU Cross Riveru koristimo PGP enkripciju.

Započnite

Postoji nekoliko koraka za pokretanje i korištenje našeg SFTP servera.

1 Popunjavate obrazac Zahtjev za IP pristup za Cross River SFTP usluge (iz vašeg RM-a).

Ako trebate podijeliti fileU slučaju saradnje s Cross Riverom, vaš menadžer za odnose s klijentima će vam poslati obrazac Zahtjev za IP pristup za CRB SFTP usluge. Između ostalih informacija, potrebno je da navedete statičke javne IP adrese koje ćete koristiti za pristup SFTP mapi i javni PGP ključ za šifriranje i dešifriranje. filePošaljite popunjeni obrazac nazad svom menadžeru za odnose s klijentima

VAŽNO

Cross River će vam staviti na listu dozvoljenih samo 5 IP adresa, zato uzmite to u obzir. IP adrese moraju biti statične. Stoga, sve što nije statičko morate proksirati na svojoj strani.

2 Postavili smo vašu strukturu SFTP foldera.

Nakon što Cross River dobije vaše podatke, naš IT inženjerski odjel kreira standardni set foldera i podfoldere za vas. Ova jedinstvena putanja je samo za vaše poslovanje. Nijedan drugi partner joj ne može pristupiti. IT inženjering vam šalje e-poruku s informacijama potrebnim za pristup folderima. E-poruka sadrži link do vaših podataka o vjerodajnicama. Cross River ne sprema vašu lozinku!

VAŽNO

Link vrijedi samo nekoliko dana, nakon čega ćete morati zatražiti resetiranje lozinke ako ga ne koristite.

Akreditivi također postaju nevažeći ako više od dvije osobe pristupe linku..

3 Testni SFTP upload.

Ako ćete snabdijevati filedo Cross Rivera, vaš IT odjel treba da postavi servisni račun sa automatizovanim procesom za otpremanje tih podataka. fileu vaše SFTP mape. Preporučujemo da ovo testirate prije nego što pokušate poslati stvarne podatke. Za sva pitanja ili probleme obratite se svom menadžeru za odnose s klijentima ili otvorite tiket kod vaše prve linije podrške.

4 Podesite PGP za slanje ili primanje fileiz Cross Rivera. (Ovaj korak je potreban samo ako šaljete ili primate lične podatke. Molimo provjerite sa svojim RM-om.)

Ako trebate poslati Cross River files, prvo ćemo vam poslati naš PGP javni ključ za korištenje u šifriranju tih files.

Trebali ste već poslati Cross Riveru svoj PGP javni ključ da biste ga primili fileod nas.

5 Podijelite svoje podatke.

Nakon što je vaša SFTP mapa postavljena i vaš proces završen, možete započeti s dijeljenjem files nama. Vaš menadžer za odnose s klijentima će vam reći da li postoji nešto konkretnije što trebate učiniti da biste primali izvještaje ili kako pripremiti podatke koje ćete nam poslati.

Specifični izvještaji

Saznajte više o pripremi i slanju izvještaja i files za:

Računi i plaćanja

Plaćanja karticama

Kreditni rizik

Pozajmljivanje

XML grupna plaćanja (ISO 20022)

4.2. Uvođenje korisnika

Upravljajte informacijama o svojim klijentima u operativnom sistemu Cross River (COS) koristeći API-je ili . Ove informacije uključuju osnovne podatke potrebne za otvaranje bankarskog COS Explorera.

račun ili koristiti kreditnu karticu, kao i specifičnije podatke o kupcu, po potrebi. Ovo nazivamo evidencija kupaca.

Prije nego što otvorite depozitni račun ili kreirate karticu, morate kreirati evidenciju klijenta, ponekad nazvanu onboardingZatim možete dodijeliti jednog ili više kupaca računu putem odjeljka za kupce odnosima.

Proces uvođenja kupaca uključuje kreiranje relevantnog zapisa o kupcima. informacije o kupcima. Slijedite ovaj vodič da biste za svakog od vas kreirali evidenciju kupaca.

Opcionalni koraci

Dodajte detalje o identifikaciji

Dodajte stvarnog vlasnika

Kodovi grešaka

Pogledajte, zajedno s mnogim drugim referentnim informacijama, o kodovima grešaka COS COS sistema

stranica s referentnim kodovima.

4.2.1. Zapis o kupcima

Zapis o kupcima

Zapis o kupcu je primarni resurs koji sadrži informacije o kupcima u Cross River sistemu. Stoga, prije kreiranja računa za kupca, morate ga registrovati. Zapis o kupcu podržava klasifikacije tipa Lično ili Poslovni. Nakon registracije, možete povezati kupca s jednim ili više računa.

BivšiampDonji grafikon prikazuje kako se registruje kupac za ličnog kupca.

Zahtjev za osobu na brodu

POST /core/v1/cm/kupci {

 "ID partnera": “7cc038be-fde9-4455-b27b-1497cf667362”,

 "ime": {

 "prefiks": "Gospodin.",

 "Ime": "Džon",

 "Srednje ime": "Robert",

 "Prezime": "Smith",

 "sufiks": "Mlađi",

 "PreferiranoNaziv": "Džim" },

 "klasifikacija": "Lično",

 “profile": {

 "regO": lažno,

 "državljanstvoKodZemlje": “SAD”,

 "Politički eksponirana osoba": lažno,

 "omogući zadržavanje rezervnih kopija": lažno,

 "Procenat zadržavanja rezerve": 0,

 "Vrsta poreznog ID-a": "Matični broj socijalnog osiguranja",

 "poreski broj": “123456789”,

 "Datum rođenja": “1965-09-15”,

 "Ocjena rizika": „Nisko“,

 "Isključivanje iz privatnosti": istina }

} Uključite poslovnog klijenta kao što je korporacija ili LLC koristeći istu krajnju tačku sa malo drugačijim atributima.

Curl

POST /core/v1/cm/kupci {

 "ID partnera": “a24cba49-2bb6-431d-a867-1de81d6e4127”,

 "ime": {

 "NazivEntiteta": "ACME CO", },

 "klasifikacija": "Posao",

 “profile": {

 "državljanstvoKodZemlje": “SAD”,  

 "omogući zadržavanje rezervnih kopija": lažno,

 "Procenat zadržavanja rezerve": 0,  

 "Vrsta poreznog ID-a": "Ein",

 "poreski broj": “123456789”,

 "Datum formiranja": “2019-09-10”,

 "Vrsta entiteta": "Korporacija",

 "Ocjena rizika": „Nisko“,

 "Vrsta vlasništva": "Pravni entitet",

 "PrimarniVlasnikIdKupca": “f9321f7f-3712-46e1-b965-2b79ead64dc9”, } }

Bez obzira da li se radi o registraciji privatnog ili poslovnog korisnika, primarni vlasnik ID kupca Atribut mora sadržavati ID kupca koji se odnosi na zapis kupca tipa Lično. Dakle, da biste uključili preduzeće, prvo morate kreirati lični zapis kupca za primarnog vlasnika tog preduzeća.

VAŽNO

Neke krajnje tačke korisnika uključuju due diligence resurs koji može, ali i ne mora biti potreban prilikom uvođenja privatnih klijenata. Vaša dodijeljena osoba za usklađenost komunicira zahtjeve za sva polja dubinske analize tokom vašeg procesa uvođenja.

Stvarni vlasnici

Stvarni vlasnik je osoba koja posjeduje 25% ili više udjela u preduzeću. Iz regulatornih razloga, potrebno je da obezbijedite resurse u Posao kreiranje korisničkog računa o klijentu

za svakog stvarnog vlasnika tog poslovanja. vlasnik/korisnik Atribut se odnosi na lični zapis klijenta za svakog stvarnog vlasnika. Obično dodajete resurse stvarnog vlasnika u zapis poslovnog klijenta odmah nakon uključivanja preduzeća u poslovanje.

Curl

POST /core/v1/cm/customers/{customerId}/beneficial-owners {

 "vlasnikIdKupca": “c1210a2d-932e-43ca-be29-f358a4382385”,

 "Vlasnik/Naziv": "Predsjednik" }

Adresa

Fizičke adrese povezane s kupcem mogu biti .

ažurirano

Curl

POST /core/v1/cm/kupci/{kuponikaId}/adrese

{

 "jePrimarno": istina,

 "status": “Aktivan”,

 "klasifikacija": "Stambeno",

 "Vrsta adrese": “Kuća”,

 "ulica1": "Javorova ulica 123",

 "ulica2": "Apartman 12",

 "ulica3": “”,

 "grad": “Njujork”,

 "država": "NY",

 "Poštanski broj": “10025”,

 "Kod države": “SAD”,

}

E-mail adrese

Ažurirajte email

kontakt informacije za kupca.

Curl

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

 "jePrimarno": istina,

 "Vrsta e-pošte": "Lično",

 "E-mail adresa": „john.smith@crossriver.com“ }

Telefoni

Ažuriraj telefon Curl

kontakt informacije za kupca.

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

{

 "Vrsta telefona": “Kuća”,

 "jePrimarno": istina,

 "Broj telefona": “2015551234”

}

Identifikacije

Identifikacije se koriste za praćenje metapodataka za dokumente koji identificiraju kupce, kao što su vozačke dozvole i pasoši. Mogu se koristiti za dodavanje novih podataka o identifikaciji. Dodajte podatke o identifikaciji.

Curl

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

 "jePrimarno": istina,

 "Broj identifikacije": "DL123456789",

 "Vrsta ID-a": "Vozačka dozvola",

 "Datum izdavanja": “2018-08-30”,

 "Datum isteka": “2018-08-30”,

 "VerifikovaniDatum": “2018-08-30”,

 "Izdavateljski organ": "Odjel za motorna vozila New Jerseyja",

 "DržavaIliPokrajinaIzdavanja": "NJ",

 "KodZemljeIzdavanja": “SAD”,

}

4.2.2. Vrste i ID-ovi COS proizvoda

U Cross Riveru, a tip proizvoda je jedinstveno konfigurisan finansijski proizvod koji nudite svojim klijentima. Na primjerampTj. tip proizvoda može biti debitna kartica ili štedni račun, konfigurisan prema vašim potrebama i specifikacijama. Otvarate račune za svoje kupce pod bilo kojim tipom proizvoda koji definirate i konfigurišete zajedno s nama. Za više detalja, uključujući i kako postaviti tipove proizvoda za svoje kupce, obratite se svom menadžeru za odnose s klijentima.

Za nprampNa primjer, možda biste željeli konfigurirati vrstu proizvoda kao proizvod štednog računa koji koristi bankovne transfere i ACH plaćanja. Zatim možete ponuditi svojim klijentima štedne račune s ovim uslugama i konfiguracijama.

Cross River vam pruža ID proizvoda za svaku vrstu proizvoda koju želite ponuditi svojim kupcima. Da biste otvorili bilo koju vrstu depozitnog računa, morate imati važeći ID proizvoda i ID kupca (registrirani ID zapisa kupca) za vlasnika računa. Imajte na umu da vlasnik računa mora imati barem jednu adresu i broj telefona u svom zapisu kupca, a njegov OFAC status mora biti JasnoOsim toga, klasifikacija kupca mora odgovarati konfiguriranoj klasifikaciji za proizvod. Na primjeramptj. samo poslovni korisnici mogu biti dodani poslovnom proizvodu.

4.2.3. COS istraživač

Nakon što se prijavite u Cross River sistem i primite e-poruku s informacijama o registraciji

tvoj ID klijenta i Tajna Spremni ste za prijavu u COS Explorer. Pristupite COSExplorer portalu

Proizvodnja:

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

Pješčanik:

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

Dobrodošli e-mail

Primit ćete e-poruku dobrodošlice od CrossRiver_DO_NOT_REPLY@crossriver.comAko ga ne vidite u pristigloj pošti, provjerite neželjenu poštu ili mape za blokiranu poštu.

Kliknite Kreirajte svoj Cross River račun.

Ako u bilo kojem trenutku napustite čarobnjaka, kliknite na vezu u originalnoj e-poruci da biste se vratili tamo gdje ste stali.

Uslovi i odredbe

Pročitajte uslove i odredbe, provjerite Prihvatii kliknite Sledeći.

Verifikacija putem SMS-a (tekstualne poruke)

Šaljemo vam SMS (tekstualnu poruku) na vaš uređaj kako bismo potvrdili vaš identitet. Unesite 6-cifreni kod koji ste primili na ekranu za prijavu i kliknite Potvrdi kod.

Kreirajte svoju lozinku

1. Unesite lozinku koja ispunjava zahtjeve na ekranu i ponovo je unesite. 

2. Kliknite Kreirajte lozinku.

Postavljanje aplikacije za autentifikaciju

Morate dovršiti ovaj korak kako biste nastavili proces registracije i mogli se prijaviti u budućnosti.

Da bismo zaštitili vaš identitet, vaš račun i podatke, zahtijevamo da se prijavite pomoću višefaktorske/dvofaktorske autentifikacije.

Ako već nemate aplikaciju za autentifikaciju na svom uređaju, morate je preuzeti prije nego što nastavite.

Za Android i iOS preporučujemo korištenje aplikacije za autentifikaciju:

Google Authenticator

Microsoft autentifikator

Nakon što instalirate aplikaciju za autentifikaciju, potrebno je da uradite sljedeće: skenirajte QR kod or ručno unesite ključ u aplikaciju za autentifikaciju.

QRcode

1. Skenirajte QR kod u aplikaciji za autentifikaciju i, ako je potrebno, unesite 6-cifreni kod na stranici za višefaktorsku autentifikaciju.

2. Kliknite na nastavak.

Manual

1. Kliknite Prikaži ključ

2. Kopirajte ključ kao Tajna u vašoj aplikaciji za autentifikaciju.

3. Unesite četveroznamenkasti kôd.

4. Kliknite Nastavi.

Nevažeći MFA kod

Ako unesete nevažeći MFA kod, crvena poruka vas obavještava da pokušate ponovo.

Ups! Unijeli ste nevažeći MFA kod. Evo nekoliko stvari koje trebate provjeriti:

1. Da li je isteklo vrijeme koda prije nego što ste kliknuli NastaviPreostalo vrijeme je označeno krugom za odbrojavanje desno od naziva računa i MFA koda.

2. Ako imate aplikaciju za autentifikaciju postavljenu za više okruženja ili aplikacija, dvaput provjerite jeste li unijeli ispravan kod.

1. Ako iz naziva MFA veza nije jasno koja je ispravna opcija, možda ćete morati isprobati različite kodove dok ne pronađete onaj koji radi.

2. Kada pronađete ispravnu vezu, možete preimenovati MFA vezu u aplikaciji. Ikona olovke na vrhu ekrana MFA aplikacije će vas dovesti u način uređivanja. U nekim aplikacijama ćete prvo morati odabrati (ili pritisnuti i držati) vezu koju treba urediti, a zatim će se pojaviti ikona.

3. Kada ste u načinu uređivanja, možete preimenovati veze po potrebi kako bi bilo jasno koja se odnosi na koje okruženje.

4. Sačuvajte sve promjene i sljedeći put bi trebalo biti lakše razumjeti koji kod koristiti.

Kodovi za oporavak

Koristite kodove za oporavak za autentifikaciju u slučaju gubitka uređaja.

1. Preuzmite ili kopirajte svoje kodove za oporavak i čuvajte ih na sigurnom mjestu koje ćete zapamtiti.

2. Potvrdite da ste sačuvali svoje kodove za oporavak

3. Kliknite Kreirajte nalog.

Stranica s kodovima za oporavak ističe nakon 10 minuta.

Kodove za oporavak možete preuzeti samo jednom.

Vaš račun je sada aktivan i možete ga koristiti za prijavu na bilo koju od vaših CR aplikacija.

Lista dozvoljenih IP adresa

Za pristup COS Exploreru može se koristiti samo statička IP adresa. Obratite se podršci za vašu IP adresu ako vam je potrebna pomoć u vezi s ovim.

IP adrese Identity Servera su:

172.67.26.222 104.22.40.134 104.22.41.134

Server je proxyiran putem Cloudflare-a.

Možete dozvoliti ove FQDN-ove:

idptest.crbcos.com

Rješavanje problema

Zaboravljena lozinka

1. Kliknite Zaboravili ste lozinku? i unesite svoju email adresu.

2. Unesite 6-cifreni autentifikacijski kod iz aplikacije za autentifikaciju. 3. Dobijate a Zaboravili ste lozinku e-mail. Kliknite Poništi lozinku.

4. Na stranici za resetiranje lozinke unesite novu lozinku, kliknite Poništi lozinku, i Nastavite na aplikaciju.

Resetuj višefaktorsku autentifikaciju

Ako već imate konfiguriran MFA:

1. U Identity Serveru idite na Resetiraj MFA i kliknite Resetujte MFA uređaj. 2. Otvara se stranica za višefaktorsku autentifikaciju i možete resetirati svoju MFA.

Također možete kreirati nove kodove za oporavak višefaktorske autentifikacije.

1. Kliknite kreirajte nove kodove za oporavak višefaktorske autentifikacije.

2. Otvara se stranica Kodovi za oporavak i možete kopirati ili preuzeti svojih 10 novih kodova za oporavak.

Ako još niste konfigurirali višefaktorsku autentifikaciju, MFA možete omogućiti iz Postavke računa.

1. Kliknite Resetiraj MFA metodu.

2. Kliknite Konfiguriraj MFA.

3. Slijedite upute u odjeljku Višefaktorska autentifikacija/Autentifikacija u 2 koraka.

Ako je vaša trenutna MFA SMS, možete je omogućiti pomoću aplikacije za autentifikaciju. Postavke računa

1. Kliknite Resetiraj MFA metodu.

2. Kliknite Konfiguriraj MFA.

3. Slijedite upute u odjeljku Višefaktorska autentifikacija/Autentifikacija u 2 koraka.

Koristite kod za oporavak

Ako nemate pristup svom višefaktorskom (2-faktorskom) autentifikatoru, možete se prijaviti pomoću jednog od svojih kodova za oporavak.

1. Prijavite se kao i obično

2. Na stranici Višefaktorska autentifikacija imate mogućnost korištenja koda za oporavak kao opcije autentifikacije.

3. Unesite jedan od vaših kodova za oporavak u tekstualno polje. Kod za oporavak je za jednokratnu upotrebu i ne može se ponovo koristiti. Da biste izbjegli buduću zabunu, preporučujemo da označite kod za oporavak kao korišten.

Zaključavanje računa

Ako 5 puta unesete pogrešnu lozinku za svoje korisničko ime, sistem će zaključati vaš račun na otprilike 5 minuta. Ako nakon 5 minuta i dalje ne možete pristupiti svom računu, kontaktirajte podršku Cross Rivera.

Greška preglednika - Zaštitni zid

Prijavljujete se u COS Explorer i dobijate sljedeći ekran sa greškom:

Blokiran/a si zaštitnim zidom/zaštitnim zidom.

1. Obratite se svom internom IT odjelu da provjerite da li vaša organizacija primjenjuje pravila zaštitnog zida (firewall) za odlazni promet. Ako ne postoje pravila zaštitnog zida za odlazni promet, onda:

2. Kontaktirajte svoj interni IT odjel kako biste bili sigurni da se povezujete na Cross River COS Explorer portal s odobrene IP adrese. Ako trebate registrirati više IP adresa, pošaljite e-poruku COS podršci.

4.2.3.1. Upravljanje korisnicima

Upravljanje korisnicima

Možete koristiti Korisnici ekran od Admin Pritisnite tabulator da biste grupirali skup resursa, kao što su kupci, proizvodi i računi. Nakon što vam je resurs (tj. proizvod ili kupac) dodijeljen, ne može se promijeniti.

Ovaj prostor možete koristiti za podršku i unošenje promjena za vaše kupce. Možemo vam dodijeliti 2 administratorska korisnika kako biste mogli kreirati korisnike po potrebi za svoje kupce. Ovo vam daje nezavisnost u upravljanju vašim kupcima i omogućava vam da vršite promjene izvan radnog vremena, na njihov zahtjev.

Također možete kreirati ili registrirati nove korisnike.

Kreiraj novog korisnika

1 U Admin karticu, kliknite Korisnici da otvorite Korisnici ekran za pretragu. 2 Kliknite + Novi korisnik. The Kreiraj korisnika prikazi na ekranu.

3 In Kreiraj korisnika unesite korisnikov Email, zatim se prikazuju sljedeća polja Ime, Prezime i Broj telefona.

4 Kliknite Status i odaberite Aktivan.

The Broj telefona Polje mora biti broj mobilnog telefona jer će se ovo koristiti za MFA za autentifikaciju korisnika.

Opis polja

Ime	Korisničko ime. Unesite puno korisničko ime koje će se prikazati u prozoru preglednika kada se korisnik prijavi u Explorer.
Email	E-mail adresa korisnika. Ova adresa se koristi za prijavu u Explorer, a služi i kao e-mail adresa za oporavak prilikom resetiranja lozinke.
Status	Odaberite status korisnika. Status korisnika je Neaktivan po zadanim postavkama. Promijenite to u Aktivan prilikom kreiranja korisnika.
Tip korisnika	Ovo polje se prikazuje Partner kada se korisnik kreira.
Uloge	Odaberite uloge koje želite dodati korisniku ili kliknite Uključi sve uloge da biste korisniku dodali sve dostupne uloge. Napomena: Bit će vidljive samo uloge koje su vam dodijeljene. Neke uloge sadrže dozvole koje vam omogućavaju da vršite plaćanja u Exploreru. Vaši administratori Explorera odgovorni su za osiguravanje da su vaši korisnici ispravno konfigurirani samo s odgovarajućim korisničkim ulogama, kao i ovlaštenim ograničenjima.

Ovlašteni limiti

Za svako polje odaberite ograničenje u dolarima (ako je primjenjivo)

5 Kliknite Status i odaberite Aktivan.

6 Kliknite Uloge i odaberite kojem želite dodijeliti novog korisnika. Kliknite Sačuvaj uloge Promjene.

Sve korisnici moraju biti konfigurirani sa Samo za partnerski Core uloga.

Ako je korisniku dodijeljeno Porijeklo partnerskog bankovnog transfera uloga koju morate konfigurirati za ograničenje pojavljivanja tog korisnika.

7 Ako korisniku dodjeljujete Porijeklo partnerskog bankovnog transfera ulogu, unesite vrijednost u Bankovna.Plaćanja.Originate polje za označavanje maksimalnog limita u dolarima po transferu. U suprotnom, možete zanemariti ovo polje.

8 Kada završite s konfigurisanjem svih polja, kliknite Sačuvaj promjene.

9 Ako ste uspješno kreirali novog korisnika, prikazat će se ekran za potvrdu. 

10 Da bi se dovršilo dodavanje i konfiguracija korisnika, mora biti uključen drugi administrator Odobri promjene.

11 The Odobri promjene na čekanju ekran se prikazuje. Kliknite Potvrdi. 

12 Viewinformacije o korisniku

Dokumenti / Resursi

Platforma Cross River API [pdf] Korisnički priručnik API platforma, API platforma, platforma

Reference

• Uputstvo za upotrebu