
API Platform
Mimitian
1. Wilujeng sumping
ANYAR! Palang Walungan publik kalawan requests pre-diwangun pikeun kumpulan Palang tukang pos
Walungan. titik tungtung API
Wilujeng sumping di Palang Walungan dokuméntasi
Panggihan, jelajah sareng mimitian ngahijikeun produk urang kalayan gampang
Quickstart Jelajah sadaya produk
Meunang dimimitian
Nyetél tur mimitian Anjeun perjalanan ngagunakeun API Palang Walungan
Konsép
Panggihan kumaha solusi Cross River tiasa ngarobih perjalanan fintech anjeun
API
Ngembangkeun ngagunakeun perbankan Palang Walungan
platform sareng set API anu kuat
Tutorial
Diajar kumaha ngagunakeun Cross
Walungan API step by step
2. Mimitian gancang
Lengkah 1
Lengkah 2
Lengkah 3
Lengkah 4
Kéngingkeun Token Aksés
Paké Aksés Token
Ngawangun Sampjeung App
Meunang kredensial API: Léngkah munggaran anjeun pikeun damel sareng Cross River API nyaéta ngadaptar pikeun kredensial API.
Kéngingkeun token aksés: Sakali anjeun nampi kredensial API anjeun sareng sateuacan anjeun tiasa nganggo API kami, anjeun kedah nampi token aksés nganggo id_klien jeung klien_rahasia anjeun nampi nalika anjeun ngadaptar.
Paké token aksés: Sakali anjeun geus hasil dioténtikasi, an access_token dipulangkeun ka anjeun. Lebetkeun token ieu dina lulugu telepon API anjeun.
Webkait: Webhook mangrupakeun komponén penting tina sagala integrasi jeung Palang Walungan. Nalika API ngamungkinkeun anjeun nyuhunkeun data upami diperyogikeun, webhooks nyorong apdet sacara real-time langsung ka sistem anjeun-ngaleungitkeun kabutuhan polling konstan sareng ngirangan latency.
Lingkungan sandbox: Kotak pasir mangrupikeun lingkungan anu terasing, janten raos bébas
2.1. Meunang kredensial API
Lengkah 1
Meunang kredensial API
Lengkah 2
Kéngingkeun Token Aksés
Lengkah 3
Paké Aksés Token
Lengkah 4
Ngawangun Sampjeung App
Léngkah munggaran anjeun pikeun damel sareng Cross River API nyaéta ngadaptar pikeun kredensial API. Kalayan kredensial ieu anjeun tiasa nyuhunkeun sareng nampi token aksés pikeun dianggo pikeun ngirim API di lingkungan kotak pasir kami.
PENTING
Alamat IP anjeun, anu kedah umum sareng statik, kedah aya dina daptar anu diidinan. Departemén IT internal anjeun kedah tiasa masihan anjeun IP ieu. Diajar langkung seueur ngeunaan IP statik.
SandboxAccess
Nepikeun pamundut pikeun aksés sandbox, pikeun nampa Kapercayaan API.
Sakali IP statik anjeun ditambahkeun kana daptar anu diidinan, kami bakal ngirim anjeun 2 email énkripsi sareng kredensial anjeun:
Hiji email ngandung anjeun id_klien , id_pasangan sareng inpormasi sanésna anu anjeun peryogikeun gumantung kana naon anu dipénta.
Email kadua, anu énkripsi, ngandung anjeun klien_rahasia jeung webhook_rusiah . Anjeun peryogi ieu pikeun auténtikasi sareng damel di kotak pasir.
CATETAN
Upami anjeun naroskeun aksés ka Pangmayaran Kartu, anjeun bakal nampi sakumpulan kredensial tambahan kalebet sadetik id_klien jeung klien_rahasia
2.2. Kéngingkeun token aksés
Lengkah 1
Meunang kredensial API
Lengkah 2
Kéngingkeun Token Aksés
Lengkah 3
Paké Aksés Token
Lengkah 4
Ngawangun Sampjeung App
Cross River ngagunakeun OAuth 2.0 pikeun auténtikasi sareng otorisasina. Ieu ngadalikeun éntri kana sistem kami sareng mastikeun yén ngan éntitas anu otorisasi tiasa ngaksés API kami sareng sumber daya anu ditangtayungan sanés. Inpormasi anu anjeun lebetkeun kana sistem auténtikasi kami rahasia sareng henteu tiasa diaksés tina aplikasi Cross River anu sanés.
Sakali anjeun nampi , sareng sateuacan anjeun tiasa nganggo API kami, anjeun kedah nampi kredensial API token aksés ngagunakeun éta id_klien jeung klien_rahasia anjeun nampi nalika anjeun ngadaptar. Token aksés ieu ngamungkinkeun anjeun pikeun ngirim inpormasi sacara aman salaku objék JSON pikeun dianggo dina API kami. Anjeun kedah ngalebetkeun token ieu dina lulugu unggal pamundut API.
Aya sababaraha cara pikeun nyuhunkeun sareng nampi token aksés:
Paké Komando Line Interface (CLI) kalawan cURL atawa basa séjén
Anggo tukang pos atanapi alat uji API anu sanés
Sakali dicandak, salin token aksés ka clipboard anjeun. Pastikeun anjeun simpen.
CommandLineInterface
Pikeun ménta hiji token ngirim a POST nyambungkeun / token paréntah ngandung éta id_klien jeung klien_rahasia jeung hibah_tipe ka (server auth) tina server auténtikasi sandbox luyu, ditémbongkeun saperti dina sample handap.
Rujuk kana katerangan ngeunaan ieu tags. tabel komponén HTTP
Ex di handapampngagunakeun cURL pikeun menta token ti salah sahiji server auth.
Sample pamundut di cURL pikeun COS
curl –lokasi –request 'POST https://idptest.crbcos.com/connect/token' \ -header 'Tipe-Tipe: aplikasi/x-www-formulir-urldisandi' \ –data-urlencode 'client_id=[id anjeun di dieu]' \
-data-urlencode 'client_secret=[rahasia anjeun di dieu]' \
-data-urlencode 'grant_type=client_credentials' \
-data-urlencode 'penonton=https://api.crbcos.com/'
Sampréspon ti cURL pamundut
{ "access_token": "ngandung seueur karakter", \
"kadaluwarsa_di": 86400, \
"token_type": "Pembawa" }
Tukang pos
Pikeun ménta token maké tukang pos, kirimkeun a POST nyambungkeun / token paréntah ka auth server tina sandbox nu luyu. Tambahkeun ka hibah_tipe , lingkup (opsional) ,
id_klien jeung klien_rahasia kana panggero.
Rujuk kana katerangan ngeunaan ieu tags. tabel komponén HTTP
Upami auténtikasi suksés, kode statusna 200 (OK).
COSExplorer
Dina , klik panah handap gigireun login anjeun sarta klik Salin Token Aksés. COS Explorer
Token aksés ditiron kana clipboard anjeun, siap dianggo dina file . Sandbox
réspon pamundut token
Katerangan Atribut
|
aksés_ka ken |
JSON anu ditandatanganan sacara digital web token (JWT) dikirim ti server oAuth anu ngamungkinkeun aksés ka sumberdaya husus Palang Walungan |
|
wengkuan |
Sajumlah jasa anu tiasa diaksés ku pangguna |
|
expires_i n |
Jumlah waktos dugi token tamat. - Tim Integrasi kami bakal nginpokeun ka anjeun ngeunaan waktos béakna atanapi anjeun ogé tiasa nga-decode token aksés anjeun. - Kami ngarékoméndasikeun yén anjeun nyandak token aksés énggal sakedap sateuacan token lami parantos kadaluwarsa. - Paké deui token pikeun sakabéh umur maranéhanana tinimbang meunang token anyar pikeun tiap nelepon ka sumberdaya nu ditangtayungan sarua (API). PENTING: Pernah decode token anjeun dina hosted umum websitus |
tipe token
Token pamawa
komponén HTTP
Komponén HTTP di handap ieu dipaké duanana dina requests API jeung tukang pos.
HTTP
komponén
Tag Katerangan
|
Titik tungtung |
POST /nyambung/toké n |
Endpoint pikeun retrieving hiji token aksés |
|
lulugu |
eusi ngetik |
aplikasi/x-www-formulir- urldisandikeun |
|
Awak |
id_klien |
Identifier unik pikeun klien |
|
Awak |
klien_rahasia t |
Hiji string énkripsi karakter dipaké pikeun asup jeung sangkan méré konfirmasi token ID. penting: Rahasia teu tiasa pulih ku CR. Lamun leungit hiji rusiah, nu anyar kudu dihasilkeun. Entong bunuh rusiah anjeun kana kontrol sumber. |
|
Awak |
hibah_tipe |
widang ieu bakal salawasna mibanda nilai client_credentials |
|
Awak |
panongton pilihan |
Hiji cara pikeun pamaké pikeun sangkan méré konfirmasi lamun token aksés husus dimaksudkeun pikeun aranjeunna. |
|
Awak |
wengkuan pilihan |
Kisaran khusus atanapi sakumpulan jasa kawates anu tiasa diaksés ku pangguna nganggo token aksés. Upami wengkuan teu ditangtukeun, token anu dipulangkeun bakal ngandung sadaya wengkuan anu aya hubunganana sareng kredensial anjeun. Catetan: Sababaraha lingkup bisa dikirim dina pamundut sarua ku nambahkeun spasi antara ngaran unggal lingkup. Pikeun example: 'wengkuan = scope1 scope2 scope3' |
AuthserverURLs
server Auth modul URL
|
Rekening |
https://idptest.crbcos.com/connect/token |
|
ACH |
https://idptest.crbcos.com/connect/token |
|
Kawat |
https://idptest.crbcos.com/connect/token |
|
Cék |
https://idptest.crbcos.com/connect/token |
|
Inti |
https://idptest.crbcos.com/connect/token |
|
pangmayaran instan |
https://idptest.crbcos.com/connect/token |
|
ngaluarkeun kartu |
https://idptest.crbcos.com/connect/token |
|
pangmayaran kartu |
https://crbcos-sandbox.auth0.com/oauth/token |
Nginjeum https://oauthtest.crbnj.net/connect/token
Pamérésan masalah
Upami token auténtikasi sah, éta bakal ngabalikeun 200. Upami token auténtikasi henteu valid, éta bakal ngabalikeun 401.
Upami anjeun henteu tiasa nampi token pembawa sareng anjeun teu acan nampi anu kapungkur:
Konfirmasi dina URL.
Pariksa yén id_klien jeung klien_rahasia diketik leres. Aranjeunna sénsitip kasus.
Pariksa anjeun id_klien jeung klien_rahasia ngalawan hiji anjeun nampi. Pastikeun teu aya masalah jaringan atanapi daptar anu diidinan.
Hubungi kami upami akun anjeun dikonci salaku hasil tina 3 log salah dina Tim Integrasi usaha.
2.3. Paké token aksés
Lengkah 1
Meunang kredensial API
Lengkah 2
Kéngingkeun Token Aksés
Lengkah 3
Paké Aksés Token
Lengkah 4
Ngawangun Sampjeung App
Sakali anjeun parantos suksés, token aksés dipulangkeun ka anjeun. Kaasup dioténtikasi token ieu dina lulugu tina panggero API Anjeun.
Token aksés kadaluwarsa saatos sababaraha waktos. Tanggapan anu ngandung token ogé nangtukeun waktos béakna dina detik. Simpen sareng nganggo token aksés anjeun dugi ka béakna. Kami ngarékoméndasikeun anjeun nganggo token dugi ka nampi kasalahan 401 anu teu sah, teras nyuhunkeun token énggal.
PENTING
1. Ulah menta token anyar pikeun unggal pamundut API.
2. Pastikeun ngajaga token anjeun. Saha waé anu nyolong token anjeun tiasa nyamar klien anjeun salami umur token.
requestheader API
Dina lulugu unggal pamundut API, lebetkeun token aksés sapertos kieu:
Sample nelepon pikeun pembayaran kawat dina cURL
curl –location –request 'POST https://sandbox.crbcos.com/Wires/v1/payments' –header 'Otorisasi: Panyandang [TOKEN ANDA IEUH]' \
-header 'Tipe-Tipe: aplikasi/x-www-formulir-urldisandi' \
-data-atah ‘{
"Nomer rekening": "2255685659",
"businessFunctionCode": "CTR",
"ReceiverRoutingNumber": "021000021",
"penerima manfaat": {
"Kode ID": "F",
"identifier": "021000021",
"Ngaran": "JP Morgan Chase"
},
"penerima": {
"idCode": "D",
"identifier": "123456789",
"Ngaran": "Peter Griffin"
},
"BeneficiaryReference": "XYZ123",
"Jumlah": 10000,
"tujuan": "pembayaran"
}'
Tukang pos
Pikeun ngagunakeun token dina tukang pos, arahkeun ka Otorisasina tab dina pamundut anjeun, pilih Pembawa Token salaku jinis auténtikasi, sareng témpél token anjeun kana widang anu disayogikeun. Tukang pos otomatis bakal nambahan Pamawa awalan jeung token ka Token sawah.
2.4. Webkait
Webhook mangrupakeun komponén penting tina sagala integrasi jeung Palang Walungan. Nalika API ngamungkinkeun anjeun nyuhunkeun data upami diperyogikeun, webkait nyorong apdet sacara real-time langsung ka sistem anjeun ngaleungitkeun kabutuhan polling konstan sareng ngirangan latency. Dina loba kasus, webhook langkung efisien sareng dipercaya tibatan API nyalira, mastikeun aplikasi anjeun tetep sinkron sareng acara kritis sapertos perobihan akun, apdet transaksi, sareng hasil ngolah.
Paké webkait dina sistem Palang Walungan pikeun ngabéjaan lamun kajadian béda lumangsung. Acara ngabalikeun objék sumberdaya anu ngandung detil anu relevan ngeunaan subyek unggal acara. Rincian acara lengkep kalebet sareng dikirim ka sistem anjeun.
Urang make webhook pikeun ngapdet anjeun dina status jeung ngalaporkeun parobahan urus. WebHooks ngalaporkeun ka sistem anjeun kalayan béwara sacara real-time nalika aya kajadian.
Anjeun kudu ngadaptar via API ngagunakeun webkait:
Ngadaptar pikeun akun, kartu na acara pamayaran
Ngadaptar pikeun acara pangmayaran kartu
Ngadaptar pikeun acara Lending
2.5. Lingkungan sandbox
Kotak keusik kami mangrupikeun lingkungan anu terasing, janten bebas ékspérimén. Nalika anjeun siap ngalih ka produksi, wartosan kami sareng kami bakal kéngingkeun kredensial produksi anjeun pikeun ngaksés lingkungan langsung.
manajemén customer
Dasar modul URL pikeun panggero API
Manajemén palanggan https://sandbox.crbcos.com/core/ Rekening
Dasar modul URL pikeun panggero API
Rekening deposit
|
https://sandbox.crbcos.com/core/ |
Sapuan deposit https://sandbox.crbcos.com/sweepsintrafi/ Kartu
Dasar modul URL pikeun panggero API
Kartu https://sandbox.crbcos.com/cardmanagement/Pangmayaran
Dasar modul URL pikeun panggero API
|
Pamayaran instan |
https://sandbox.crbcos.com/rtp/ |
|
pangmayaran kartu: Dorong mayar |
https://pushtopaystaging.crbnj.net/ |
|
Pangmayaran kartu: Tarik |
https://pullfromcardapistg.crbnj.net/ |
|
Pangmayaran internasional |
https://sandbox.crbcos.com/international/ |
|
ACH |
https://sandbox.crbcos.com/ach/ |
|
Kawat |
https://sandbox.crbcos.com/wires/ |
Cék https://sandbox.crbcos.com/checks/ COSwebkait
Dasar modul URL pikeun panggero API
COS webkait
https://sandbox.crbcos.com/webhooks/
Nginjeum
Dasar modul URL pikeun panggero API
Asal injeuman
|
https://arixapisandbox.crbnj.net |
Kaputusan Aplikasi https://lendingsandbox.crbcos.com/preapproval/v1
2.6. Koléksi tukang pos
Pikeun nyieun pangwangunan leuwih gampang, kami geus nunda babarengan a kalawan pre-diwangun
Koléksi tukang pos requests pikeun sakabéh Palang Walungan. Anggo koleksi ieu pikeun ngajalajah, nguji, sareng ngawangun titik tungtung API integrasi anjeun langsung di tukang pos. kalawan minimal coding tambahan sarta setelan diperlukeun. Pikeun geuwat garpu koleksi urang, klik
Cukup lengkepkeun detil setelan, sareng mimitian nelepon dina kumpulan Sandbox Postman ngaliwatan .
Tukang pos
Aksés (bearer)token
Kami parantos nyiptakeun lingkungan sandbox pamekar Postman pikeun nyayogikeun rohangan anu aman pikeun nguji API Cross River. Dina kumpulan Palang Walungan tukang pos, Anjeun ngalakukeun auténtikasi maké token bearer.
Pikeun kéngingkeun KTP anjeun kedah nyetél token aksés (pembawa) anu diperyogikeun pikeun ngajalankeun koleksi:
1. : Kalawan Kapercayaan ieu anjeun menta tur nampa hiji token aksés
Meunang kredensial API
dipaké pikeun ngirim API di lingkungan sandbox urang
2. : Sakali anjeun nampi Kapercayaan API anjeun sarta saméméh anjeun tiasa nganggo kami
Kéngingkeun token aksés
API, anjeun meunang token aksés ngagunakeun id_klien jeung klien_rahasia anjeun nampi nalika anjeun ngadaptar.
Kumpulan garpu Palang Walungan
Langsung ka kami pikeun garpu koleksi kami.
Rohangan tukang pos
Sakali garpu, tong hilap nyetél variabel lingkungan anjeun pikeun kotak pasir.
Konpigurasikeun lingkungan Posmanén anjeun
Pikeun nganggo koleksi anu anjeun damel, arahkeun ka dinya, klik Lingkungan, tur pilih Sandbox. Nyalin ID klien Palang Walungan anjeun sarta klien rusiah, jeung nempelkeun kana klien_id jeung klien_rahasia sawah. Pikeun Pamayaran Kartu, témpélkeun kana ptpe_client_id jeung ptpe_client_secret sawah.
Ayeuna anjeun parantos siap kéngingkeun token sareng ngawitan ngirim pamundut.
1. Lumpat Otorisasina / Kéngingkeun token pikeun ngahasilkeun token Anjeun. Pikeun Pamayaran Kartu, ngajalankeun Pamayaran Kartu / Otorisasina / Kéngingkeun token P2PE .
2. variabel {{token}} (atawa ptpe_token pikeun Pangmayaran Kartu) ditambahkeun sacara otomatis ka lingkungan anjeun ku skrip pos reponse. Nalika token kadaluwarsa anjeun kedah nuturkeun lengkah 1 deui.
3. Aya sababaraha variabel anu anjeun kedah ngeusian gumantung kana titik akhir anu anjeun lakukeun. Pikeun example, id_pasangan , id_produk , konfigurasi_id jeung telepon balik_url .
4. Aya ogé sababaraha variabel anu dieusi ku naskah, sapertos token jeung ptpe_token anu henteu kedah dieusi sacara manual.
Pingthesandbox
Jalankeun tés basajan pikeun pariksa yén anjeun tiasa nyambung ka kotak pasir Cross River.
Pikeun ngirim pamundut Ping, dina Postman buka Koléksi> Koléksi API Palang Walungan> Otorisasina sarta ngajalankeun éta Ping titik tungtung.
Modify requests
Pikeun ngapdet pamundut, jieun perobahan anjeun dina Awak tab. Nilai dina ganda curly kurung narik tina variabel lingkungan Anjeun. Pariksa kami ningali widang mana unggal docs API
titik tungtung narima, jeung view pamundut dina basa pikaresep Anjeun.
3. Ngawangun salakuampaplikasi na
Lengkah 1
Meunang kredensial API Disetél
Lengkah 2
Kéngingkeun Token Aksés
Lengkah 3
Paké Aksés Token
Lengkah 4
Ngawangun Sampjeung App
: Sateuacan Anjeun ngamimitian, tingal pituduh mimiti gancang urang pikeun nyambung ka API urang. Pikeun nguji sauran API, anjeun tiasa nganggo cURL tina garis paréntah, atanapi jasa sapertos Postman atanapi Swagger dina kotak pasir kami.
Konsumén jeung rekening
: Sateuacan Anjeun nganggo jasa Palang Walungan, anjeun kudu nyieun hiji catetan customer pikeun tiap konsumén Anjeun
Kartu
: Atur kartu palanggan anjeun ku gawé bareng Cross River pikeun mutuskeun naon anu anjeun hoyong nawiskeun, sapertos kartu fisik atanapi virtual.
Nginjeum
: Pinjaman kalebet sakumpulan sauran API pinjaman pikeun ngamungkinkeun anjeun nyiptakeun, ngapdet, sareng ngatur pinjaman anjeun.
3.1. Disetél
Sateuacan anjeun ngamimitian, tingal pituduh kami pikeun nyambung ka API kami. Pikeun nguji API quickstart
nelepon, anjeun tiasa nganggo cURL tina garis paréntah, atanapi jasa sapertos Postman atanapi Swagger dina kotak pasir kami.
Pikeun nyieun kartu atanapi aplikasi pamayaran, anjeun kedah nyiptakeun palanggan sareng akun.
Ngajalajah sandbox
Urang geus pinuh pikeun anjeun ngajajah. Sandbox mangrupikeun lingkungan kotak pasir anu terasing ti lingkungan produksi, jadi ngarasa bébas ékspérimén. Nalika anjeun siap ngalih ka produksi, ngobrol sareng manajer hubungan anjeun, anu bakal masihan anjeun kredensial produksi pikeun ngaksés lingkungan langsung.
Ngadaptar relevan web acara hook
Webhook mangrupakeun komponén penting tina sagala integrasi jeung Palang Walungan. Nalika API ngamungkinkeun anjeun nyuhunkeun data upami diperyogikeun, webhooks nyorong apdet sacara real-time langsung ka sistem anjeun- ngaleungitkeun kabutuhan polling konstan sareng ngirangan latency. Dina loba kasus, webhook langkung efisien sareng dipercaya tibatan API nyalira, mastikeun aplikasi anjeun tetep sinkron sareng acara kritis sapertos perobihan akun, apdet transaksi, sareng hasil ngolah.
Ngadaptar pikeun nampa webacara hook. Iraha webacara hook dipicu, acara objék dikirim ka didaptarkeun URLs.
3.2. Konsumén jeung rekening
Lengkah 1
Meunang kredensial API
Lengkah 2
Kéngingkeun Token Aksés
Lengkah 3
Paké Aksés Token
Lengkah 4
Ngawangun Sampjeung App
Jieun catetan palanggan sareng akun anu dibiayaan:
Jieun rékaman customer
Jieun rekening deposit
Dana hiji akun
Jieun catetan palanggan
Sateuacan Anjeun nganggo jasa Palang Walungan, anjeun kedah pikeun tiap hiji nyieun rékaman customer
konsumén Anjeun. Prosés onboarding customer ngawengku nyieun a catetan customer kalawan informasi customer relevan.
Sadaya palanggan sacara otomatis diseken pikeun tujuan patuh pangaturan, janten anjeun kedah ngadaptar pikeun relevan webacara hook pikeun nampa apdet status catetan customer.
Catetan customer tiasa boh Pribadi or Usaha konsumén. Saatos didaptarkeun, palanggan tiasa dikaitkeun sareng hiji atanapi langkung akun.
Webkait
Ngadaptar pikeun webkait. Nyaéta webhook dipaké:
Webhook Katerangan
|
Core.Customer.Onboarded |
Ngabéjaan yén rékaman palanggan parantos didamel |
|
Core.Customer.Ofac.Changed |
Ngabéjaan yén status OFAC palanggan parantos diropéa |
Core.Customer.PepScan.Chan ged
Nnunjukkeun yén status PEP palanggan parantos diropéa
Exampleof recordcreation
Dina ex ieuample, urang bakal onboard John Smith. Kahiji, hayu urang nyieun catetan customer. Kami ngadaptar John salaku a Pribadi konsumén.
Pikeun onboard a customer bisnis, mimiti nyieun rékaman customer pribadi pikeun boga primér tina bisnis éta. Saatos éta, jieun palanggan bisnis sareng tambahkeun catetan pribadi salaku pamilik anu mangpaat.
1 Nelepon POST /inti/v1/cm/palanggan .
Dina ex handapample anjeun tiasa ningali diperlukeun. anu atribut
PENTING
Kami nyarankeun pisan anjeun ngalebetkeun konci idempotensi header pamundut anjeun
pikeun nyadiakeun duplikat panyalindungan dina acara gagal.
Curl
curl -X POST /inti/v1/cm/palanggan –header 'Jenis-Eusi: aplikasi/j {
"Id mitra": “6e80b097-693c-4592-8440-02f345335bbf”,
"ngaran": {
"nami payun": "John",
"nami pengker": “Smith”
},
"klasifikasi": “Pribadi”,
"profile”: {
"regO": palsu,
"Political Exposed Person": palsu,
"taxIdType": "Ssn",
"TaxId": "119988776",
"tanggal lahir": "1953-09-22",
"RiskRating": "Lemah"
"Alamat primér": {
"Tipe alamat": “Imah”,
"klasifikasi": "Parumahan",
"éta primér": leres,
"jalan 1": “123 Jalan Sakur”,
"kota": “Di mana waé”,
"nagara": "NY",
"Kodeu Pos": "12345",
"Code nagara": "AS"
},
"Telepon primér": {
"éta primér": leres,
"Tipe telepon": “Imah”,
"nomer telepon": "2015551234"
},
"Sél primér": {
"éta primér": leres,
"EmailType": “Pribadi”,
"Alamat email": “John.Smith@xxxxx.com”
}
}
Sauran API anu suksés ngabalikeun réspon JSON kalayan ID palanggan anu unik dina baris kahiji badan réspon. customer anjeun geus dijieun.
Onboarding awak respon customer
{
"id": “9052b6a5-3f09-41d1-b526-ade80104eb79”,
"cifNumber": "32653745014",
"klasifikasi": “Pribadi”,
"status": "Aktif",
"fac": "Tunggu",
"pepScan": "Tunggu",
"ngaran": {
"nami payun": "John",
"nami pengker": “Smith”,
"nami lengkep": "John Smith"
},
"profile”: {
"regO": palsu,
"Political Exposed Person": palsu,
"AktifkeunBackupWithholding": palsu,
"taxIdType": "Ssn",
"TaxId": "119988776",
"tanggal lahir": "1953-09-22",
"RiskRating": "Lemah"
},
"diciptakeun": “2021-01-25T17:55:24.4422582-05:00”,
"lastModifiedAt": “2021-01-25T17:55:24.4432543-05:00”,
"Id mitra": “6e80b097-693c-4592-8440-02f345335bbf”
}
2 The Core.Customer.Onboarded webacara hook dipicu nalika rékaman customer dijieun.
Palanggan onboarded acara
{
"id": “3d9c5e1a-623b-4cf2-812e-ade80105048e”,
"Nama acara": "Inti. Pelanggan. Dipasang",
"status": "Tunggu",
"Id mitra": “30dee145-b6a2-4058-8dc3-ac4000dee91f”,
"diciptakeun": “2021-11-22T10:50:20.553-05:00”,
"sumberdaya": [
“core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79” ],
"detil": []
}
Cross River nyeken catetan palanggan anyar pikeun OFAC sareng patuh PEP.
Kadang-kadang hasil scan merlukeun ulang aview ku tim Anti Pencucian Uang (AML).
Nalika scan parantos réngsé, Core.Customer.Ofac.Changed jeung
Core.Customer.PepScan.Changed webacara hook balik kalawan status a. Konsumén kalawan euweuh masalah minuhan némbongkeun a Jelas status.
Palanggan OFAC scan robah
{
"id": “45db5592-56ee-41f5-85e7-ade8010571ce”,
"Nama acara": "Core.Customer.Ofac.Changed",
"status": "Tunggu",
"Id mitra": “30dee145-b6a2-4058-8dc3-ac4000dee91f”,
"diciptakeun": “2021-11-22T10:51:53.657-05:00”,
"sumberdaya": [
“core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79” ],
"detil": []
}
Palanggan PEP scan robah
{
"id": “a5000831-3e01-4231-9ec2-ade8010571c5”,
"Nama acara": "Core.Customer.PepScan.Changed",
"status": "Tunggu",
"Id mitra": “30dee145-b6a2-4058-8dc3-ac4000dee91f”,
"diciptakeun": “2021-11-22T10:51:53.597-05:00”,
"sumberdaya": [
“core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79” ],
"detil": []
}
Anjeun ayeuna geus nyieun rékaman customer.
Ngamutahirkeun catetan konsumén
Kasebut nyaéta dimungkinkeun pikeun ngapdet detil palanggan sapertos alamat, nomer telepon sareng email. rinci ieu dianggap primér inpormasi. Upami anjeun nambihan alamat kadua, ieu sekundér.
1 Paké ID customer balik mun anjeun nyieun rékaman customer mun nelepon POST /inti/v1/cm/palanggan/{id}/alamat pikeun nambahkeun éta. Alamat customer munggaran
alamat anjeun tambahkeun nyaeta primér alamat. Dina ex handapample anjeun tiasa ningali atribut nu diperlukeun.
Ngamutahirkeun alamat palanggan
POST /core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79/addresse {
"Tipe alamat": “Imah”,
"klasifikasi": "Parumahan",
"éta primér": leres,
"jalan 1": “123 Jalan Sakur”,
"kota": “Di mana waé”,
"nagara": "NY",
"Kodeu Pos": "12345",
"Code nagara": "AS"
}
2 Nelepon POST /inti/v1/cm/palanggan/{id}/telepon pikeun nambahkeun éta
telepon konsumén
. Nomer telepon munggaran anu anjeun tambahkeun nyaéta primér nomer telepon.
angka
Apdet nomer telepon customer
POST /core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79/phones {
"éta primér": leres,
"Tipe telepon": "Mobile",
"nomer telepon": "2015552345"
}
3 Nelepon POST /inti/v1/cm/palanggan/{id}/email pikeun ngapdet. email konsumén
Ngamutahirkeun email customer
POST /core/v1/cm/customers/9052b6a5-3f09-41d1-b526-ade80104eb79/email {
"éta primér": leres,
"EmailType": “Pribadi”,
"Alamat email": "john.jones@xxx.com"
}
Jieun rekening deposit
CR nyadiakeun sajumlah tipena béda rekening, kaasup cek jeung tabungan, Sértipikat ti deposit (CD atawa akun deposit waktu), sarta leuwih.
Pikeun muka akun deposit naon waé anjeun kedah gaduh ID produk anu sah pikeun jinis akun anu anjeun hoyong buka, sareng ID palanggan (ID catetan pelanggan onboarded) pikeun anu gaduh akun. Catet yén anu gaduh akun kedah gaduh sahenteuna hiji alamat sareng nomer telepon dina catetan palangganna, sareng status OFAC na kedah aya Jelas. Salaku tambahan, klasifikasi palanggan kedah cocog sareng klasifikasi anu dikonpigurasikeun pikeun produk. Pikeun example, ngan konsumén bisnis bisa ditambahkeun kana produk bisnis.
Sateuacan anjeun ngamimitian
Pastikeun anjeun gaduh:
Kapercayaan API
ID Mitra (anu anjeun nampi nalika anjeun ngadaptar)
ID customer
ID produk (nangtukeun jinis akun anu dibuka)
PENTING
Kami nyarankeun pisan yén anjeun ngalebetkeun konci idempotensi header pamundut pikeun nyegah duplikat pangmayaran bisi gagal.
Titik tungtung na webkait
Titik akhir API ieu dianggo:
Pedaran API
Buka rekening deposit muka rekening deposit pikeun nasabah
Nyaéta webhook dipaké:
Webhook Katerangan
Core.Akun.Dibuka Rekening anyar dibuka
Openanaccount
Dina skenario di handap ieu, anjeun bakal muka akun pikeun John Smith, palanggan anu anjeun junun onboarded.
Toopenanaaccount
1 Nelepon POST inti / v1 / dda / akun .Pikeun panggero ieu, sababaraha atribut diperlukeun. Tempo pinuh.
daptar atribut
Samppaménta éta
POST /inti/v1/dda/akun
{
"Id Pelanggan": “59e3bc15-bbec-4990-88e9-a9a600d3296c”,
"ID produk": “44015e68-1afb-40fc-9497-abc1014f52da”,
"judul": "John Smith",
"Alamat pernyataan": {
"jalan 1": “257 Dalton Groves”,
"kota": "Kota Barton",
"nagara": "MI",
"Kodeu Pos": "48705",
"Code nagara": "AS"
}
}
2 Telepon API anu suksés ngabalikeun réspon JSON kalayan detil akun énggal.
Sample respon
POST /inti/v1/dda/rekening
{
"Id Pelanggan": “59e3bc15-bbec-4990-88e9-a9a600d3296c”,
"ID produk": “44015e68-1afb-40fc-9497-abc1014f52da”,
"judul": "John Smith",
"Alamat pernyataan": {
"jalan 1": “257 Dalton Groves”,
"kota": "Kota Barton",
"nagara": "MI",
"Kodeu Pos": "48705",
"Code nagara": "AS"
}
}
3 The nomer akun widang nyadiakeun nomer akun pikeun akun anyar.
4 Dina respon example, akun digolongkeun kana Pribadi sabab pamaké ngonpigurasi klasifikasi produk salaku Pribadi. Klasifikasi akun salawasna cocog sareng klasifikasi produk anu dikonpigurasikeun.
5 Status akun otomatis diropéa ka Aktif , sarta langsung sadia pikeun pamakéan. Ieu micu nu Core.Akun.Dibuka acara.
Inti.Akun.Dibuka Rincian Acara
{
"id": “259cdbca-6a89-4af8-a50e-ada3010fb13f”,
"Nama acara": "Akun Inti.Dibuka",
"status": "Tunggu",
"Id mitra": “e6c3824a-377f-44d5-a2f6-a9a600c9b37e”,
"diciptakeun": “2021-01-26T09:48:10.1011462-05:00”,
"sumberdaya": [
"inti/v1/dda/akun/2235223803"
],
"detil": []
}
Akun dana
Nalika anjeun damel di sandbox pikeun nguji rel pembayaran sareng kabiasaan akun anjeun kedah gaduh dana dina akun.
Anjeun tiasa make sagala rail nu boga tungtung simulasi inbound pikeun dana hiji akun sandbox, lamun akun ieu ngonpigurasi pikeun eta. Khususna, anjeun tiasa:
Simulate pangmayaran ACH inbound
Simulate hiji kawat inbound
Pikeun simulasi naon waé, anjeun peryogi jumlah akun kotak pasir Palang Walungan anu anjeun hoyong dana. Inpormasi originator henteu penting, sareng dina sababaraha kasus malah tiasa janten fiktif.
Léngkah-léngkah salajengna
Pariksa pembayaran kami.
tutorials
3.3. Kartu
Lengkah 1
Meunang kredensial API
Lengkah 2
Kéngingkeun Token Aksés
Lengkah 3
Paké Aksés Token
Lengkah 4
Ngawangun Sampjeung App
Diajar kumaha dianggo sareng Cross River API. Halaman ieu nunjukkeun anjeun kumaha carana:
Jieun kartu
Aktipkeun kartu
Jieun kartu
Atur kartu palanggan anjeun ku gawé bareng Cross River pikeun mutuskeun naon anu anjeun hoyong tawarkeun, sapertos kartu fisik atanapi virtual. Ieu teh konfigurasi kartu. Cross Walungan nyiptakeun konfigurasi kartu profile pikeun anjeun pikeun unggal jinis anu anjeun pilih pikeun instrumen kauangan anjeun konsumén.
Sateuacan Anjeun ngamimitian
Pastikeun anjeun gaduh sareng gaduh:
Jieun rékaman customer
Jieun rekening deposit
Nomer rekening anu gaduh kartu
ID Palanggan (anjeun kéngingkeun ieu nalika anjeun nyiptakeun palanggan)
ID Konfigurasi (Cross River nyayogikeun ID ka anjeun nalika anjeun ngonpigurasikeun jinis / kartu anjeun)
Kami ogé nyarankeun yén anjeun pikeun relevan webacara hook. ngadaptar
Titik tungtungwebkait
Ngadaptar pikeun webkait. Titik tungtung API di handap ieu dianggo:
Pedaran API
Jieun kartu anyar Requests kreasi kartu debit anyar
Nyaéta webhook dipaké:
Webhook Katerangan
Cards.Card.Created Kartu debit dijieun
Kartu pesenan
Anjeun bakal diajar kumaha carana mesen / nyieun kartu debit anyar. ku nyieun kartu pikeun John Smith.
1 Nelepon POST / manajemén kartu / v1 / kartu .
Dina ex handapample anjeun tiasa ningali atribut nu diperlukeun. Tempo rinci ngeunaan API lengkep.
Tambahkeun kartu
Sample nyieun kartu
curl -X POST / manajemén kartu / v1 / kartu –header 'Content-Type: applicatio "accountNumber": "2608927303", \
“customerId”: “2b15a695-13dc-4b10-b4e5-af5b0138873c”, \
"ConfigurationId": "a6b5a94c-f8f9-462b-8ce8-afa400f5b640", \ "firstName": "John", \
"LastName": "Smith", \
"telepon": {\
"phoneType": "Imah", \
"Nomer Telepon": "9133413131" \
}, \
"emailAddress": "John.Smith@xxxxx.com", \
"Alamat Pangiriman": { \
"jalan 1": "Jalur Jalan", \
"jalan2": "string", \
"Kota": "Kota Besar", \
"state": "IL", \
"Kode Pos": "72410", \
"Code nagara": "AS" \
}, \
"Alamat Penagihan": { \
"jalan 1": "Jalur Jalan", \
"jalan2": "string", \
"Kota": "Kota Besar", \
"state": "IL", \
"Kode Pos": "72410", \
"Code nagara": "AS" \
}, \
"NameOnCard": "John Smith", \
"shippingType": "Normal", \
"clientIdentifier": "string" \
}' 'https://sandbox.crbcos.com/CardManagement/v1/cards'
2 Telepon API anu suksés ngabalikeun réspon JSON kalayan detil kartu énggal. Status kartu bakal dinonaktipkeun dugi ka anjeun ngaktipkeun kartu. id nyaeta ID kartu, dina ieu example 8709163d-140c-4d95-a111-afa8009e9cd1, anu anjeun peryogikeun ngaktipkeun kartu éta.
Sample urutan respon kartu
{
"id": “8709163d-140c-4d95-a111-afa8009e9cd1”, "Id mitra": “cd9c12f4-7691-424a-b38b-af5b0134c611”, "ID produk": “83bed086-8182-4151-a1e3-af5b01362783”, "nomer akun": "2608927303",
"status": "Teu diaktipkeun",
"StatusReasonCode": "NotSet",
"nami payun": "John",
"nami pengker": “Smith”,
"Alamat Pangiriman": {
"jalan 1": "Jalur Jalan",
"jalan 2": "tali",
"kota": “Kota gedé”,
"nagara": "IL",
"Kodeu Pos": "72410",
"Code nagara": "AS"
},
"Alamat Penagihan": {
"jalan 1": "Jalur Jalan",
"jalan 2": "tali",
"kota": “Kota gedé”,
"nagara": "IL",
"Kodeu Pos": "72410",
"Code nagara": "AS"
},
"telepon": {
"Tipe telepon": “Imah”,
"nomer telepon": "9133413131"
},
"Alamat email": "john@anygoogle.com",
"NamiOnCard": "John Smith",
"isPinSet": palsu,
"admin diblokir": palsu,
"Tersangka panipuan": palsu,
"ConfigurationId": “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”, "kategori": "Kredit",
"Instrumén pembayaran": "VirtualPan",
"prosessor": "Ngaran prosesor",
"Jenis pengiriman barang": “Biasa”,
"Status pesenan": "Pesanan Ditunda",
"Status ngagantian": "Henteu tiasa dianggo",
"Id Pelanggan": “2b15a695-13dc-4b10-b4e5-af5b0138873c”, "clientIdentifier": "tali",
"diciptakeun": “2023-02-13T04:37:29.4869172-05:00”,
"lastModifiedAt": “2023-02-13T04:37:29.4869172-05:00”
}
3 The Cards.Card.created webacara hook dipicu nalika kartu dihasilkeun dina processor.
Sample Cards.Card.Created acara
{
"id": “cea6c5b5-13e7-4c2f-ba75-afce01110fe5”,
"Nama acara": "Cards.Card.Created",
"status": "Tunggu",
"Id mitra": “cd9c12f4-7691-424a-b38b-af5b0134c611”,
"diciptakeun": “2023-02-13T04:42:29.4869172-05:00”,
"sumberdaya": [
“cardmanagement/v1/cards/8709163d-140c-4d95-a111-afa8009e9cd1” ],
"detil": [
{
"Id kartu": “8709163d-140c-4d95-a111-afa8009e9cd1”,
"status": "Teu diaktipkeun",
"StatusReasonCode": "NotSet"
}
]
}
Aktipkeun kartu
Sateuacan anjeun ngamimitian
Pastikeun anjeun gaduh:
Kapercayaan API
ID kartu ti nalika anjeun maréntahkeun kartu
Titik tungtungwebkait
Pedaran API
POST /cardmanagement/v1/cards/{id}/activate Aktipkeun kartu maké ID kartu Tutorial ngagunakeun ieu webkait:
Webhook Katerangan
Cards.Card.Diaktipkeun Kartu debit diaktipkeun
Aktipkeun kartu
Aktipkeun kartu anjeun dijieun dina stage.
nyieun kartu
1 Nelepon POST /cardmanagement/v1/cards/{id}/activate . The id atribut kudu disetel ka ID kartu. Dina sample handap ID téh 8709163d-140c-4d95-a111 afa8009e9cd1.
Sample Aktipkeun pamundut kartu
curl -X POST
–header 'Tampa: aplikasi/json'
–header 'Otorisasina: Pembawa'<token>'
https://sandbox.crbcos.com/CardManagement/v1/cards/8709163d-140c-4d95-a1
2 Telepon API anu suksés ngabalikeun réspon JSON kalayan detil kartu. Kartu status ayeuna diaktipkeun. The OrderStatus is Réngsé.
Sample Aktipkeun respon kartu
{
"id": “8709163d-140c-4d95-a111-afa8009e9cd1”, "Id mitra": “cd9c12f4-7691-424a-b38b-af5b0134c611”, "ID produk": “83bed086-8182-4151-a1e3-af5b01362783”, "ProcessorCardId": "804951250206718",
"nomer akun": "2608927303",
"status": "Aktif",
"StatusReasonCode": "NotSet",
"nami payun": "John",
"nami pengker": “Smith”,
"Alamat Pangiriman": {
"jalan 1": "Jalur Jalan",
"jalan 2": "tali",
"kota": “Kota gedé”,
"nagara": "IL",
"Kodeu Pos": "72410",
"Code nagara": "AS"
},
"Alamat Penagihan": {
"jalan 1": "Jalur Jalan",
"jalan 2": "tali",
"kota": “Kota gedé”,
"nagara": "IL",
"Kodeu Pos": "72410",
"Code nagara": "AS"
},
"telepon": {
"Tipe telepon": “Imah”,
"nomer telepon": "9133413131"
},
"Alamat email": "john@anygoogle.com",
"NamiOnCard": "John Smith",
“panLastFour”: "3629",
"isPinSet": palsu,
"tanggal kadaluarsa": "2026-02-13",
"admin diblokir": palsu,
"Tersangka panipuan": palsu,
"ConfigurationId": “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”, "kategori": "Kredit",
"Instrumén pembayaran": "VirtualPan",
"prosessor": "Ngaran prosesor",
"Jenis pengiriman barang": “Biasa”,
"Status pesenan": "Rengse",
"Status ngagantian": "Henteu tiasa dianggo",
"Id Pelanggan": “2b15a695-13dc-4b10-b4e5-af5b0138873c”,
"clientIdentifier": "tali",
"ProcessorCustomerId": “T83E9D675A3N3N9O8RZ1”,
"diciptakeun": “2023-02-13T04:37:29.487-05:00”,
"Aktivasi awal": “2023-02-13T00:00:00-05:00”,
"diaktipkeunAt": “2023-02-13T04:43:19.282287-05:00”,
"lastModifiedAt": “2023-02-13T04:43:19.2962845-05:00”
}
3 Nalika status kartu robah jadi Aktif , anu Cards.Card.Diaktipkeun webkahuruan acara hook.
Cards.Card.Diaktipkeun webacara hook
{
"id": “95ac33ca-3d7f-49aa-bfc2-afce01113310”,
"Nama acara": "Kartu.Kartu.Diaktipkeun",
"status": "Tunggu",
"Id mitra": “cd9c12f4-7691-424a-b38b-af5b0134c611”,
"diciptakeun": “2023-02-13T04:44:31.282287-05:00”,
"sumberdaya": [
“cardmanagement/v1/cards/8709163d-140c-4d95-a111-afa8009e9cd1” ],
"detil": [
{
"Id kartu": “8709163d-140c-4d95-a111-afa8009e9cd1”,
"status": "Aktif",
"StatusReasonCode": "NotSet"
3.4. Nginjeum
Lengkah 1
Meunang kredensial API
Lengkah 2
Kéngingkeun Token Aksés
Lengkah 3
Paké Aksés Token
Lengkah 4
Ngawangun Sampjeung App
Pinjaman kalebet sakumpulan telepon pikeun ngamungkinkeun anjeun nyiptakeun, ngapdet, sareng ngatur API pinjaman injeuman anjeun.
Pikeun ngamimitian damel sareng pinjaman, pastikeun anjeun:
Nampi kredensial API kalayan lingkup anu dipikabutuh pikeun Pinjaman
Upami anjeun parantos nyiptakeun Kapercayaan API, nganggo Manajemén jasa mandiri
, mangka anjeun ogé kudu ngirim pamundut ka
arix.support@crossriver.com
Org, bareng jeung clientid anjeun sarta MPLID, pikeun ngalengkepan ciptaan.
Paké wengkuan bener, pikeun API nu Anjeun hoyong pake.
Ruang lingkup API pikeun sandbox nyaéta: CosLending: PreApproval: stg
Sandbox
Dasar modul URL pikeun API panggero Pedaran
injeuman asalna
Kaputusan aplikasi
|
https://arixapisandbox.crbnj. net |
Dasarna URL pikeun origination injeuman API nelepon ka lingkungan sandbox Arix |
|
https://lendingsandbox.crbco s.com/preapproval/v1 |
Dasarna URL pikeun sandbox tina kaputusan aplikasi |
Angger
Modul Swagger Patalina
|
rujukan API dokuméntasi |
https://arixapisandbox.crbnj.net/swagger-ui |
|
Kait |
https://lendingsandbox.crbcos.com/hooks/swagger/inde x.html |
Ngajual https://lendingsandbox.crbcos.com/selling/swagger/inde x.html
Halaman Status
Pikeun ningali daptar rilis anu bakal datang, pantau status API ayeuna, view laporan kajadian, atawa dibere beja pangropéa dijadwalkeun, didatangan kami sarta ngalanggan ngabejaan. kaca status
4. Setélan program
Nyetél SFTP: Paké SFTP boh pikeun ngirim files atawa pikeun ngundeur éta ti Palang Walungan, nurutkeun pangabutuh anjeun sarta kami.
Palanggan onboarding: Atur informasi customer anjeun dina Palang Walungan sistem operasi (COS) ngagunakeun boh API atawa COS explorer
Jenis produk sareng ID COS: Ngajelaskeun jinis produk sareng ID COS.
COS Explorer: Kumaha damel sareng COS Explorer kami.
Portal manajemén Org: Kumaha cara damel sareng portal manajemén Org kami.
4.1. Nyetél SFTP
Nalika anjeun kedah tukeur inpormasi sénsitip dina a file format kalawan Palang Walungan, kami merlukeun anjeun ngagunakeun Aman File Protokol Transfer (SFTP). Paké SFTP boh pikeun ngirim files atawa pikeun ngundeur éta ti Palang Walungan, nurutkeun pangabutuh anjeun sarta kami. Dina sababaraha kasus, anjeun atanapi kami bakal énkripsi ieu files, utamana lamun ngandung sagala Personal Identifying Émbaran (PII).
NgagunakeunSFTP
SFTP ngidinan Anjeun aman ngirim jeung nampa sénsitip files jeung laporan ngagunakeun folder ditugaskeun husus pikeun anjeun bisnis dina server aman. Unggah sareng unduh files ngaliwatan éta folder atawa subfolders tina folder éta, sakumaha per kabutuhan husus Anjeun.
Ngagunakeun énkripsi
Encrypting files nambahkeun hiji lapisan tambahan panyalindungan. Ngan tanaga otorisasi sareng konci anu leres anu tiasa ngadekrip énkripsi file. Dina Palang Walungan kami nganggo enkripsi PGP.
Mimitian
Aya sababaraha léngkah pikeun ngajantenkeun anjeun sareng ngajalankeun server SFTP kami.
1 Anjeun ngalengkepan IP Aksés Request for Cross River SFTP Services formulir (tina RM anjeun).
Lamun perlu babagi files kalawan Palang Walungan, Manajer Hubungan anjeun bakal ngirim Anjeun hiji IP Aksés Request formulir CRB SFTP Layanan. Diantara inpormasi anu sanés, anjeun kedah nyayogikeun alamat IP umum statik anu anjeun anggo pikeun ngaksés polder SFTP, sareng konci umum PGP pikeun énkripsi sareng ngadekrip. files. Kirimkeun formulir anu réngsé deui ka Manajer Hubungan anjeun
PENTING
Palang Walungan bakal ngidinan daptar ngan 5 alamat IP pikeun anjeun, jadi tumut kana akun. Alamat IP kedah statik. Ku alatan éta, anjeun kedah proxy naon waé anu henteu statis dina tungtung anjeun.
2 Kami nyetél struktur folder SFTP anjeun.
Sakali Cross River gaduh detil anjeun, departemén rékayasa IT kami nyiptakeun set standar polder sareng subfolder pikeun anjeun. Jalur unik ieu ngan ukur pikeun bisnis anjeun. Taya pasangan séjén bisa ngakses eta. Rékayasa IT ngirim email ka anjeun kalayan inpormasi anu anjeun peryogikeun pikeun ngaksés polder. Surélék ngawengku tumbu ka kredensial Anjeun. Cross Walungan teu nyimpen sandi anjeun!
PENTING
Tautan ngan ukur saé pikeun sababaraha dinten, saatos éta anjeun kedah nyuhunkeun reset sandi upami anjeun henteu nganggo.
Kapercayaan ogé jadi teu sah lamun leuwih ti dua urang ngakses link.
3 Nguji unggah SFTP.
Upami anjeun badé nyayogikeun files ka Palang Walungan, departemén IT anjeun kedah nyetél hiji akun jasa kalawan prosés otomatis pikeun unggah pamadegan files kana polder SFTP Anjeun. Kami nyarankeun pisan yén anjeun nguji ieu sateuacan anjeun nyobian ngirim data nyata. Taroskeun manajer hubungan anjeun sareng patarosan atanapi masalah atanapi buka tikét kalayan dukungan jalur munggaran anjeun.
4 Nyetél PGP pikeun ngirim atawa nampa files ti Palang Walungan. (Lengkah ieu ngan diperlukeun lamun anjeun ngirim atawa narima PII. Mangga parios kalawan RM anjeun.)
Lamun perlu ngirim Palang Walungan files, urang mimiti bakal ngirim Anjeun konci publik PGP kami pikeun pamakéan dina encrypting maranéhanana files.
Anjeun kudu geus dikirim Palang Walungan PGP konci publik Anjeun pikeun nampa files ti urang.
5 Bagikeun data anjeun.
Sakali polder SFTP anjeun disetél sareng prosés anjeun parantos aya, anjeun tiasa ngamimitian ngabagi files sareng urang. Manajer hubungan Anjeun ngabejaan Anjeun upami aya hal nu leuwih husus Anjeun kudu ngalakukeun pikeun nampa laporan, atawa kumaha carana nyiapkeun data pikeun ngirim ka kami.
Laporan Spésifik
Diajar langkung seueur ngeunaan nyiapkeun sareng ngirim laporan sareng files pikeun:
Akun sareng pangmayaran
pangmayaran kartu
résiko kiridit
Nginjeum
Pamayaran bets XML (ISO 20022)
4.2. Palanggan onboarding
Atur inpormasi palanggan anjeun dina sistem operasi Cross River (COS) nganggo API atanapi . Inpormasi ieu kalebet detil dasar anu diperyogikeun pikeun muka bank COS Explorer
akun atawa make kartu kiridit, kitu ogé data leuwih husus ngeunaan nasabah, sakumaha diperlukeun. Urang nelepon ieu a catetan customer.
Sateuacan anjeun tiasa muka rekening deposit atanapi ngadamel kartu anjeun kedah nyiptakeun catetan palanggan, sok disebut onboarding. Anjeun teras tiasa napelkeun hiji atanapi langkung palanggan kana rekening ngalangkungan palanggan hubungan.
Prosés onboarding customer ngawengku nyieun hiji kalawan catetan customer relevan inpo customer. Turutan tutorial ieu pikeun unggal anjeun nyieun hiji customer catetan customer.
Léngkah pilihan
Tambahkeun rinci ID
Tambahkeun boga mangpaat
Kodeu kasalahan
Tingali, sareng seueur inpormasi rujukan anu sanés, dina kode kasalahan sistem COS COS
kaca kode rujukan.
4.2.1. catetan customer
catetan customer
Catetan palanggan mangrupikeun sumber daya primér anu ngandung inpormasi palanggan dina sistem Cross River. Ku alatan éta, saméméh nyieun hiji akun pikeun nasabah, Anjeun kudu onboard customer éta. Catetan palanggan ngadukung klasifikasi jinis Pribadi atanapi Usaha. Sakali onboarded, anjeun tiasa ngahubungkeun palanggan sareng hiji atanapi langkung akun.
Mantanample handap nembongkeun kumaha onboard a customer pikeun customer pribadi.
Request Jalma Onboard
POST /inti/v1/cm/palanggan {
"Id mitra": “7cc038be-fde9-4455-b27b-1497cf667362”,
"ngaran": {
"awalan": "Bapa.",
"nami payun": "John",
"nami tengah": "Robert",
"nami pengker": “Smith”,
“sufiks”: “Jr.”,
"Ngaran preferred": "Jim" },
"klasifikasi": “Pribadi”,
"profile”: {
"regO": palsu,
"Kode Nagara Kewarganegaraan": "AS",
"Political Exposed Person": palsu,
"AktifkeunBackupWithholding": palsu,
"cadanganWithholdingPercent": 0,
"taxIdType": "Ssn",
"TaxId": "123456789",
"tanggal lahir": "1965-09-15",
"RiskRating": "Lemah",
"privacyOptOut": leres }
} Onboard palanggan bisnis sapertos korporasi atanapi LLC nganggo titik tungtung anu sami sareng atribut anu rada béda.
Curl
POST /inti/v1/cm/palanggan {
"Id mitra": “a24cba49-2bb6-431d-a867-1de81d6e4127”,
"ngaran": {
"Nama éntitas": "ACME CO", },
"klasifikasi": “Usaha”,
"profile”: {
"Kode Nagara Kewarganegaraan": "AS",
"AktifkeunBackupWithholding": palsu,
"cadanganWithholdingPercent": 0,
"taxIdType": "Én",
"TaxId": "123456789",
"dateFormed": "2019-09-10",
"Tipe éntitas": "Perusahaan",
"RiskRating": "Lemah",
"Tipe milik": "LegalEntity",
"primaryOwnerCustomerId": “f9321f7f-3712-46e1-b965-2b79ead64dc9”,} }
Paduli naha anjeun onboarding a customer pribadi atawa bisnis, éta primér Pamilik CustomerId atribut kudu ngandung hiji ID customer ngarujuk rékaman customer tipe Personal. Ku kituna pikeun onboard bisnis, Anjeun mimitina kudu nyieun catetan customer pribadi pikeun nu boga primér bisnis éta.
PENTING
Sababaraha titik tungtung customer ngawengku a pamariksaan sumberdaya nu bisa atawa teu diperlukeun nalika onboarding konsumén pribadi. Liaison patuh anu ditugaskeun anjeun nyarioskeun syarat-syarat pikeun widang Ketekunan Due salami prosés onboarding anjeun.
Pamilik mangpaat
Pamilik anu nguntungkeun nyaéta jalma anu gaduh 25% atanapi langkung usaha. Pikeun alesan pangaturan, Anjeun kudu sumberdaya di a Usaha catetan customer nyieun hiji boga mangpaat
pikeun unggal nu boga mangpaat tina bisnis éta. The ownerCustomerId atribut rujukan catetan customer Pribadi pikeun tiap boga mangpaat. Anjeun biasana nambihan sumber daya anu mangpaat pikeun catetan palanggan bisnis langsung saatos asup kana usaha.
Curl
POST /inti/v1/cm/palanggan/{customerId}/pamilik-manfaat {
"ownerCustomerId": “c1210a2d-932e-43ca-be29-f358a4382385”,
"Judul Owner": "Présidén" }
Alamat
Alamat fisik anu aya hubunganana sareng palanggan tiasa .
diropéa
Curl
POST /core/v1/cm/customer/{customerId}/alamat
{
"éta primér": leres,
"status": "Aktif",
"klasifikasi": "Parumahan",
"Tipe alamat": “Imah”,
"jalan 1": “Jalan Maple 123”,
"jalan 2": "Apt. 12",
"jalan 3": “”,
"kota": "York énggal",
"nagara": "NY",
"Kodeu Pos": "10025",
"Code nagara": "AS",
}
Alamat surélék
Apdet email
inpo kontak pikeun konsumén.
Curl
POST /inti/v1/cm/palanggan/{customerId}/email {
"éta primér": leres,
"EmailType": “Pribadi”,
"Alamat email": "john.smith@crossriver.com" }
Telepon
Apdet telepon Curl
inpo kontak pikeun konsumén.
POST /core/v1/cm/customer/{customerId}/telepon
{
"Tipe telepon": “Imah”,
"éta primér": leres,
"nomer telepon": "2015551234"
}
Idéntifikasi
Idéntifikasi dianggo pikeun ngalacak metadata pikeun dokumén anu ngaidentipikasi palanggan sapertos lisénsi supir sareng paspor. bisa dipaké pikeun nambahkeun rinci ID anyar. Tambahkeun rinci ID
Curl
POST /core/v1/cm/customer/{customerId}/identifications {
"éta primér": leres,
"idNumber": "DL123456789",
"idType": "Sim",
"Tanggal dikaluarkeun": "2018-08-30",
"expDate": "2018-08-30",
"Tanggal Diverifikasi": "2018-08-30",
"pejabat anu nerbitkeun": "NJ DMV",
"issuingStateOrProvince": "NJ",
"NgaluarkeunCountryCode": "AS",
}
4.2.2. Jenis produk sareng ID COS
Di Walungan Palang, a tipe produk mangrupakeun produk finansial unik ngonpigurasi anjeun nawiskeun konsumén Anjeun. Pikeun exampLe, tipe produk bisa jadi kartu debit atawa rekening tabungan, ngonpigurasi nurutkeun pangabutuh anjeun sarta spésifikasi. Anjeun muka akun pikeun konsumén anjeun dina sagala jinis produk anu anjeun tangtukeun sareng konpigurasikeun babarengan sareng kami. Nyarios ka manajer hubungan anjeun pikeun langkung rinci, kalebet kumaha nyetél jinis produk pikeun konsumén anjeun.
Pikeun exampLe, Anjeun bisa jadi hoyong ngonpigurasikeun hiji tipe produk jadi produk akun tabungan anu ngagunakeun kawat sarta pangmayaran ACH. Anjeun teras tiasa nawiskeun rekening tabungan ka konsumén anjeun nganggo jasa sareng konfigurasi ieu.
Cross Walungan nyadiakeun Anjeun sareng ID produk pikeun tiap jenis produk nu Anjeun hoyong nawiskeun konsumén Anjeun. Pikeun muka akun deposit naon waé anjeun kedah gaduh ID produk anu sah sareng ID palanggan (ID catetan palanggan onboarded) pikeun anu gaduh akun. Catet yén anu gaduh akun kedah gaduh sahenteuna hiji alamat sareng nomer telepon dina catetan palangganna, sareng status OFAC na kedah aya Jelas. Salaku tambahan, klasifikasi palanggan kedah cocog sareng klasifikasi anu dikonpigurasikeun pikeun produk. Pikeun example, ngan konsumén bisnis bisa ditambahkeun kana produk bisnis.
4.2.3. COS Explorer
Sakali anjeun kana sistem Palang Walungan sarta geus narima email kalawan onboarded
anjeun Klién KTP jeung rusiah anjeun siap login ka COS Explorer. AccesstheCOSExplorportal
Produksi:
https://api.crbcos.com/explorer2/
Kotak pasir:
https://sandbox.crbcos.com/explorer2/
Wilujeng sumping email
Anjeun bakal nampi email wilujeng sumping ti CrossRiver_DO_NOT_REPLY@crossriver.com. Upami anjeun henteu ningali dina koropak anjeun, pariksa polder spam atanapi mail anu diblokir.
Pencét Jieun Akun Palang Walungan Anjeun.
Upami anjeun ngantunkeun wizard iraha waé, klik tautan dina email asli pikeun uih deui ka tempat anu anjeun tinggalkeun.
Syarat sareng katangtuan
Baca sarat jeung kaayaan, pariksa Narima, teras klik Teras.
SMS(textmessage)verifikasi
Kami ngirim SMS (pesan téks) ka alat anjeun pikeun pariksa idéntitas anjeun. Lebetkeun kodeu 6-angka anu anjeun tampi dina layar login teras klik Pariksa Kodeu.
Jieun sandi anjeun
1. Lebetkeun kecap akses anu nyumponan sarat dina layar sareng lebetkeun deui kecap akses.
2. Pencét Jieun Sandi.
Setélan aplikasi Authenticator
Anjeun kedah ngalengkepan léngkah ieu pikeun neraskeun prosés pandaptaran sareng tiasa login ka hareup
Pikeun ngajaga idéntitas anjeun sareng akun sareng inpormasi anjeun, kami ngabutuhkeun anjeun asup sareng auténtikasi multi-faktor/2-faktor.
Upami anjeun teu acan gaduh aplikasi authenticator dina alat anjeun, anjeun kedah ngaunduh hiji sateuacan anjeun neraskeun.
Pikeun Android sareng ios, kami nyarankeun ngagunakeun aplikasi authenticator:
Google Authenticator
Microsoft Authenticator
Sakali anjeun gaduh aplikasi authenticator anjeun dipasang, anjeun kedah boh nyeken kodeu QR or asupkeun konci sacara manual kana aplikasi authenticator.
QRcode
1. Nyeken kodeu QR dina aplikasi auténtikasi anjeun sareng, upami diperyogikeun, lebetkeun kodeu 6-angka dina halaman auténtikasi Multi-Factor.
2. Klik neruskeun.
Manual
1. Pencét Témbongkeun konci
2. Nyalin konci salaku rusiah dina aplikasi authenticator anjeun.
3. Lebetkeun kodeu 6-angka.
4. Pencét Teraskeun.
InvalidMFAcode
Upami anjeun ngasupkeun kodeu MFA anu teu sah, pesen beureum ngabéjaan anjeun pikeun nyobaan deui.
Aduh! Anjeun ngasupkeun kodeu MFA teu valid. Ieu sababaraha hal anu kedah dipariksa deui:
1. Naha kodeu timeout sateuacan anjeun diklik Teraskeun? Sésana waktos dituduhkeun ku bunderan mundur ka katuhu nami akun sareng kode MFA.
2. Upami anjeun parantos nyetél aplikasi auténtikasi pikeun sababaraha lingkungan atanapi aplikasi, pariksa deui yén anjeun ngasupkeun kodeu anu leres.
1. Upami teu jelas tina nami sambungan MFA anu mangrupikeun pilihan anu leres, anjeun panginten kedah nyobian kode anu béda dugi ka mendakan anu tiasa dianggo.
2. Sakali anjeun mendakan sambungan anu leres, anjeun tiasa ngaganti nami sambungan MFA dina aplikasi. Ikon pensil di luhureun layar aplikasi MFA bakal mawa anjeun ka mode ngedit. Dina sababaraha aplikasi, anjeun kedah milih heula (atanapi pencét sareng tahan) sambungan anu kedah diédit, teras ikonna bakal muncul.
3. Sakali dina modeu édit, anjeun tiasa ngaganti ngaran sambungan sakumaha diperlukeun ku kituna bakal jelas mana nu manglaku ka lingkungan mana.
4. Simpen parobahan mana waé, sareng waktos salajengna éta kedah langkung gampang ngartos kode mana anu dianggo.
Kodeu Pamulihan
Anggo kodeu pamulihan pikeun ngabuktoskeun kaaslianana upami anjeun kaleungitan alat anjeun.
1. Unduh atanapi salin kodeu pamulihan anjeun sareng simpen di tempat anu aman anu anjeun émut.
2. Pastikeun yén anjeun parantos nyimpen kodeu pamulihan anjeun
3. Pencét Ngadamel akun.
Kaca kode recovery kaluar sanggeus 10 menit.
Anjeun ngan bisa ngundeur Konci recovery sakali.
Akun anjeun ayeuna aktip sareng anjeun tiasa dianggo pikeun login ka salah sahiji aplikasi CR anjeun.
IP ngidinan Listing
Ngan hiji IP statik bisa dipaké pikeun ngakses COS Explorer. Ngahontal Rojongan IP anjeun upami anjeun peryogi bantosan ngeunaan ieu.
Alamat IP Server Idéntitas nyaéta:
172.67.26.222 104.22.40.134 104.22.41.134
Server diproksi via Cloudflare.
Anjeun tiasa ngidinan FQDNs ieu:
idptest.crbcos.com
Pamérésan masalah
Hilap kecap konci
1. Pencét Hilap kecap konci? sareng lebetkeun email anjeun.
2. Lebetkeun kode auténtikasi 6 digit tina aplikasi auténtikasi anjeun. 3. Anjeun meunang a Hilap kecap konci surélék. Pencét Reset Sandi.
4. Dina kaca Reset Sandi, asupkeun kecap akses anyar, klik Reset Sandi, jeung Nuluykeun kana aplikasi.
Resetmulti-factorauthentication
Upami anjeun parantos ngonpigurasi MFA:
1. Dina Identity Server, buka Reset MFA teras klik Reset alat MFA Anjeun. 2. Halaman Auténtikasi Multi-Faktor muka sareng anjeun tiasa ngareset MFA anjeun.
Anjeun oge bisa nyieun kode recovery auténtikasi multi-faktor anyar.
1. Pencét nyieun kode recovery auténtikasi multi-faktor anyar.
2. Halaman Kode Pamulihan muka sareng anjeun tiasa nyalin atanapi ngaunduh 10 kodeu pamulihan énggal anjeun.
Upami anjeun henteu acan ngonpigurasi auténtikasi multi-faktor anjeun, anjeun tiasa ngaktipkeun MFA tina Sétingan akun.
1. Pencét Reset Métode MFA.
2. Pencét Konpigurasikeun MFA.
3. Turutan parentah dina auténtikasi Multi-Factor / Auténtikasi 2-Lengkah.
Upami MFA anjeun ayeuna nyaéta SMS, anjeun tiasa ngaktipkeun MFA sareng aplikasi auténtikasi anjeun. Di Sétingan akun
1. Pencét Reset Métode MFA.
2. Pencét Konpigurasikeun MFA.
3. Turutan parentah dina auténtikasi Multi-Factor / Auténtikasi 2-Lengkah.
Paké kode recovery
Mun anjeun teu mibanda aksés ka multi-faktor (2-faktor) authenticator Anjeun, Anjeun bisa asup ngagunakeun salah sahiji kode recovery Anjeun.
1. Asup sakumaha biasa
2. Dina kaca Auténtikasi Multi-Factor, anjeun gaduh pilihan pikeun ngagunakeun kodeu pamulihan salaku pilihan auténtikasi anjeun.
3. Lebetkeun salah sahiji kode recovery anjeun dina kotak téks. Kodeu pamulihan mangrupikeun panggunaan tunggal sareng teu tiasa dianggo deui. Pikeun ngahindarkeun kabingungan ka hareup, kami nyarankeun yén anjeun nyirian kodeu pamulihan nalika dianggo.
Konci akun
Lamun anjeun ngasupkeun sandi salah pikeun ngaran pamaké anjeun 5 kali, sistem ngonci akun anjeun salila kurang leuwih 5 menit. Lamun sanggeus 5 menit, anjeun masih teu bisa ngakses akun anjeun, kontak Cross Walungan Rojongan.
Kasalahan browser -Firewall
Anjeun asup ka COS Explorer sareng kéngingkeun layar kasalahan ieu:
Anjeun diblokir ku firewall.
1. Hubungi departemen IT internal anjeun pikeun ningali naha organisasi anjeun ngalaksanakeun aturan firewall pikeun lalu lintas kaluar. Upami teu aya aturan firewall pikeun lalu lintas kaluar, maka:
2. Taroskeun departemen IT internal anjeun pikeun mastikeun yén anjeun nyambung ka Cross River COS Explorer Portal tina alamat IP anu disatujuan. Upami anjeun kedah ngadaptar langkung seueur alamat IP, kirimkeun email ka dukungan COS.
4.2.3.1. manajemén pamaké
Ngatur pamaké
Anjeun tiasa nganggo Pamaké layar tina Admin tab pikeun ngagolongkeun sakumpulan sumberdaya, sapertos konsumén, produk, sareng akun. Sakali sumberdaya a (ie produk atawa customer) geus ditugaskeun ka anjeun, eta teu bisa dirobah.
Anjeun tiasa nganggo daérah ieu pikeun ngadukung sareng ngadamel parobihan pikeun palanggan anjeun. Kami tiasa nyetél anjeun sareng 2 pangguna admin supados anjeun tiasa nyiptakeun pangguna anu dipénta pikeun konsumén anjeun. Ieu méré Anjeun kamerdikaan pikeun ngatur konsumén Anjeun tur ngidinan Anjeun pikeun nyieun parobahan kaluar jam, dina pamundut maranéhanana.
Anjeun oge bisa nyieun atawa onboard pamaké anyar.
Createanewuser
1 Dina Admin tab, klik Pamaké pikeun muka Pamaké layar pilarian. 2 Pencét + Pamaké anyar. The Jieun pamaké mintonkeun layar.
3 In Jieun pamaké asupkeun pamaké Surélék, widang di handap ieu lajeng dipintonkeun Nami payun, Nami pengker jeung Nomer telepon.
4 Pencét Status tur pilih Aktif.
The Nomer telepon lapangan kedah janten nomer telepon sélulér sabab ieu bakal dianggo pikeun MFA pikeun ngabuktoskeun kaaslianana pangguna.
Pedaran lapangan
|
Ngaran |
Ngaran pamaké. Lebetkeun nami pangguna lengkep pikeun ditingalikeun dina jandela pangotektak nalika pangguna asup kana Explorer. |
|
Surélék |
alamat surélék pamaké. Alamat ieu dipaké pikeun asup kana Explorer jeung ogé boga fungsi minangka surelek recovery pikeun resets sandi. |
|
Status |
Pilih status pamaké. Status pamaké nyaéta Teu aktif sacara standar. Ganti kana Aktif nalika nyieun pamaké. |
|
Tipe pamaké |
widang ieu mintonkeun Mitra lamun pamaké dijieun. |
|
Kalungguhan |
Pilih peran pikeun ditambahkeun ka pamaké, atawa klik Kaasup Sadaya Peran pikeun nambahkeun sagala peran sadia pikeun pamaké. Catetan: Ngan peran anu ditugaskeun ka anjeun bakal katingali. Sababaraha peran ngandung idin anu ngamungkinkeun anjeun pikeun ngahasilkeun pamayaran dina Explorer. Admin Explorer anjeun tanggung jawab pikeun mastikeun yén pangguna anjeun dikonpigurasi leres kalayan ngan ukur peran pangguna anu cocog sareng wates anu diidinan. |
Watesan otorisasi
Pikeun unggal widang, pilih wates dollar (upami aya)
5 Pencét Status tur pilih Aktif.
6 Pencét Kalungguhan tur pilih nu Anjeun hoyong napelkeun pamaké anyar. Pencét Simpen kalungguhan Parobahan.
Sadayana pamaké kudu ngonpigurasi kalawan Mitra Inti Siap Ngan peran.
Upami pangguna ditugaskeun ka Asalna Kawat Mitra peran anjeun kudu ngonpigurasikeun wates origination nu pamaké.
7 Lamun nuju assigning pamaké nu Asalna Kawat Mitra peran, asupkeun nilai dina Kawat.Payments.Asal widang pikeun nunjukkeun wates dollar maksimum per kawat. Upami teu kitu, anjeun tiasa malire widang ieu.
8 Sawaktos Anjeun rengse ngonpigurasikeun sadaya widang. Pencét Simpen Parobahan.
9 Upami anjeun parantos suksés nyiptakeun pangguna énggal, layar konfirmasi bakal némbongan.
10 Pikeun ngalengkepan tambihan sareng konfigurasi pangguna, admin anu béda kedah Nyatujuan Parobahan.
11 The Nyatujuan Parobahan Ditunggu mintonkeun layar. Pencét Konpirmasi.
12 Viewinpormasi pangguna
Dokumén / Sumberdaya
![]() | API Platform |
Rujukan
- Manual pamakémanual.tools
