Llawlyfr Defnyddiwr Platfform API Cross River

Cross River API Platform User Manual

Platfform API

Cychwyn arni

1. Croeso

NEWYDD! Cyhoedd Cross River gyda cheisiadau parod ar gyfer casgliad Cross Postman
Afon. Pwyntiau terfyn API

Croeso i Cross River dogfennaeth

Darganfyddwch, archwiliwch a dechreuwch integreiddio ein cynnyrch yn rhwydd

Cychwyn Cyflym Archwiliwch yr holl gynhyrchion


Cael dechrau
Gosodwch a dechreuwch eich taith gan ddefnyddio APIs Cross River

Cysyniadau
Darganfyddwch sut y gall atebion Cross River drawsnewid eich taith fintech

APIs
Datblygu gan ddefnyddio glannau Cross River
platfform a setiau API cadarn

Tiwtorialau
Dysgu sut i ddefnyddio Croes
APIs River gam wrth gam

2. Cychwyn cyflym 

Cam 1
Cam 2
Cam 3
Cam 4

Cael Tocyn Mynediad

Defnyddiwch y Tocyn Mynediad

Adeiladu Sample App

Cael manylion mewngofnodi API: Eich cam cyntaf i weithio gydag APIs Cross River yw cofrestru ar gyfer tystlythyrau API.

Cael tocyn mynediad: Ar ôl i chi dderbyn eich manylion mewngofnodi API a chyn y gallwch ddefnyddio ein APIs, rhaid i chi gael tocyn mynediad gan ddefnyddio'r cleient_id cleient_gyfrinach a gawsoch pan wnaethoch gofrestru.

Defnyddiwch y tocyn mynediad: Unwaith y byddwch wedi dilysu'n llwyddiannus, mynediad_tocyn yn cael ei ddychwelyd i chi. Cynhwyswch y tocyn hwn ym mhennawd eich galwadau API.

Webbachau: WebMae bachau yn elfen bwysig o unrhyw integreiddio â Cross River. Er bod APIs yn caniatáu ichi ofyn am ddata ar alw, webMae bachynnau'n gwthio diweddariadau amser real yn uniongyrchol i'ch system—gan ddileu'r angen am bleidleisio cyson a lleihau oedi.

Amgylcheddau blwch tywod: Mae'r blwch tywod yn amgylchedd cwbl ynysig, felly mae croeso i chi

2.1. Cael manylion mewngofnodi API

Cam 1
Cael manylion mewngofnodi API

Cam 2
Cael Tocyn Mynediad

Cam 3
Defnyddiwch y Tocyn Mynediad

Cam 4
Adeiladu Sample App

Eich cam cyntaf i weithio gydag APIs Cross River yw cofrestru ar gyfer manylion mewngofnodi API. Gyda'r manylion mewngofnodi hyn gallwch ofyn am docyn mynediad a'i dderbyn i'w ddefnyddio ar gyfer anfon APIs yn ein hamgylchedd blwch tywod.

PWYSIG

Rhaid i'ch cyfeiriad IP, sy'n rhaid iddo fod yn gyhoeddus ac yn statig, fod ar ein rhestr ganiatadau. Dylai eich adran TG fewnol allu rhoi'r cyfeiriad IP hwn i chi. Dysgu mwy am gyfeiriadau IP statig.

Mynediad Blwch Tywod

Cyflwyno cais ar gyfer mynediad blwch tywod, i dderbyn tystlythyrau API.

Unwaith y bydd eich cyfeiriad IP statig wedi'i ychwanegu at ein rhestr ganiatadau, byddwn yn anfon 2 e-bost wedi'u hamgryptio atoch gyda'ch manylion mewngofnodi:

Mae un e-bost yn cynnwys eich cleient_id partner_id a gwybodaeth arall y bydd ei hangen arnoch yn dibynnu ar yr hyn rydych wedi gofyn amdano.

Mae'r ail e-bost, sydd wedi'i amgryptio, yn cynnwys eich cleient_gyfrinach webbachyn_cyfrinach Bydd angen y rhain arnoch ar gyfer dilysu ac ar gyfer gweithio yn y blwch tywod.

NODYN

Os gofynnoch am fynediad i Daliadau Cerdyn, byddwch yn derbyn set ychwanegol o fanylion gan gynnwys ail cleient_id cleient_gyfrinach

2.2. Cael tocyn mynediad

Cam 1
Cael manylion mewngofnodi API

Cam 2
Cael Tocyn Mynediad

Cam 3

Defnyddiwch y Tocyn Mynediad

Cam 4
Adeiladu Sample App

Mae Cross River yn defnyddio OAuth 2.0 ar gyfer dilysu ac awdurdodi. Mae hyn yn rheoli mynediad i'n system ac yn sicrhau mai dim ond endidau awdurdodedig all gael mynediad i'n APIs ac adnoddau gwarchodedig eraill. Mae'r wybodaeth a nodwch yn ein system ddilysu yn gyfrinachol ac ni ellir byth ei chael o unrhyw gymwysiadau Cross River eraill.

Ar ôl i chi dderbyn eich , a chyn y gallwch ddefnyddio ein APIs, rhaid i chi gael manylion mewngofnodi API tocyn mynediad gan ddefnyddio'r cleient_id cleient_gyfrinach a gawsoch pan wnaethoch gofrestru. Mae'r tocyn mynediad hwn yn caniatáu ichi anfon gwybodaeth yn ddiogel fel gwrthrych JSON i'w ddefnyddio yn ein APIs. Rhaid i chi gynnwys y tocyn hwn ym mhennawd pob cais API.

Mae sawl ffordd o ofyn am docyn mynediad a'i dderbyn:

Defnyddiwch y Rhyngwyneb Llinell Gorchymyn (CLI) gyda cURL neu unrhyw iaith arall

Defnyddiwch Postman neu unrhyw offeryn profi API arall

Ar ôl ei gael, copïwch y tocyn mynediad i'ch clipfwrdd. Gwnewch yn siŵr eich bod yn ei gadw.

RhyngwynebLlinellGorchymyn

I ofyn am docyn anfonwch Cysylltiad/tocyn POST gorchymyn sy'n cynnwys y cleient_id cleient_gyfrinach grant_math i (gweinydd dilysu) y gweinydd dilysu blwch tywod priodol, fel y dangosir yn yr sample isod.

Cyfeiriwch at y am esboniad o'r rhain tagsTabl cydrannau HTTP

Mae'r cynampdefnyddiau le cURL i ofyn am docyn gan un o'r gweinyddion awdurdodi.

Sampy cais yn cURL ar gyfer COS

curl –lleoliad –cais 'POST https://idptest.crbcos.com/connect/token' –pennawd 'Math-Cynnwys: cais/x-www-ffurflen-urlwedi'i amgodio \ –data-urlamgodio 'client_id=[eich ID yma]' \

 –data-urlamgodio 'cyfrinach_cleient=[eich cyfrinach yma]' \

 –data-urlamgodio 'math_grant=cymwysterau_cleient' \

 –data-urlamgodio 'cynulleidfa=https://api.crbcos.com/'

Sampymateb gan cURL cais

“Tocyn_mynediad”"yn cynnwys llawer o gymeriadau", \

 “yn dod i ben mewn”86400, \

 “math_tocyn”“Cludydd” }

Postmon

I ofyn am docyn gan ddefnyddio Postman, anfonwch Cysylltiad/tocyn POST gorchymyn i'r awdur gweinydd o'r blwch tywod priodol. Ychwanegwch y grant_math cwmpas (dewisol) ,

cleient_id cleient_gyfrinach i'r alwad.

Cyfeiriwch at y am esboniad o'r rhain tagsTabl cydrannau HTTP

Os yw'r dilysu'n llwyddiannus, y cod statws yw 200 (Iawn).

COSExplorer

Yn , cliciwch y saeth i lawr wrth ymyl eich mewngofnod a chliciwch Copïo Tocyn MynediadArchwiliwr COS

Mae'r tocyn mynediad wedi'i gopïo i'ch clipfwrdd, yn barod i'w ddefnyddio yn y . Sandbox

Ymateb i gais tocyn

Disgrifiad o'r Priodoledd

mynediad_i

ken

JSON wedi'i lofnodi'n ddigidol web tocyn (JWT) a anfonwyd o'r gweinydd oAuth sy'n caniatáu mynediad i adnoddau penodol Cross River

cwmpas

Amrywiaeth o wasanaethau y gall defnyddiwr gael mynediad atynt

yn dod i ben_i

n

Y cyfnod o amser cyn i'r tocyn ddod i ben.

– Bydd ein Tîm Integreiddio yn eich hysbysu o’r amser dod i ben neu gallwch ddadgodio’ch tocyn mynediad hefyd.

– Rydym yn argymell eich bod yn adfer tocyn mynediad newydd ychydig cyn i'r hen docyn ddod i ben.

– Ailddefnyddio tocynnau am eu hoes gyfan yn hytrach na chael tocyn newydd ar gyfer pob galwad i'r un adnodd gwarchodedig (API).

PWYSIG:

Peidiwch byth â dadgodio'ch tocyn ar safle a gynhelir yn gyhoeddus websafle

math o docyn

Tocyn cludwr

Cydrannau HTTP

Defnyddir y cydrannau HTTP canlynol yn yr API a'r ceisiadau Postman.

HTTP

cydran

Tag Disgrifiad

Diweddbwynt

SWYDD

/cysylltu/toke n

Pwynt terfyn ar gyfer adfer tocyn mynediad

Pennawd

cynnwys

math

cais/x-www-ffurflen- urlamgodio

Corff

cleient_id

Y dynodwr unigryw ar gyfer cleient

Corff

cyfrinach_cleient t

Llinyn o nodau wedi'u hamgryptio a ddefnyddir i lofnodi a dilysu tocynnau adnabod.

Pwysig: Ni ellir adfer cyfrinachau trwy CR. Os byddwch chi'n colli cyfrinach, rhaid creu un newydd.

Peidiwch ymrwymo eich cyfrinachau i reolaeth ffynhonnell.

Corff

grant_math

Bydd gan y maes hwn werth o bob amser

manylion_cleient

Corff

cynulleidfa

dewisol

Ffordd i'r defnyddiwr ddilysu a yw tocyn mynediad penodol wedi'i fwriadu ar eu cyfer nhw.

Corff

cwmpas

dewisol

Ystod benodol neu set gyfyngedig o wasanaethau y gall defnyddiwr gael mynediad atynt gyda thocyn mynediad.

Os na nodir cwmpas, bydd y tocyn a ddychwelir yn cynnwys yr holl gwmpasau sy'n gysylltiedig â'ch manylion mewngofnodi.

Nodyn: Gellir anfon sawl cwmpas yn yr un cais drwy ychwanegu bwlch rhwng enw pob cwmpas. Er enghraifftample: 'scope=scope1 scope2 scope3'

Gweinydd AwdurdodiURLs

Gweinydd Awdurdodi Modiwl URL

Cyfrifon

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

ACH

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

Gwifrau

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

Sieciau

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

Craidd

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

Taliadau ar unwaith

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

Rhoi cardiau

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

Taliadau cerdyn

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

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

Datrys problemau

Os yw'r tocyn dilysu yn ddilys, bydd yn dychwelyd 200. Os nad yw'r tocyn dilysu yn ddilys, bydd yn dychwelyd 401.

Os na allwch gael tocyn cludwr ac nad ydych wedi derbyn un yn y gorffennol:

Cadarnhewch y URL.

Gwiriwch fod y cleient_id cleient_gyfrinach wedi'u teipio'n gywir. Maent yn sensitif i lythrennau mawr a bach.

Gwiriwch eich cleient_id cleient_gyfrinach yn erbyn yr un a gawsoch. Gwnewch yn siŵr nad oes unrhyw broblemau rhwydwaith na rhestr ganiatâd.

Cysylltwch â'n Tîm Integreiddio os yw'ch cyfrif wedi'i gloi o ganlyniad i 3 mewngofnodi anghywir ymdrechion.

2.3. Defnyddiwch y tocyn mynediad

Cam 1
Cael manylion mewngofnodi API

Cam 2
Cael Tocyn Mynediad

Cam 3
Defnyddiwch y Tocyn Mynediad

Cam 4
Adeiladu Sample App

Unwaith y byddwch wedi llwyddo, tocyn mynediad yn cael ei ddychwelyd atoch. Cynnwys dilysrwydd y tocyn hwn ym mhenawn eich galwadau API.

Mae'r tocyn mynediad yn dod i ben ar ôl cyfnod penodol o amser. Mae'r ymateb sy'n cynnwys y tocyn hefyd yn nodi'r amser dod i ben mewn eiliadau. Storiwch a defnyddiwch eich tocyn mynediad nes iddo ddod i ben. Rydym yn argymell eich bod yn defnyddio'r tocyn nes i chi dderbyn gwall 401 heb awdurdod, ac yna gofyn am docyn newydd.

PWYSIG

1. Peidiwch â gofyn am docyn newydd ar gyfer pob cais API.

2. Gwnewch yn siŵr eich bod yn amddiffyn eich tocyn. Gall unrhyw un sy'n dwyn eich tocyn efelychu eich cleient am oes y tocyn.

Pennawd cais API

Ym mhennawd pob cais API, cynnwys y tocyn mynediad fel a ganlyn:

Sampgalwad am daliad gwifren yn cURL

curl –lleoliad –cais 'POST https://sandbox.crbcos.com/Wires/v1/payments' –pennawd 'Awdurdodiad: Cludwr [EICH TOCYN YMA]' \

–pennawd 'Math-Cynnwys: cais/x-www-ffurflen-urlwedi'i amgodio \

–data-crai ‘{

 “RhifCyfrif”: “2255685659”,

 “CodSwyddogaethBusnes”: “CTR”,

 “RhifLlwybro derbynnydd”: “021000021”,

 “buddiolwrFi”: {

 “CodID”: “F”,

 “adnabodwr”: “021000021”,

 “enw”: “JP Morgan Chase”

 },

 "buddiolwr": {

 “CodID”: “D”,

 “adnabodwr”: “123456789”,

 “enw”: “Peter Griffin”

 },

 “Cyfeirnod Buddiolwr”: “XYZ123”,

 “swm”: 10000,

 “diben”: “taliad”

}'

Postmon

I ddefnyddio tocyn yn Postman, llywiwch i'r Awdurdodiad tab yn eich cais, dewiswch Tocyn Cludwr fel y math dilysu, a gludwch eich tocyn i'r maes a ddarperir. Bydd Postman yn ychwanegu'r Cludwr rhagddodiad a'r tocyn i'r Tocyn maes.

2.4. Webbachau

WebMae bachau yn elfen bwysig o unrhyw integreiddio â Cross River. Er bod APIs yn caniatáu ichi ofyn am ddata ar alw, webMae bachau'n gwthio diweddariadau amser real yn uniongyrchol i'ch system gan ddileu'r angen am bleidleisio cyson a lleihau oedi. Mewn llawer o achosion, webMae bachau'n fwy effeithlon a dibynadwy nag APIs yn unig, gan sicrhau bod eich cymhwysiad yn aros mewn cydamseriad â digwyddiadau hanfodol fel newidiadau cyfrifon, diweddariadau trafodion a chanlyniadau prosesu.

Defnydd webbachau o fewn systemau Cross River i'ch hysbysu pan fydd gwahanol ddigwyddiadau'n digwydd. Mae'r digwyddiad yn dychwelyd gwrthrych adnoddau sy'n cynnwys manylion perthnasol am bwnc pob digwyddiad. Mae manylion llawn y digwyddiad wedi'u cynnwys a'u hanfon i'ch system.

Rydym yn defnyddio webbachau i roi'r wybodaeth ddiweddaraf i chi am statws ac i adrodd am newidiadau i drafodion. WebMae bachynnau'n adrodd i'ch system gyda hysbysiadau amser real pan fydd digwyddiad yn digwydd.

Rhaid i chi gofrestru trwy API i'w ddefnyddio webbachau:

Cofrestru ar gyfer cyfrifon, cardiau a digwyddiadau talu

Cofrestru ar gyfer digwyddiadau taliadau cerdyn

Cofrestru ar gyfer digwyddiadau Benthyca

2.5. Amgylcheddau blwch tywod

Mae ein blwch tywod yn amgylchedd cwbl ynysig, felly mae croeso i chi arbrofi. Pan fyddwch chi'n barod i symud i gynhyrchu, rhowch wybod i ni a byddwn ni'n rhoi'r manylion cynhyrchu i chi i gael mynediad i'r amgylchedd byw.

Rheoli cwsmeriaid

Sylfaen y Modiwl URL ar gyfer galwadau API

Rheoli cwsmeriaid https://sandbox.crbcos.com/core/ Cyfrifon

Sylfaen y Modiwl URL ar gyfer galwadau API

Cyfrifon blaendal

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

Sgubiadau blaendal https://sandbox.crbcos.com/sweepsintrafi/ Cardiau

Sylfaen y Modiwl URL ar gyfer galwadau API

Cardiau https://sandbox.crbcos.com/cardmanagement/Taliadau

Sylfaen y Modiwl URL ar gyfer galwadau API

Taliadau Ar Unwaith

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

Taliadau cerdyn: Gwthio i dalu

https://pushtopaystaging.crbnj.net/

Taliadau cerdyn: Tynnu

https://pullfromcardapistg.crbnj.net/

Taliadau Rhyngwladol

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

ACH

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

Gwifrau

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

Sieciau https://sandbox.crbcos.com/checks/ COSwebbachau

Sylfaen y Modiwl URL ar gyfer galwadau API

COS webbachau

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

Benthyg

Sylfaen y Modiwl URL ar gyfer galwadau API

Tarddiad benthyciad

https://arixapisandbox.crbnj.net

Penderfynu ar y Cais https://lendingsandbox.crbcos.com/preapproval/v1

2.6. Casgliad postmon

Er mwyn gwneud datblygu'n haws, rydym wedi llunio un sydd wedi'i adeiladu ymlaen llaw.

Casgliad postmon ceisiadau ar gyfer yr holl Cross River. Defnyddiwch y casgliad hwn i archwilio, profi ac adeiladu pwyntiau terfyn API eich integreiddio'n uniongyrchol yn Postman. gyda'r codio a'r gosodiad ychwanegol lleiaf sydd eu hangen. I fforchio ein casgliad ar unwaith, cliciwch

Cwblhewch y manylion sefydlu, a dechreuwch wneud galwadau yng nghasgliad Postman Sandbox drwyddo.

Postmon

Tocyn mynediad (cludwr)

Rydym wedi creu ein hamgylchedd blwch tywod datblygwyr Postman i ddarparu lle diogel i brofi APIs Cross River. Yng nghasgliad Cross River Postman, rydych chi'n perfformio dilysu gan ddefnyddio tocyn cludwr.

I gael yr IDau mae angen i chi sefydlu'r tocyn mynediad (cludwr) sydd ei angen i redeg y casgliad:

1. Gyda'r manylion mewngofnodi hyn rydych chi'n gofyn am ac yn derbyn tocyn mynediad

Cael manylion mewngofnodi API
i'w ddefnyddio ar gyfer anfon APIs yn ein hamgylchedd blwch tywod

2. Unwaith y byddwch yn derbyn eich manylion mewngofnodi API a chyn y gallwch ddefnyddio ein

Cael tocyn mynediad
APIs, rydych chi'n cael tocyn mynediad gan ddefnyddio'r cleient_id cleient_gyfrinach a gawsoch pan wnaethoch gofrestru.

Casgliad Croesi Afon Fork

Ewch yn syth i'n siop ni i gael ein casgliad.

Gweithle postmon

Ar ôl fforchio, peidiwch ag anghofio gosod eich newidynnau amgylcheddol ar gyfer y blwch tywod.

Ffurfweddwch amgylchedd eich Postman

I ddefnyddio'r casgliad rydych chi newydd ei greu, llywiwch ato, cliciwch Amgylcheddau, a dewis Blwch tywodCopïwch eich ID cleient Cross River a'ch cyfrinach cleient, a'u gludo i'r ID_cleient cleient_gyfrinach meysydd. Ar gyfer Taliadau Cerdyn, gludwch nhw i'r ptpe_client_id cyfrinach_cleient_ptpe caeau.

Nawr rydych chi'n barod i gael tocyn a dechrau anfon ceisiadau.

1. Rhedeg Awdurdodi/Cael tocyn i gynhyrchu eich tocyn. Ar gyfer Taliadau Cerdyn, rhedeg Taliadau Cerdyn/Awdurdodi/Cael tocyn P2PE .

2. Y newidyn {{token}} (neu tocyn_ptpe ar gyfer Taliadau Cerdyn) yn cael ei ychwanegu'n awtomatig at eich amgylchedd gan sgript ôl-ymateb. Pan fydd y tocyn yn dod i ben mae angen i chi ddilyn cam 1 eto.

3. Mae yna sawl newidyn y gallai fod angen i chi eu llenwi yn dibynnu ar ba bwynt terfynol rydych chi'n ymarfer corff. Er enghraifftample, partner_id cynnyrch_id cyfluniad_id galwad yn ôl_url .

4. Mae yna hefyd rai newidynnau sy'n cael eu llenwi trwy sgriptiau, fel tocyn tocyn_ptpe na ddylid ei lenwi â llaw.

Pingthesandbox

Rhedeg prawf syml i wirio y gallwch gysylltu â'r blwch tywod Cross River.

I anfon cais Ping, agorwch yn Postman Casgliadau > Casgliad API Cross River > Awdurdodiad a rhedeg y Ping diweddbwynt.

Addasu ceisiadau

I ddiweddaru cais, gwnewch eich newidiadau ar y Corff tab. Gwerthoedd mewn c dwblurlMae cromfachau y yn tynnu o'ch newidynnau amgylcheddol. Edrychwch ar ein dogfennau API i weld pa feysydd sydd gan bob un.

mae'r pwynt terfyn yn derbyn, a view ceisiadau yn eich iaith ddewisol.

3. Adeiladu felample ap

Cam 1
Cael manylion mewngofnodi API Gosod

Cam 2
Cael Tocyn Mynediad

Cam 3
Defnyddiwch y Tocyn Mynediad

Cam 4
Adeiladu Sample App

Cyn i chi ddechrau, cyfeiriwch at ein canllaw cychwyn cyflym i gysylltu â'n APIs. I brofi'r galwadau API, gallwch ddefnyddio cURL o'r llinell orchymyn, neu wasanaeth fel Postman neu Swagger yn ein blwch tywod.

Cwsmeriaid a chyfrifon
Cyn i chi ddefnyddio gwasanaethau Cross River, mae angen i chi greu cofnod cwsmer ar gyfer pob un o'ch cwsmeriaid

Cardiau
Rheoli cardiau eich cwsmeriaid drwy weithio gyda Cross River i benderfynu beth rydych chi am ei gynnig, fel cardiau ffisegol neu rithwir.

Benthyg
Mae benthyca yn cynnwys set o alwadau APIs benthyca i ganiatáu ichi greu, diweddaru, a rheoli eich benthyciadau.

3.1. Gosod

Cyn i chi ddechrau, cyfeiriwch at ein canllaw i gysylltu â'n APIs. I brofi'r cychwyn cyflym API

galwadau, gallwch ddefnyddio cURL o'r llinell orchymyn, neu wasanaeth fel Postman neu Swagger yn ein blwch tywod.

I greu ap cerdyn neu dalu, rhaid i chi greu cyfrifon cwsmeriaid a chyfrifon.

Archwilio blwch tywod

Mae gennym ni lawer i chi ei archwilio. Mae'r blwch tywod yn amgylcheddau blwch tywod cwbl ynysig o'r amgylchedd cynhyrchu, felly mae croeso i chi arbrofi. Pan fyddwch chi'n barod i symud i gynhyrchu, siaradwch â'ch rheolwr perthynas, a fydd yn rhoi'r manylion mewngofnodi cynhyrchu i chi er mwyn cael mynediad i'r amgylchedd byw.

Cofrestru perthnasol web digwyddiadau bachyn

WebMae bachau yn elfen bwysig o unrhyw integreiddio â Cross River. Er bod APIs yn caniatáu ichi ofyn am ddata ar alw, webMae bachau'n gwthio diweddariadau amser real yn uniongyrchol i'ch system—gan ddileu'r angen am bleidleisio cyson a lleihau oedi. Mewn llawer o achosion, webMae bachau'n fwy effeithlon a dibynadwy nag APIs yn unig, gan sicrhau bod eich cymhwysiad yn aros mewn cydamseriad â digwyddiadau hanfodol fel newidiadau cyfrifon, diweddariadau trafodion a chanlyniadau prosesu.

Cofrestrwch i dderbyn webdigwyddiadau bachyn. Pryd webmae digwyddiadau bachyn yn cael eu sbarduno, y digwyddiad anfonir gwrthrychau at y safle cofrestredig URLs.

3.2. Cwsmeriaid a chyfrifon

Cam 1
Cael manylion mewngofnodi API

Cam 2
Cael Tocyn Mynediad

Cam 3
Defnyddiwch y Tocyn Mynediad

Cam 4
Adeiladu Sample App

Creu cofnod cwsmer a chyfrif wedi'i ariannu:

Creu cofnod cwsmer

Creu cyfrif blaendal

Ariannu cyfrif

Creu cofnod cwsmer

Cyn i chi ddefnyddio gwasanaethau Cross River, mae angen i chi greu cofnod cwsmer ar gyfer pob un o

eich cwsmeriaid. Mae'r broses o ymsefydlu cwsmeriaid yn cynnwys creu cofnod cwsmer gyda gwybodaeth berthnasol am gwsmeriaid.

Caiff pob cwsmer ei sganio'n awtomatig at ddibenion cydymffurfio â rheoliadau, felly mae angen i chi gofrestru ar gyfer y rhai perthnasol webdigwyddiadau bach i dderbyn diweddariadau statws cofnodion cwsmeriaid.

Gall y cofnod cwsmer fod ar gyfer y naill ai Personol or Busnes cwsmeriaid. Ar ôl cofrestru, gellir cysylltu cwsmer ag un neu fwy o gyfrifon.

Webbachau

Cofrestrwch canys webbachau. Y canlynol webdefnyddir bachau:

WebDisgrifiad bachyn

Cwsmer.Craidd.Wedi'i.Fywio

Yn eich hysbysu bod cofnod y cwsmer wedi'i greu

Swyddfa.Cwsmer.Craidd.Wedi.Newid.

Yn eich hysbysu bod statws OFAC cwsmer wedi'i ddiweddaru

Newid.Cwsmer.Craidd.PepScan.Cad

Nyn eich hysbysu bod statws PEP cwsmer wedi'i ddiweddaru

Exampcreu recordiau Leof

Yn y cynample, byddwn yn cofrestru John Smith. Yn gyntaf, gadewch i ni greu cofnod cwsmer. Rydym yn cofrestru John fel Personol cwsmer.

I ymuno â chwsmer busnes, crëwch gofnod cwsmer personol yn gyntaf ar gyfer y prif berchennog y busnes hwnnw. Ar ôl hynny, crëwch gwsmer busnes ac ychwanegwch y cofnod personol fel perchennog buddiol.

Galwch POST /core/v1/cm/customers .

Yn y cynamppa nodweddion y gallwch eu gweld sy'n ofynnol.

PWYSIG

Rydym yn argymell yn gryf eich bod yn cynnwys allwedd idempotency yn eich pennawd cais

i ddarparu amddiffyniad dyblyg rhag ofn methiant.

Curl

curl -X POST /core/v1/cm/customers –pennawd 'Math-Cynnwys: cais/j {

 “ID partner”“6e80b097-693c-4592-8440-02f345335bbf”,

 “enw”{

 “Enw cyntaf”“Ioan”,

 “cyfenw”“Smith”

 },

 “dosbarthiad”“Personol”,

 “profile"{

 “regO”ffug,

 “Person Gwleidyddol Agored”ffug,

 “MathIDTreth”“Ssn”,

 “ID treth”“119988776”,

 "Dyddiad Geni"“1953-09-22”,

 “Sgôr Risg”“Isel”

 “Cyfeiriad Cynradd”{

 “MathCyfeiriad”“Cartref”,

 “dosbarthiad”“Preswyl”,

 “isPrimary”gwir,

 “stryd1”“123 Unrhyw Stryd”,

 "dinas"“Unrhyw le”,

 “gwladwriaeth”“NY”,

 “Cod Post”“12345”,

 “Cod gwlad”“UD”

 },

 “Prif Ffôn”{

 “isPrimary”gwir,

 “Math o ffôn”“Cartref”,

 “Rhif ffôn”“2015551234”

 },

 “E-bost cynradd”{

 “isPrimary”gwir,

 “MathE-bost”“Personol”,

 “Cyfeiriad E-bost”“John.Smith@xxxxx.com”

 }

}

Mae galwad API lwyddiannus yn dychwelyd ymateb JSON gyda'r ID cwsmer unigryw yn llinell gyntaf corff yr ymateb. Mae eich cwsmer wedi'i greu.

Ymsefydlu corff ymateb cwsmeriaid

{

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

 “Rhif cif”“32653745014”,

 “dosbarthiad”“Personol”,

 "statws"“Gweithredol”,

 “ofac”“Yn yr arfaeth”,

 “pepScan”“Yn yr arfaeth”,

 “enw”: {

 “Enw cyntaf”“Ioan”,

 “cyfenw”“Smith”,

 “Enw llawn”“John Smith”

 },

 “profile": {

 “regO”ffug,

 “Person Gwleidyddol Agored”ffug,

 “galluogiAtalCopïau Wrth Gefn”ffug,

 “MathIDTreth”“Ssn”,

 “ID treth”“119988776”,

 "Dyddiad Geni"“1953-09-22”,

 “Sgôr Risg”“Isel”

 },

 “wedi’i greuYn”“2021-01-25T17:55:24.4422582-05:00”,

 “Wedi'i Addasu DiwethafYn”“2021-01-25T17:55:24.4432543-05:00”,

 “ID partner”“6e80b097-693c-4592-8440-02f345335bbf”

}

Mae'r Cwsmer.Craidd.Wedi'i.Fywio webMae digwyddiad bachyn yn cael ei sbarduno pan fydd cofnod y cwsmer yn cael ei greu.

Digwyddiad ymuno â chwsmeriaid

{

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

 “EnwDigwyddiad”“Cwsmer.Craidd.Wedi.Ymsefydlu”,

 "statws"“Yn yr arfaeth”,

 “ID partner”“30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 “wedi’i greuYn”“2021-11-22T10:50:20.553-05:00”,

 “adnoddau”: [

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

 “manylion”: []

}

Mae Cross River yn sganio cofnod y cwsmer newydd am gydymffurfiaeth OFAC a PEP.

Weithiau mae angen ail-ymchwilio ar ganlyniadau'r sganview gan ein tîm Gwrth-Wyngalchu Arian (AML).

Ar ôl cwblhau'r sgan, Swyddfa.Cwsmer.Craidd.Wedi.Newid. a

Craidd.Cwsmer.PepScan.Newidiwyd. webMae digwyddiadau bachyn yn dychwelyd gyda statws. Mae cwsmeriaid heb unrhyw broblemau cydymffurfio yn dangos Clir statws.

Sgan OFAC cwsmer wedi'i newid

{

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

 “EnwDigwyddiad”“Newidiwyd.Ofac.Cwsmeriaid.Craidd”,

 "statws"“Yn yr arfaeth”,

 “ID partner”“30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 “wedi’i greuYn”“2021-11-22T10:51:53.657-05:00”,

 “adnoddau”: [

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

 “manylion”: []

}

Sgan PEP cwsmer wedi'i newid

{

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

 “EnwDigwyddiad”“Newidiwyd.PepScan.Cwsmer.Craidd”,

 "statws"“Yn yr arfaeth”,

 “ID partner”“30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 “wedi’i greuYn”“2021-11-22T10:51:53.597-05:00”,

 “adnoddau”: [

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

 “manylion”: []

}

Rydych chi bellach wedi creu cofnod cwsmer.

Diweddaru cofnod cwsmer

Mae'n bosibl diweddaru manylion y cwsmer fel cyfeiriad, rhif ffôn ac e-bost. Ystyrir y manylion hyn. cynradd gwybodaeth. Os ydych chi'n ychwanegu ail gyfeiriad, dyma eilradd.

Defnyddiwch y ID cwsmer a ddychwelwyd pan fyddwch chi'n creu'r cofnod cwsmer i ffonio POST /core/v1/cm/customers/{id}/addresses i ychwanegu'r. Cyfeiriad y cwsmer cyntaf

y cyfeiriad rydych chi'n ei ychwanegu yw'r cynradd cyfeiriad. Yn yr enghraifft ganlynolamplle gallwch weld pa briodoleddau sydd eu hangen.

Diweddaru cyfeiriad y cwsmer

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

 “MathCyfeiriad”“Cartref”,

 “dosbarthiad”“Preswyl”,

 “isPrimary”gwir,

 “stryd1”“123 Unrhyw Stryd”,

 "dinas"“Unrhyw le”,

 “gwladwriaeth”“NY”,

 “Cod Post”“12345”,

 “Cod gwlad”“UD”

}

Galwch POST /core/v1/cm/customers/{id}/phones i ychwanegu y

ffôn cwsmer

Y rhif ffôn cyntaf rydych chi'n ei ychwanegu yw'r cynradd rhif ffôn.

rhif

Diweddaru rhif ffôn y cwsmer

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

 “isPrimary”gwir,

 “Math o ffôn”“Symudol”,

 “Rhif ffôn”“2015552345”

}

Galwch POST /core/v1/cm/customers/{id}/email i ddiweddaru e-bost y cwsmer .

Diweddaru e-bost cwsmer

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

 “isPrimary”gwir,

 “MathE-bost”“Personol”,

 “Cyfeiriad E-bost”“john.jones@xxx.com”

}

Creu cyfrif blaendal

Mae CR yn darparu nifer o wahanol fathau o gyfrifon, gan gynnwys siec a chynilion, Tystysgrifau Adneuo (CDs neu gyfrifon blaendal amser), a mwy.

I agor unrhyw fath o gyfrif blaendal rhaid i chi gael ID cynnyrch dilys ar gyfer y math o gyfrif rydych chi am ei agor, ac ID cwsmer (ID cofnod cwsmer wedi'i fewnosod) ar gyfer deiliad y cyfrif. Sylwch fod yn rhaid i ddeiliad y cyfrif gael o leiaf un cyfeiriad a rhif ffôn yn ei gofnod cwsmer, a rhaid i'w statws OFAC fod ClirYn ogystal, rhaid i ddosbarthiad y cwsmer gyd-fynd â'r dosbarthiad a ffurfiwyd ar gyfer y cynnyrch. Er enghraifftample, dim ond cwsmeriaid busnes y gellir eu hychwanegu at gynnyrch busnes.

Cyn i chi ddechrau

Gwnewch yn siŵr bod gennych chi:

manylion mewngofnodi API

ID Partner (a gawsoch pan wnaethoch gofrestru)

ID Cwsmer

ID Cynnyrch (yn diffinio'r math o gyfrif sy'n cael ei agor)

PWYSIG

Rydym yn argymell yn gryf eich bod yn cynnwys allwedd idempotency ym mhennawd y cais i atal taliadau dyblyg rhag ofn methiant.

Pwyntiau terfyn a webbachau

Defnyddir y pwynt terfyn API canlynol:

Disgrifiad API

Agor cyfrif blaendal Yn agor cyfrif blaendal ar gyfer cwsmer

Y canlynol webdefnyddir bachyn:

WebDisgrifiad bachyn

Cyfrif.Craidd.Wedi'i.Agor Agorwyd cyfrif newydd

Agor cyfrif

Yn y senario canlynol, byddwch yn agor cyfrif i John Smith, cwsmer rydych chi wedi'i gofrestru'n llwyddiannus.

I agor cyfrif

Galwch POST core/v1/dda/accounts Ar gyfer yr alwad hon, mae angen rhai priodoleddau. Gweler y fersiwn lawn.

rhestr o briodoleddau

Sample cais

POST /core/v1/dda/accounts

{

 “ID cwsmer”“59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 “ID cynnyrch”“44015e68-1afb-40fc-9497-abc1014f52da”,

 “teitl”“John Smith”,

 “CyfeiriadDatganiad”{

 “stryd1”“257 Dalton Groves”,

 "dinas"“Dinas Barton”,

 “gwladwriaeth”“MI”,

 “Cod Post”“48705”,

 “Cod gwlad”“UD”

 }

}

Mae galwad API lwyddiannus yn dychwelyd ymateb JSON gyda manylion y cyfrif newydd.

Sample ymateb

SWYDD /craidd/v1/dda/cyfrifon

{

 “ID cwsmer”“59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 “ID cynnyrch”“44015e68-1afb-40fc-9497-abc1014f52da”,

 “teitl”“John Smith”,

 “CyfeiriadDatganiad”: {

 “stryd1”“257 Dalton Groves”,

 "dinas"“Dinas Barton”,

 “gwladwriaeth”“MI”,

 “Cod Post”“48705”,

 “Cod gwlad”“UD”

 }

}

Mae'r RhifCyfrif Mae'r maes yn darparu rhif y cyfrif ar gyfer y cyfrif newydd.

Yn yr ymateb example, mae'r cyfrif wedi'i ddosbarthu fel Personol oherwydd bod y defnyddiwr wedi ffurfweddu'r dosbarthiad cynnyrch fel PersonolMae dosbarthiad y cyfrif bob amser yn cyfateb i ddosbarthiad y cynnyrch sydd wedi'i ffurfweddu.

Mae statws y cyfrif yn cael ei ddiweddaru'n awtomatig i Actif , ac mae ar gael i'w ddefnyddio ar unwaith. Mae hyn yn sbarduno'r Cyfrif.Craidd.Wedi'i.Agor digwyddiad.

Manylion Digwyddiad Core.Account.Opened

{

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

 “EnwDigwyddiad”“Cyfrif.Craidd.Wedi.Agor”,

 "statws"“Yn yr arfaeth”,

 “ID partner”“e6c3824a-377f-44d5-a2f6-a9a600c9b37e”,

 “wedi’i greuYn”“2021-01-26T09:48:10.1011462-05:00”,

 “adnoddau”: [

 “craidd/v1/dda/cyfrifon/2235223803”

 ],

 “manylion”: []

}

Cyfrif Cronfa

Pan fyddwch chi'n gweithio yn y blwch tywod i brofi rheiliau talu ac ymddygiad cyfrifon mae angen i chi gael arian mewn cyfrif.

Gallwch ddefnyddio unrhyw reilffordd sydd â phwynt terfyn efelychu mewnol i ariannu cyfrif blwch tywod, os yw'r cyfrif wedi'i ffurfweddu ar ei gyfer. Yn benodol, gallwch:

Efelychu taliadau ACH sy'n dod i mewn

Efelychu gwifren sy'n dod i mewn

Ar gyfer unrhyw efelychiad, bydd angen rhif y cyfrif blwch tywod Cross River yr hoffech ei ariannu arnoch. Nid yw gwybodaeth y cychwynnydd yn bwysig, ac mewn rhai achosion gall hyd yn oed fod yn gwbl ffuglennol.

Camau Nesaf

Edrychwch ar ein taliad.

tiwtorialau

3.3. Cardiau

Cam 1
Cael manylion mewngofnodi API

Cam 2
Cael Tocyn Mynediad

Cam 3
Defnyddiwch y Tocyn Mynediad

Cam 4
Adeiladu Sample App

Dysgwch sut i weithio gydag APIs Cross River. Mae'r dudalen hon yn dangos i chi sut i:

Creu cerdyn

Actifadu cerdyn

Creu cerdyn

Rheoli cardiau eich cwsmeriaid drwy weithio gyda Cross River i benderfynu beth rydych chi am ei gynnig, fel cardiau ffisegol neu rithwir. Dyma'r ffurfweddiad cerdynMae Cross River yn creu pro ffurfweddu cardiaufile i chi ar gyfer pob math a ddewiswch ar gyfer eich offeryn ariannol cwsmeriaid.

Cyn i chi ddechrau

Gwnewch yn siŵr eich bod chi'n gwneud ac yn cael:

Creu cofnod cwsmer

Creu cyfrif blaendal

Rhif cyfrif deiliad y cerdyn

ID Cwsmer (rydych chi'n cael hwn pan fyddwch chi'n creu cwsmer)

ID Ffurfweddu (Mae Cross River yn darparu ID i chi pan fyddwch chi'n ffurfweddu'ch math/cerdyn)

Rydym hefyd yn argymell eich bod ar gyfer y perthnasol webdigwyddiadau bachyn. cofrestru

Pwyntiau Terfynol awebbachau

Cofrestrwch canys webbachau. Defnyddir y pwyntiau terfyn API canlynol:

Disgrifiad API

Creu cerdyn newydd Gofynion am greu cerdyn debyd newydd

Y canlynol webdefnyddir bachau:

WebDisgrifiad bachyn

Cardiau.Cerdyn.Wedi'i.Grëu Cerdyn debyd wedi'i greu

Archebucard

Byddwch yn dysgu sut i archebu/creu cerdyn debyd newydd drwy greu cerdyn ar gyfer John Smith.

Galwch POST /rheolicardiau/v1/cardiau .

Yn y cynampgallwch weld pa briodoleddau sydd eu hangen. Gweler manylion yr API cyflawn.

Ychwanegu cerdyn

Sampcreu cerdyn

curl -X POST /rheolicardiau/v1/cardiau –pennawd 'Math-Cynnwys: cais “RhifCyfrif”: “2608927303”, \  

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

 “IDcyfluniad”: “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”, \ “enwcyntaf”: “Ioan”, \  

 “cyfenw”: “Smith”, \  

 "ffôn": { \  

 “Mathffôn”: “Cartref”, \  

 “RhifFfôn”: “9133413131” \  

 }, \  

 “Cyfeiriad E-bost”: “John.Smith@xxxxx.com”, \  

 “Cyfeiriad Llongau”: { \  

 “stryd1”: “Lôn Heol”, \  

 “stryd2”: “llinyn”, \  

 “dinas”: “Tref Fawr”, \  

 “talaith”: “IL”, \  

 “Cod Post”: “72410”, \  

 “Cod gwlad”: “UDA” \  

 }, \  

 “Cyfeiriad Bilio”: { \  

 “stryd1”: “Lôn Heol”, \  

 “stryd2”: “llinyn”, \  

 “dinas”: “Tref Fawr”, \  

 “talaith”: “IL”, \  

 “Cod Post”: “72410”, \  

 “Cod gwlad”: “UDA” \  

 }, \  

 “enwAr y Gerdyn”: “John Smith”, \  

 “MathLlongau”: “Arferol”, \  

 “DynodwrClient”: “llinyn” \  

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

Mae galwad API lwyddiannus yn dychwelyd ymateb JSON gyda manylion y cerdyn newydd. Ni fydd statws y cerdyn wedi'i actifadu nes i chi actifadu'r cerdyn. ID y cerdyn yw'r ID, yn hyn o beth. example 8709163d-140c-4d95-a111-afa8009e9cd1, y bydd angen i chi ei wneud actifadu y cerdyn.

Samparchebu ymateb cerdyn

{

 "ID"“8709163d-140c-4d95-a111-afa8009e9cd1”,  “ID partner”“cd9c12f4-7691-424a-b38b-af5b0134c611”,  “ID cynnyrch”“83bed086-8182-4151-a1e3-af5b01362783”,  “Rhif Cyfrif”“2608927303”,

 "statws"“Heb ei actifadu”,

 “CodRheswmStatws”“Heb ei Osod”,

 “Enw cyntaf”“Ioan”,

 “cyfenw”“Smith”,

 “Cyfeiriad Llongau”: {

 “stryd1”“Lôn Heol”,

 “stryd2”"llinyn",

 "dinas"“Tref Fawr”,

 “gwladwriaeth”“IL”,

 “Cod Post”“72410”,

 “Cod gwlad”“UD”

 },

 “Cyfeiriad Bilio”: {

 “stryd1”“Lôn Heol”,

 “stryd2”"llinyn",

 "dinas"“Tref Fawr”,

 “gwladwriaeth”“IL”,

 “Cod Post”“72410”,

 “Cod gwlad”“UD”

 },

 "ffôn": {

 “Math o ffôn”“Cartref”,

 “Rhif ffôn”“9133413131”

 },

 “Cyfeiriad E-bost”“john@anygoogle.com”,

 “enwArGerdyn”“John Smith”,

 “isPINSet”ffug,

 “Wedi'i Rhwystro gan y gweinyddwr”ffug,

 “Twyllwr Amheus”ffug,

 “ID ffurfweddu”“a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  “categori”“Credyd”,

 “Offeryn Talu”“Pan Rhithwir”,

 “prosesydd”"enw'r prosesydd",

 “Math cludo”“Arferol”,

 “StatwsArcheb”“Archeb yn yr Arfaeth”,

 “StatwsAmnewid”“Ddim yn berthnasol”,

 “ID cwsmer”“2b15a695-13dc-4b10-b4e5-af5b0138873c”,  “DynodwrClient”"llinyn",

 “wedi’i greuYn”“2023-02-13T04:37:29.4869172-05:00”,

 “Wedi'i Addasu DiwethafYn”“2023-02-13T04:37:29.4869172-05:00”

}

Mae'r Cardiau.Cerdyn.Wedi'i.greu webMae digwyddiad bachyn yn cael ei sbarduno pan gynhyrchir y cerdyn gan y prosesydd.

SampDigwyddiad Creu Cardiau.Card.

{

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

 “EnwDigwyddiad”“Cardiau.Cerdyn.Wedi'i.Grëu”,

 "statws"“Yn yr arfaeth”,

 “ID partner”“cd9c12f4-7691-424a-b38b-af5b0134c611”,

 “wedi’i greuYn”“2023-02-13T04:42:29.4869172-05:00”,

 “adnoddau”: [

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

 “manylion”: [

 {

 “ID y cerdyn”“8709163d-140c-4d95-a111-afa8009e9cd1”,

 "statws"“Heb ei actifadu”,

 “CodRheswmStatws”“Heb ei Osod”

 }

 ]

}

Actifadu'r cerdyn

Cyn i chi ddechrau

Gwnewch yn siŵr bod gennych chi:

manylion mewngofnodi API

ID y cerdyn o'r adeg y gwnaethoch chi archebu'r cerdyn

Pwyntiau Terfynol awebbachau

Disgrifiad API

POST /cardmanagement/v1/cards/{id}/activate Yn actifadu'r cerdyn gan ddefnyddio ID y cerdyn Mae'r tiwtorial yn defnyddio'r rhain webbachau:

WebDisgrifiad bachyn

Cardiau.Card.Wedi'i Actifadu Cerdyn debyd wedi'i actifadu

Actifadu'r cerdyn

Actifadu'r cerdyn a greoch yn yr stage.

creu cerdyn

Galwch POST /rheolicardiau/v1/cardiau/{id}/actifadu . Mae'r id rhaid gosod y priodoledd i ID y cerdyn. Yn yr sampislaw'r ID yw 8709163d-140c-4d95-a111 afa8009e9cd1.

Sampcais am actifadu cerdyn

curl -X SWYDD  

–pennawd 'Derbyn: application/json'

–pennawd 'Awdurdodiad: Cludwr'<tocyn>'

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

Mae galwad API lwyddiannus yn dychwelyd ymateb JSON gyda manylion y cerdyn. Y cerdyn statws yn awr actifadu. Mae'r Statws yr Archeb is Cwblhawyd.

Sampymateb actifadu'r cerdyn

{

 "ID"“8709163d-140c-4d95-a111-afa8009e9cd1”,  “ID partner”“cd9c12f4-7691-424a-b38b-af5b0134c611”,  “ID cynnyrch”“83bed086-8182-4151-a1e3-af5b01362783”,  “IDCerdynProsesydd”“804951250206718”,

 “Rhif Cyfrif”“2608927303”,

 "statws"“Gweithredol”,

 “CodRheswmStatws”“Heb ei Osod”,

 “Enw cyntaf”“Ioan”,

 “cyfenw”“Smith”,

 “Cyfeiriad Llongau”: {

 “stryd1”“Lôn Heol”,

 “stryd2”"llinyn",

 "dinas"“Tref Fawr”,

 “gwladwriaeth”“IL”,

 “Cod Post”“72410”,

 “Cod gwlad”“UD”

 },

 “Cyfeiriad Bilio”: {

 “stryd1”“Lôn Heol”,

 “stryd2”"llinyn",

 "dinas"“Tref Fawr”,

 “gwladwriaeth”“IL”,

 “Cod Post”“72410”,

 “Cod gwlad”“UD”

 },

 "ffôn": {

 “Math o ffôn”“Cartref”,

 “Rhif ffôn”“9133413131”

 },

 “Cyfeiriad E-bost”“john@anygoogle.com”,

 “enwArGerdyn”“John Smith”,

 “panLastPead”“3629”,

 “isPINSet”ffug,

 “Dyddiad Dod i Ben”“2026-02-13”,

 “Wedi'i Rhwystro gan y gweinyddwr”ffug,

 “Twyllwr Amheus”ffug,

 “ID ffurfweddu”“a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  “categori”“Credyd”,

 “Offeryn Talu”“Pan Rhithwir”,

 “prosesydd”"enw'r prosesydd",

 “Math cludo”“Arferol”,

 “StatwsArcheb”“Wedi'i gwblhau”,

 “StatwsAmnewid”“Ddim yn berthnasol”,

 “ID cwsmer”“2b15a695-13dc-4b10-b4e5-af5b0138873c”,

 “DynodwrClient”"llinyn",

 “IDCwsmerProsesydd”“T83E9D675A3N3N9O8RZ1”,

 “wedi’i greuYn”“2023-02-13T04:37:29.487-05:00”,

 “Ymgorffori cychwynnol”“2023-02-13T00:00:00-05:00”,

 “wedi’i actifadu’n”“2023-02-13T04:43:19.282287-05:00”,

 “Wedi'i Addasu DiwethafYn”“2023-02-13T04:43:19.2962845-05:00”

}

Pan fydd statws y cerdyn yn newid i Actif , y Cardiau.Card.Wedi'i Actifadu webtanau digwyddiad bachyn.

Cardiau.Card.Wedi'i Actifadu webdigwyddiad bachyn

{

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

 “EnwDigwyddiad”“Cardiau.Cerdyn.Wedi'i.Actifadu”,

 "statws"“Yn yr arfaeth”,

 “ID partner”“cd9c12f4-7691-424a-b38b-af5b0134c611”,

 “wedi’i greuYn”“2023-02-13T04:44:31.282287-05:00”,

 “adnoddau”: [

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

 “manylion”: [

 {

 “ID y cerdyn”“8709163d-140c-4d95-a111-afa8009e9cd1”,

 "statws"“Gweithredol”,

 “CodRheswmStatws”“Heb ei Osod”

3.4. Benthyg

Cam 1
Cael manylion mewngofnodi API

Cam 2
Cael Tocyn Mynediad

Cam 3
Defnyddiwch y Tocyn Mynediad

Cam 4
Adeiladu Sample App

Mae benthyca yn cynnwys set o alwadau i ganiatáu ichi greu, diweddaru a rheoli API benthyca eich benthyciadau.

I ddechrau gweithio gyda benthyca, gwnewch yn siŵr eich bod chi:

Derbyn manylion mewngofnodi API gyda'r cwmpasau sydd eu hangen ar gyfer Benthyca

Os ydych chi wedi creu'r Manylion Cymwysterau API, gan ddefnyddio'r hunanwasanaeth Rheoli

, yna dylech chi hefyd anfon cais at

arix.support@crossriver.com

Org, ynghyd â'ch clientid ac MPLID, i gwblhau y greadigaeth.

Defnyddiwch y cwmpas cywir, ar gyfer yr APIs rydych chi am eu defnyddio.

Cwmpas API ar gyfer y blwch tywod yw: CosLending:PreApproval:stg

Blwch tywod

Sylfaen y Modiwl URL ar gyfer galwadau API Disgrifiad

Benthyciad tarddiad

Penderfynu ar geisiadau

https://arixapisandbox.crbnj. net

Y sylfaen URL ar gyfer galwadau API tarddiad benthyciadau i amgylchedd blwch tywod Arix

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

Y sylfaen URL ar gyfer blwch tywod o

penderfyniadau ar geisiadau

Swagger

Cyswllt Swagger y Modiwl

Cyfeirnod API

dogfennaeth

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

Bachau

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

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

Tudalen Statws

I weld rhestr o ryddhadau sydd ar ddod, monitro statws cyfredol yr API, view adroddiadau digwyddiadau, neu gael gwybod am waith cynnal a chadw wedi'i drefnu, ewch i'n tudalen statws a thanysgrifiwch i hysbysiadau rhybuddion.

4. Gosodiad rhaglen

Gosod SFTP: Defnyddiwch SFTP naill ai i anfon fileneu i'w lawrlwytho o Cross River, yn ôl eich anghenion chi a'n hanghenion ni.

Ymsefydlu cwsmeriaid: Rheoli gwybodaeth eich cwsmeriaid yn Cross River system weithredu (COS) gan ddefnyddio naill ai APIs neu COS explorer

Mathau o gynhyrchion ac IDau COS: Esbonio mathau o gynhyrchion ac IDau COS.

Archwiliwr COS: Sut i weithio gyda'n COS Explorer.

Porth rheoli sefydliad: Sut i weithio gyda'n porth rheoli sefydliad.

4.1. Gosod SFTP

Pan fydd angen i chi gyfnewid gwybodaeth sensitif mewn file fformat gyda Cross River, mae angen i chi ddefnyddio Secure File Protocol Trosglwyddo (SFTP). Defnyddiwch SFTP naill ai i anfon fileneu i'w lawrlwytho o Cross River, yn ôl eich anghenion chi a'n hanghenion ni. Mewn rhai achosion, byddwch chi neu ni yn amgryptio'r rhain files, yn enwedig os ydynt yn cynnwys unrhyw Wybodaeth Adnabod Bersonol (PII).

Gan ddefnyddio SFTP

Mae SFTP yn gadael i chi anfon a derbyn sensitifrwydd yn ddiogel fileac adroddiadau gan ddefnyddio ffolder a neilltuwyd yn benodol i'ch busnes ar weinydd diogel. Lanlwytho a lawrlwytho filedrwy'r ffolder honno neu is-ffolderi o'r ffolder honno, yn unol â'ch anghenion penodol.

Defnyddio amgryptio

Amgryptio fileMae s yn ychwanegu haen ychwanegol o ddiogelwch. Dim ond personél awdurdodedig gyda'r allwedd gywir fydd yn gallu dadgryptio'r hyn sydd wedi'i amgryptio fileYn Cross River rydym yn defnyddio amgryptio PGP.

Cychwyn arni

Mae sawl cam i'ch cael chi ar waith gyda'n gweinydd SFTP.

Rydych chi'n cwblhau'r ffurflen Cais Mynediad IP ar gyfer Gwasanaethau SFTP Cross River (gan eich RM).

Os oes angen i chi rannu filegyda Cross River, bydd eich Rheolwr Perthynas yn anfon ffurflen Cais Mynediad IP atoch ar gyfer Gwasanaethau SFTP CRB. Ymhlith gwybodaeth arall, mae angen i chi ddarparu'r cyfeiriadau IP cyhoeddus statig y byddwch yn eu defnyddio i gael mynediad i'r ffolder SFTP, ac allwedd gyhoeddus PGP ar gyfer amgryptio a dadgryptio. files. Anfonwch y ffurflen wedi'i chwblhau yn ôl at eich Rheolwr Perthynas

PWYSIG

Dim ond 5 cyfeiriad IP fydd Cross River yn eu rhoi ar y rhestr i chi, felly ystyriwch hynny. Rhaid i'r cyfeiriadau IP fod yn statig. Felly, mae angen i chi ddirprwyo unrhyw beth nad yw'n statig ar eich pen chi.

Rydym yn sefydlu strwythur eich ffolderi SFTP.

Unwaith y bydd gan Cross River eich manylion, bydd ein hadran peirianneg TG yn creu set safonol o ffolderi ac is-ffolderi i chi. Ar gyfer eich busnes yn unig y mae'r llwybr unigryw hwn. Ni all unrhyw bartner arall ei gyrchu. Mae peirianneg TG yn anfon e-bost atoch gyda'r wybodaeth sydd ei hangen arnoch i gael mynediad at y ffolderi. Mae'r e-bost yn cynnwys dolen i'ch manylion mewngofnodi. Nid yw Cross River yn cadw eich cyfrinair!

PWYSIG

Dim ond am ychydig ddyddiau y mae'r ddolen yn ddilys, ac ar ôl hynny bydd angen i chi ofyn am ailosod cyfrinair os na fyddwch chi'n ei defnyddio.

Mae'r manylion mewngofnodi hefyd yn dod yn annilys os yw mwy na dau berson yn cyrchu'r ddolen.

Profi uwchlwytho SFTP.

Os byddwch chi'n cyflenwi filei Cross River, dylai eich adran TG sefydlu cyfrif gwasanaeth gyda phroses awtomataidd ar gyfer uwchlwytho'r rheini files i'ch ffolderi SFTP. Rydym yn argymell yn gryf eich bod yn profi hyn cyn i chi geisio anfon data go iawn. Cysylltwch â'ch rheolwr perthynas gydag unrhyw gwestiynau neu broblemau neu agorwch docyn gyda'ch cymorth llinell gyntaf.

Gosod PGP i anfon neu dderbyn fileo Cross River. (Dim ond os ydych chi'n anfon neu'n derbyn PII y mae'r cam hwn yn angenrheidiol. Gwiriwch gyda'ch RM.)

Os oes angen i chi anfon Cross River files, byddwn yn anfon ein allwedd gyhoeddus PGP atoch yn gyntaf i'w defnyddio wrth amgryptio'r rheini files.

Dylech chi eisoes fod wedi anfon eich allwedd gyhoeddus PGP at Cross River i dderbyn files oddi wrthym ni.

Rhannwch eich data.

Unwaith y bydd eich ffolder SFTP wedi'i sefydlu a bod eich proses ar waith gallwch ddechrau rhannu filegyda ni. Bydd eich rheolwr perthynas yn dweud wrthych a oes rhywbeth mwy penodol y mae angen i chi ei wneud i dderbyn adroddiadau, neu sut i baratoi data i'w anfon atom ni.

Adroddiadau Penodol

Dysgu mwy am baratoi ac anfon adroddiadau a files ar gyfer:

Cyfrifon a thaliadau

Taliadau cerdyn

Risg credyd

Benthyg

Taliadau swp XML (ISO 20022)

4.2. Ymsefydlu cwsmeriaid

Rheoli gwybodaeth eich cwsmeriaid yn system weithredu Cross River (COS) gan ddefnyddio naill ai APIs neu . Mae'r wybodaeth hon yn cynnwys manylion sylfaenol sydd eu hangen i agor COS Explorer banc.

cyfrif neu ddefnyddio cerdyn credyd, yn ogystal â data mwy penodol am y cwsmer, yn ôl yr angen. Rydym yn galw hyn yn cofnod cwsmer.

Cyn y gallwch agor cyfrif blaendal neu greu cerdyn rhaid i chi greu'r cofnod cwsmer, a elwir weithiau'n arfyrddioYna gallwch chi aseinio un neu fwy o gwsmeriaid i gyfrif drwy gwsmeriaid perthnasau.

Mae'r broses o ymsefydlu cwsmeriaid yn cynnwys creu cofnod cwsmer perthnasol gwybodaeth am gwsmeriaid. Dilynwch y tiwtorial hwn i greu cofnod cwsmer ar gyfer pob un ohonoch..

Camau dewisol

Ychwanegu manylion adnabod

Ychwanegu perchennog buddiol

Codau gwall

Gweler , ynghyd â llawer o wybodaeth gyfeirio arall, ar godau gwall system COS COS

tudalen codau cyfeirio.

4.2.1. Cofnod cwsmer

Cofnod cwsmer

Y cofnod cwsmer yw'r prif adnodd sy'n cynnwys gwybodaeth am gwsmeriaid yn system Cross River. Felly, cyn creu cyfrif ar gyfer cwsmer, rhaid i chi gofrestru'r cwsmer hwnnw. Mae'r cofnod cwsmer yn cefnogi dosbarthiadau o'r math Personol neu Fusnes. Ar ôl cofrestru, gallwch gysylltu cwsmer ag un neu fwy o gyfrifon.

Mae'r cynampMae'r isod yn dangos sut i ymuno â chwsmer ar gyfer cwsmer personol.

Cais am Berson ar y Bwrdd

POST /core/v1/cm/customers {

 “ID partner”“7cc038be-fde9-4455-b27b-1497cf667362”,

 “enw”{

 "rhagddodiad"“Mr.”,

 “Enw cyntaf”“Ioan”,

 “Enw Canol”“Robert”,

 “cyfenw”“Smith”,

 "ôl-ddodiad""Jr.",

 “Enw a Ffefrir”“Jim” },

 “dosbarthiad”“Personol”,

 “profile"{

 “regO”ffug,

 “CodGwladDinasyddiaeth”“UD”,

 “Person Gwleidyddol Agored”ffug,

 “galluogiAtalCopïau Wrth Gefn”ffug,

 “CanranDaliadCopïau Wrth Gefn”0,

 “MathIDTreth”“Ssn”,

 “ID treth”“123456789”,

 "Dyddiad Geni"“1965-09-15”,

 “Sgôr Risg”“Isel”,

 “Dewis Allan o Breifatrwydd”gwir }

} Ymuno â chwsmer busnes fel corfforaeth neu LLC gan ddefnyddio'r un pwynt terfyn gyda phriodoleddau ychydig yn wahanol.

Curl

POST /core/v1/cm/customers {

 “ID partner”“a24cba49-2bb6-431d-a867-1de81d6e4127”,

 “enw”{

 “EnwEndid”“ACME CO”, },

 “dosbarthiad”“Busnes”,

 “profile"{

 “CodGwladDinasyddiaeth”“UD”,  

 “galluogiAtalCopïau Wrth Gefn”ffug,

 “CanranDaliadCopïau Wrth Gefn”0,  

 “MathIDTreth”“Ein”,

 “ID treth”“123456789”,

 “dyddiadFfurfio”“2019-09-10”,

 “MathEndidau”“Corfforaeth”,

 “Sgôr Risg”“Isel”,

 “Math o Berchnogaeth”“Endid Cyfreithiol”,

 “IDCwsmerPerchennogPrif”“f9321f7f-3712-46e1-b965-2b79ead64dc9”, } }

P'un a ydych chi'n recriwtio cwsmer personol neu fusnes, y ID Cwsmer y Perchennog Cynradd rhaid i'r priodoledd gynnwys ID cwsmer sy'n cyfeirio at gofnod cwsmer o'r math Personol. Felly i gychwyn busnes, rhaid i chi greu cofnod cwsmer personol yn gyntaf ar gyfer prif berchennog y busnes hwnnw.

PWYSIG

Mae rhai pwyntiau terfyn cwsmeriaid yn cynnwys a Diwydrwydd dyladwy adnodd a allai fod yn ofynnol neu beidio wrth gyflwyno cwsmeriaid personol i'r tîm cyntaf. Mae eich cyswllt cydymffurfio penodedig yn cyfleu gofynion ar gyfer unrhyw feysydd Diwydrwydd Dyladwy yn ystod eich proses gyflwyno.

Perchnogion buddiol

Perchennog buddiol yw person sy'n berchen ar 25% neu fwy o fusnes. Am resymau rheoleiddio, mae angen i chi ddarparu adnoddau mewn Busnes cofnod cwsmer creu perchennog buddiol

ar gyfer pob perchennog buddiol o'r busnes hwnnw. IDCwsmerPerchennog Mae'r priodoledd yn cyfeirio at y cofnod cwsmer personol ar gyfer pob perchennog buddiol. Fel arfer, rydych chi'n ychwanegu adnoddau perchennog buddiol at y cofnod cwsmer busnes yn syth ar ôl ymsefydlu mewn busnes.

Curl

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

 “PerchennogCwsmerID”“c1210a2d-932e-43ca-be29-f358a4382385”,

 “TeitlPerchennog”“Llywydd” }

Cyfeiriad

Gall y cyfeiriadau ffisegol sy'n gysylltiedig â'r cwsmer fod yn .

diweddaru

Curl

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

{

 “isPrimary”gwir,

 "statws"“Gweithredol”,

 “dosbarthiad”“Preswyl”,

 “MathCyfeiriad”“Cartref”,

 “stryd1”“123 Stryd Maple”,

 “stryd2”“Ffl. 12”,

 “stryd3”“”,

 "dinas"“Efrog Newydd”,

 “gwladwriaeth”“NY”,

 “Cod Post”“10025”,

 “Cod gwlad”“UD”,

}

Cyfeiriadau e-bost

Diweddaru e-bost

gwybodaeth gyswllt ar gyfer cwsmer.

Curl

POST /core/v1/cm/customers/{customerId}/e-byst {

 “isPrimary”gwir,

 “MathE-bost”“Personol”,

 “Cyfeiriad E-bost”“john.smith@crossriver.com” }

Ffonau

Diweddaru ffôn Curl

gwybodaeth gyswllt ar gyfer cwsmer.

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

{

 “Math o ffôn”“Cartref”,

 “isPrimary”gwir,

 “Rhif ffôn”“2015551234”

}

Adnabod

Defnyddir manylion adnabod i olrhain metadata ar gyfer dogfennau sy'n adnabod cwsmeriaid fel trwyddedau gyrru a phasbortau. Gellir eu defnyddio i ychwanegu manylion adnabod newydd. Ychwanegu manylion adnabod

Curl

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

 “isPrimary”gwir,

 “RhifID”“DL123456789”,

 “MathID”“Trwydded Yrru”,

 “DyddiadCyhoeddi”“2018-08-30”,

 “Dyddiad Dod i Ben”“2018-08-30”,

 “DyddiadDilysu”“2018-08-30”,

 “Awdurdod Cyhoeddi”“DMV NJ”,

 “GwladwriaethNeuDalaithgyhoeddi”“NJ”,

 “CodGwladsy’nCyhoeddi”“UD”,

}

4.2.2. Mathau a IDau cynnyrch COS

Yn Cross River, a math o gynnyrch yn gynnyrch ariannol wedi'i ffurfweddu'n unigryw rydych chi'n ei gynnig i'ch cwsmeriaid. Er enghraifftamph.y., gallai math o gynnyrch fod yn gerdyn debyd neu'n gyfrif cynilo, wedi'i ffurfweddu yn ôl eich anghenion a'ch manylebau. Rydych chi'n agor cyfrifon i'ch cwsmeriaid o dan unrhyw fath o gynnyrch rydych chi'n ei ddiffinio a'i ffurfweddu gyda ni. Siaradwch â'ch rheolwr perthynas am fwy o fanylion, gan gynnwys sut i sefydlu mathau o gynhyrchion ar gyfer eich cwsmeriaid.

Am gynample, efallai yr hoffech chi ffurfweddu math o gynnyrch i fod yn gynnyrch cyfrif cynilo sy'n defnyddio taliadau Wires ac ACH. Yna gallwch chi gynnig cyfrifon cynilo i'ch cwsmeriaid gyda'r gwasanaethau a'r ffurfweddiadau hyn.

Mae Cross River yn rhoi ID cynnyrch i chi ar gyfer pob math o gynnyrch rydych chi am ei gynnig i'ch cwsmeriaid. I agor unrhyw fath o gyfrif blaendal rhaid i chi gael ID cynnyrch dilys ac ID cwsmer (ID cofnod cwsmer wedi'i fewnosod) ar gyfer deiliad y cyfrif. Sylwch fod yn rhaid i ddeiliad y cyfrif gael o leiaf un cyfeiriad a rhif ffôn yn ei gofnod cwsmer, a rhaid i'w statws OFAC fod yn ClirYn ogystal, rhaid i ddosbarthiad y cwsmer gyd-fynd â'r dosbarthiad a ffurfiwyd ar gyfer y cynnyrch. Er enghraifftample, dim ond cwsmeriaid busnes y gellir eu hychwanegu at gynnyrch busnes.

4.2.3. Archwiliwr COS

Unwaith y byddwch chi yn system Cross River ac wedi derbyn yr e-bost gyda'r manylion wedi'u cofrestru

eich ID y cleient Cyfrinach rydych chi'n barod i fewngofnodi i'r COS Explorer. Mynediad i'rCOSExplorerporth

Cynhyrchu:

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

Blwch tywod:

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

E-bost Croeso

Byddwch yn derbyn e-bost croeso gan CrossRiver_DO_PEIDIWCH_Â_ATEB@crossriver.comOs na welwch chi ef yn eich mewnflwch, gwiriwch eich ffolderi sbam neu bost wedi'i rwystro.

Cliciwch Creu eich Cyfrif Cross River.

Os byddwch chi'n gadael y dewin ar unrhyw adeg, cliciwch ar y ddolen yn yr e-bost gwreiddiol i fynd yn ôl i ble wnaethoch chi adael.

Telerau ac amodau

Darllenwch drwy'r telerau ac amodau, gwiriwch Derbyn, a chliciwch Nesaf.

Dilysu SMS (neges destun)

Rydym yn anfon neges destun (SMS) at eich dyfais i wirio pwy ydych chi. Rhowch y cod 6 digid a gewch ar y sgrin mewngofnodi a chliciwch Gwirio'r Cod.

Creu eich cyfrinair

1. Rhowch gyfrinair sy'n bodloni'r gofynion ar y sgrin ac ail-nodwch y cyfrinair. 

2. Cliciwch Creu Cyfrinair.

Gosod ap dilysydd

Rhaid i chi gwblhau'r cam hwn i barhau â'r broses gofrestru ac i allu mewngofnodi yn y dyfodol

Er mwyn diogelu eich hunaniaeth a'ch cyfrif a'ch gwybodaeth, rydym yn gofyn i chi fewngofnodi gyda dilysiad aml-ffactor/2-ffactor.

Os nad oes gennych ap dilysu ar eich dyfais eisoes, mae angen i chi lawrlwytho un cyn i chi barhau.

Ar gyfer Android ac iOS, rydym yn argymell defnyddio'r ap dilysu dilynol:

Google Authenticator

Dilysydd Microsoft

Ar ôl i chi osod eich ap dilysu, mae angen i chi naill ai sganiwch y cod QR or nodwch yr allwedd â llaw i mewn i'r ap dilysu.

QRcode

1. Sganiwch y cod QR yn eich ap dilysu ac, os oes angen, nodwch y cod 6 digid yn y dudalen dilysu Aml-Ffactor.

2. Cliciwch parhau.

Llawlyfr

1. Cliciwch Dangos allwedd

2. Copïwch yr allwedd fel y Cyfrinach yn eich ap dilysu.

3. Rhowch y cod 6 digid.

4. Cliciwch Parhewch.

CodMFA Annilys

Os byddwch chi'n nodi cod MFA annilys, bydd neges goch yn eich hysbysu i geisio eto.

Oops! Fe wnaethoch chi roi cod MFA annilys. Dyma rai pethau i'w gwirio ddwywaith:

1. A wnaeth y cod ddod i ben cyn i chi glicio ParhewchMae'r cylch cyfrif i lawr i'r dde o enw'r cyfrif a chod MFA yn dangos yr amser sy'n weddill.

2. Os oes gennych chi'r ap dilysu wedi'i sefydlu ar gyfer sawl amgylchedd neu raglen, gwiriwch ddwywaith eich bod chi wedi nodi'r cod cywir.

1. Os nad yw'n glir o enwau'r cysylltiadau MFA pa un yw'r opsiwn cywir, efallai y bydd angen i chi roi cynnig ar wahanol godau nes i chi ddod o hyd i'r un sy'n gweithio.

2. Unwaith i chi ddod o hyd i'r cysylltiad cywir, gallwch chi ailenwi'r cysylltiad MFA yn yr ap. Bydd eicon pensil ar frig sgrin ap MFA yn mynd â chi i'r modd golygu. Mewn rhai apiau, bydd angen i chi ddewis (neu wasgu a dal) y cysylltiad y dylid ei olygu yn gyntaf, ac yna bydd yr eicon yn ymddangos.

3. Unwaith yn y modd golygu, gallwch ailenwi'r cysylltiadau yn ôl yr angen fel y bydd yn glir pa un sy'n berthnasol i ba amgylchedd.

4. Cadwch unrhyw newidiadau, a'r tro nesaf dylai fod yn haws deall pa god i'w ddefnyddio.

Codau Adfer

Defnyddiwch godau adfer i ddilysu rhag ofn i chi golli'ch dyfais.

1. Lawrlwythwch neu gopïwch eich codau adfer a'u cadw mewn lle diogel y byddwch chi'n ei gofio.

2. Cadarnhewch eich bod wedi storio eich codau adfer

3. Cliciwch Creu cyfrif.

Mae'r dudalen codau adfer yn dod i ben ar ôl 10 munud.

Dim ond unwaith y gallwch chi lawrlwytho'r codau adfer.

Mae eich cyfrif bellach yn weithredol a gallwch ei ddefnyddio i fewngofnodi i unrhyw un o'ch apiau CR.

rhestr caniatáu IP

Dim ond IP statig y gellir ei ddefnyddio i gael mynediad at COS Explorer. Cysylltwch â'ch Cymorth IP os oes angen help arnoch gyda hyn.

Cyfeiriadau IP y Gweinydd Hunaniaeth yw:

172.67.26.222 104.22.40.134 104.22.41.134

Mae'r gweinydd yn cael ei ddirprwyo trwy Cloudflare.

Gallwch ganiatáu'r FQDNs hyn:

idptest.crbcos.com

Datrys problemau

Anghofiais gyfrinair

1. Cliciwch Wedi anghofio cyfrinair? a nodwch eich e-bost.

2. Rhowch y cod dilysu 6 digid o'ch ap dilysu. 3. Byddwch yn cael a Wedi anghofio Cyfrinair e-bost. Cliciwch Ailosod Cyfrinair.

4. Ar y dudalen Ailosod Cyfrinair, nodwch gyfrinair newydd, cliciwch Ailosod Cyfrinair, a Parhau i'r cais.

Ailosod dilysu aml-ffactor

Os oes gennych MFA wedi'i ffurfweddu eisoes:

1. Yn y Gweinydd Hunaniaeth, ewch i Ailosod MFA a chliciwch Ailosodwch eich dyfais MFA2. Mae'r dudalen Dilysu Aml-Ffactor yn agor a gallwch ailosod eich MFA.

Gallwch hefyd greu codau adfer dilysu aml-ffactor newydd.

1. Cliciwch creu codau adfer dilysu aml-ffactor newydd.

2. Mae'r dudalen Codau Adfer yn agor a gallwch gopïo neu lawrlwytho eich 10 cod adfer newydd.

Os nad ydych chi wedi ffurfweddu eich dilysiad aml-ffactor eto, gallwch chi alluogi MFA o Gosodiadau Cyfrif.

1. Cliciwch Ailosod Dull MFA.

2. Cliciwch Ffurfweddu MFA.

3. Dilynwch y cyfarwyddiadau yn Dilysu Aml-Ffactor/Dilysu 2 Gam.

Os yw eich MFA cyfredol yn SMS, gallwch alluogi MFA gyda'ch ap dilysu. Gosodiadau Cyfrif

1. Cliciwch Ailosod Dull MFA.

2. Cliciwch Ffurfweddu MFA.

3. Dilynwch y cyfarwyddiadau yn Dilysu Aml-Ffactor/Dilysu 2 Gam.

Defnyddiwch god adfer

Os nad oes gennych fynediad i'ch dilysydd aml-ffactor (2-ffactor), gallwch fewngofnodi gan ddefnyddio un o'ch codau adfer.

1. Mewngofnodwch fel arfer

2. Ar y dudalen Dilysu Aml-Ffactor, mae gennych yr opsiwn o ddefnyddio cod adfer fel eich opsiwn dilysu.

3. Rhowch un o'ch codau adfer yn y blwch testun. Mae'r cod adfer ar gyfer defnydd sengl ac ni ellir ei ailddefnyddio. Er mwyn osgoi dryswch yn y dyfodol, rydym yn argymell eich bod yn marcio'r cod adfer fel un sydd wedi'i ddefnyddio.

Cloi cyfrif

Os byddwch chi'n nodi'r cyfrinair anghywir ar gyfer eich enw defnyddiwr 5 gwaith, bydd y system yn cloi eich cyfrif am tua 5 munud. Os nad ydych chi'n gallu cael mynediad i'ch cyfrif o hyd ar ôl 5 munud, cysylltwch â Chymorth Cross River.

Gwall Porwr - Wal Dân

Rydych chi'n mewngofnodi i COS Explorer ac yn cael y sgrin gwall ganlynol:

Rydych chi wedi'ch rhwystro gan wal dân.

1. Cysylltwch â'ch adran TG fewnol i weld a yw'ch sefydliad yn gorfodi rheolau wal dân ar gyfer traffig allanol. Os nad oes rheolau wal dân ar gyfer traffig allanol, yna:

2. Cysylltwch â'ch adran TG fewnol i wneud yn siŵr eich bod yn cysylltu â Phorth Archwiliwr COS Cross River o gyfeiriad IP cymeradwy. Os oes angen i chi gofrestru mwy o gyfeiriadau IP, anfonwch e-bost at gymorth COS.

4.2.3.1. Rheoli defnyddwyr

Rheoli defnyddwyr

Gallwch ddefnyddio'r Defnyddwyr sgrin o'r Gweinyddol tab i grwpio set o adnoddau, fel cwsmeriaid, cynhyrchion a chyfrifon. Unwaith y bydd adnodd (h.y. cynnyrch neu gwsmer) wedi'i aseinio i chi, ni ellir ei newid.

Gallwch ddefnyddio'r ardal hon i gefnogi a gwneud newidiadau i'ch cwsmeriaid. Gallwn eich sefydlu gyda 2 ddefnyddiwr gweinyddol fel y gallwch greu defnyddwyr ar alw ar gyfer eich cwsmeriaid. Mae hyn yn rhoi annibyniaeth i chi reoli eich cwsmeriaid ac yn caniatáu ichi wneud newidiadau y tu allan i oriau gwaith, ar eu cais.

Gallwch hefyd greu neu gofrestru defnyddwyr newydd.

Creu defnyddiwr newydd

Yn y Gweinyddol tab, cliciwch Defnyddwyr i agor y Defnyddwyr sgrin chwilio. Cliciwch + Defnyddiwr Newydd. Mae'r Creu Defnyddiwr arddangosfeydd sgrin.

In Creu Defnyddiwr nodwch y defnyddiwr Ebost, yna mae'r meysydd canlynol yn ymddangos Enw CyntafEnw olaf Rhif Ffôn.

Cliciwch Statws a dewis Actif.

Mae'r Rhif Ffôn rhaid i'r maes fod yn rhif ffôn symudol gan y bydd hwn yn cael ei ddefnyddio ar gyfer MFA i ddilysu'r defnyddiwr.

Disgrifiad o'r Maes

Enw

Enw defnyddiwr. Rhowch yr enw defnyddiwr llawn i'w arddangos yn ffenestr y porwr pan fydd y defnyddiwr yn mewngofnodi i Explorer.

Ebost

Cyfeiriad e-bost defnyddiwr. Defnyddir y cyfeiriad hwn i fewngofnodi i Explorer ac mae hefyd yn gwasanaethu fel e-bost adfer ar gyfer ailosod cyfrinair.

Statws

Dewiswch statws defnyddiwr. Statws defnyddiwr yw Anactif yn ddiofyn. Newidiwch ef i Actif wrth greu defnyddiwr.

Math o Ddefnyddiwr

Mae'r maes hwn yn arddangos Partner pan fydd y defnyddiwr yn cael ei greu.

Rolau

Dewiswch y rolau i'w hychwanegu at y defnyddiwr, neu cliciwch Cynnwys Pob Rôl i ychwanegu'r holl rolau sydd ar gael i'r defnyddiwr.

Nodyn: Dim ond y rolau a neilltuwyd i chi fydd yn weladwy. Mae rhai rolau'n cynnwys caniatâd sy'n eich galluogi i gychwyn taliadau yn Explorer. Mae eich gweinyddwyr Explorer yn gyfrifol am sicrhau bod eich defnyddwyr wedi'u ffurfweddu'n gywir gyda dim ond y rolau defnyddwyr priodol yn ogystal â'r terfynau awdurdodedig.

Terfynau Awdurdodedig

Ar gyfer pob maes, dewiswch derfyn doler (os yn berthnasol)

Cliciwch Statws a dewis Actif.

Cliciwch Rolau a dewiswch yr un rydych chi am ei aseinio i'r defnyddiwr newydd. Cliciwch Arbed rolau Newidiadau.

Pawb rhaid i ddefnyddwyr gael eu ffurfweddu gyda'r Partner Core Parod yn Unig rôl.

Os yw'r defnyddiwr wedi'i neilltuo i'r Tarddiad Gwifren Partner rôl rhaid i chi ffurfweddu terfyn tarddiad y defnyddiwr hwnnw.

Os ydych chi'n neilltuo'r defnyddiwr Tarddiad Gwifren Partner rôl, nodwch werth yn y Taliadau.Gwifren.Tarddiad maes i nodi'r terfyn doler uchaf fesul gwifren. Fel arall, gallwch anwybyddu'r maes hwn.

Pan fyddwch chi wedi gorffen ffurfweddu'r holl feysydd. Cliciwch Cadw Newidiadau.

Os ydych chi wedi creu defnyddiwr newydd yn llwyddiannus, bydd sgrin gadarnhau yn ymddangos. 

10 I gwblhau ychwanegu a ffurfweddu defnyddiwr, rhaid i weinyddwr gwahanol Cymeradwyo Newidiadau.

11 Mae'r Cymeradwyo Newidiadau sydd ar y Gweill arddangosfeydd sgrin. Cliciwch Cadarnhau

12 Viewgwybodaeth defnyddiwr

Dogfennau / Adnoddau

PDF thumbnailPlatfform API
User Manual · API Platform, API Platform, Platform

Cyfeiriadau

Gofyn Cwestiwn

Use this section to ask about setup, compatibility, troubleshooting, or anything missing from this manual.

Gofyn Cwestiwn

Ask about setup, compatibility, troubleshooting, or anything missing from this manual. Name and email are optional.