크로스리버 API 플랫폼 사용자 매뉴얼

Cross River는 인증 및 권한 부여에 OAuth 2.0을 사용합니다. 이는 시스템 접근을 제어하고 권한이 있는 주체만 API 및 기타 보호된 리소스에 접근할 수 있도록 보장합니다. 인증 시스템에 입력하는 정보는 기밀로 유지되며 다른 Cross River 애플리케이션에서는 절대 접근할 수 없습니다.

API를 사용하기 전에 API 자격 증명을 받아야 합니다. 액세스 토큰을 사용하여 클라이언트_ID 그리고 클라이언트_비밀 등록 시 받으신 액세스 토큰입니다. 이 액세스 토큰을 사용하면 API에서 사용할 JSON 객체로 정보를 안전하게 전송할 수 있습니다. 각 API 요청의 헤더에 이 토큰을 포함해야 합니다.

액세스 토큰을 요청하고 수신하는 방법에는 여러 가지가 있습니다.

c와 함께 명령줄 인터페이스(CLI) 사용URL 또는 다른 언어

Postman이나 다른 API 테스트 도구를 사용하세요

액세스 토큰을 받으면 클립보드에 복사하세요. 꼭 저장하세요.

명령줄 인터페이스

토큰을 요청하려면 다음을 보내세요. POST 연결/토큰 다음을 포함하는 명령 클라이언트_ID 그리고 클라이언트_비밀 그리고 부여 _ 유형 인증 서버의 (인증 서버)로 적절한 샌드박스는 s에 표시된 대로amp아래에 있습니다.

이에 대한 설명은 다음을 참조하세요. tags. HTTP 구성 요소 테이블

다음 예ample는 c를 사용합니다URL 인증 서버 중 하나에 토큰을 요청합니다.

Sampc에서의 요청URL COS를 위해

curl –위치 –요청 'POST https://idptest.crbcos.com/connect/token' \ –헤더 '콘텐츠 유형: application/x-www-form-url인코딩됨' \ –데이터-url인코딩 'client_id=[여기에 당신의 ID를 입력하세요]' \

-데이터-url인코딩 'client_secret=[여기에 당신의 비밀을 입력하세요]' \

-데이터-url인코딩 'grant_type=클라이언트_자격증명' \

-데이터-url인코딩 '대상=https://api.crbcos.com/'

Sampc의 응답URL 요구

{ "액세스 토큰": “많은 문자가 포함되어 있습니다”, \

“만료_기간”: 86400, \

“토큰_유형”: "교군꾼" }

우편 집배원

Postman을 사용하여 토큰을 요청하려면 다음을 보내십시오. POST 연결/토큰 에 대한 명령 인증 섬기는 사람 적절한 샌드박스의. 추가 부여 _ 유형 , 범위(선택 사항) ,

클라이언트_ID 그리고 클라이언트_비밀 전화에.

이에 대한 설명은 다음을 참조하세요. tags. HTTP 구성 요소 테이블

인증이 성공하면 상태 코드는 200(정상)입니다.

COS익스플로러

에서 로그인 옆에 있는 아래쪽 화살표를 클릭하고 다음을 클릭합니다. 액세스 토큰 복사. COS 탐색기

액세스 토큰이 클립보드에 복사되어 샌드박스에서 사용할 준비가 되었습니다.

토큰 요청 응답

속성 설명

접근_접근

시야

디지털로 서명된 JSON web 특정 Cross River 리소스에 대한 액세스를 허용하는 oAuth 서버에서 보낸 토큰(JWT)

범위

사용자가 액세스할 수 있는 다양한 서비스

만료_i

토큰이 만료되기까지의 시간입니다.

– 통합 팀에서 만료 시간을 알려드리거나 액세스 토큰을 디코딩할 수도 있습니다.

– 기존 토큰이 만료되기 직전에 새로운 액세스 토큰을 검색하는 것이 좋습니다.

– 동일한 보호 리소스(API)에 대한 각 호출에 대해 새 토큰을 받는 대신 토큰의 전체 수명 동안 재사용합니다.

중요한:

공개적으로 호스팅된 토큰을 절대로 디코딩하지 마십시오. web대지

토큰 유형

소지자 토큰

HTTP 구성 요소

다음 HTTP 구성 요소는 API와 Postman 요청 모두에서 사용됩니다.

HTTP

요소

Tag 설명

엔드포인트	우편 /connect/toke n	액세스 토큰을 검색하기 위한 엔드포인트
헤더	콘텐츠 유형	애플리케이션/x-www-form- url인코딩됨
몸	클라이언트_ID	클라이언트의 고유 식별자
몸	클라이언트_비밀번호	ID 토큰에 서명하고 검증하는 데 사용되는 암호화된 문자열입니다. 중요한: CR로는 비밀을 복구할 수 없습니다. 비밀을 분실하면 새 비밀을 생성해야 합니다. 하지 마세요 귀하의 비밀을 소스 제어에 커밋하세요.
몸	부여 _ 유형	이 필드는 항상 다음 값을 갖습니다. 클라이언트 자격 증명
몸	청중 선택 과목	사용자가 특정 액세스 토큰이 자신에게 적합한지 확인할 수 있는 방법입니다.
몸	범위 선택 과목	사용자가 액세스 토큰을 사용하여 액세스할 수 있는 특정 범위 또는 제한된 서비스 집합입니다. 범위가 지정되지 않으면 반환된 토큰에는 자격 증명과 연결된 모든 범위가 포함됩니다. 메모: 각 범위 이름 사이에 공백을 추가하여 동일한 요청에서 여러 범위를 전송할 수 있습니다. 예를 들어ample: '범위=범위1 범위2 범위3'

인증 서버URLs

모듈 인증 서버 URL

계정	https://idptest.crbcos.com/connect/token
영어: ACH는 영어를 구사하는 사람입니다.	https://idptest.crbcos.com/connect/token
전선	https://idptest.crbcos.com/connect/token
체크 무늬	https://idptest.crbcos.com/connect/token
핵심	https://idptest.crbcos.com/connect/token
즉시 결제	https://idptest.crbcos.com/connect/token
카드 발급	https://idptest.crbcos.com/connect/token
카드 결제	https://crbcos-sandbox.auth0.com/oauth/token

대출 https://oauthtest.crbnj.net/connect/token

문제 해결

인증 토큰이 유효하면 200을 반환합니다. 인증 토큰이 유효하지 않으면 401을 반환합니다.

보유자 토큰을 받을 수 없고 과거에도 받은 적이 없는 경우:

확인하다 URL.

확인해보십시오 클라이언트_ID 그리고 클라이언트_비밀 정확하게 입력되었는지 확인하세요. 대소문자를 구분합니다.

확인하세요 클라이언트_ID 그리고 클라이언트_비밀 받은 것과 대조해 보세요. 네트워크 또는 허용 목록에 문제가 없는지 확인하세요.

3번의 잘못된 로그인으로 인해 계정이 잠긴 경우 통합 팀에 문의하세요. 시도.

2.3. 액세스 토큰 사용

1단계
API 자격 증명 가져오기

2단계
액세스 토큰 받기

3단계
액세스 토큰 사용

4단계
S를 만들어라amp르 앱

성공적으로 액세스 토큰을 받으면 귀하에게 반환됩니다. 인증된 항목을 포함합니다. API 호출 헤더에 이 토큰을 넣으세요.

액세스 토큰은 일정 시간 후에 만료됩니다. 토큰이 포함된 응답에는 만료 시간(초)도 지정되어 있습니다. 액세스 토큰은 만료될 때까지 저장하고 사용하세요. 401 권한 없음 오류가 발생할 때까지 토큰을 사용한 후 새 토큰을 요청하는 것이 좋습니다.

중요한

1. 모든 API 요청에 대해 새로운 토큰을 요청하지 마세요.

2. 토큰을 안전하게 보호하세요. 토큰을 훔친 사람은 토큰의 유효기간 동안 귀하의 고객을 사칭할 수 있습니다.

API 요청 헤더

각 API 요청의 헤더에 다음과 같이 액세스 토큰을 포함합니다.

Sampc에서 전신 송금 요청URL

curl –location –request 'POST https://sandbox.crbcos.com/Wires/v1/payments' –header '승인: 소지자 [여기에 토큰을 넣으세요]' \

–헤더 '콘텐츠 유형: application/x-www-form-url인코딩됨' \

–데이터-원시 '{

“계정 번호”: “2255685659”,

“businessFunctionCode”: “CTR”,

“receiverRoutingNumber”: “021000021”,

“수혜자Fi”: {

“idCode”: “F”,

“식별자”: “021000021”,

“이름”: “JP Morgan Chase”

“수혜자”: {

“idCode”: “D”,

“식별자”: “123456789”,

“이름”: “피터 그리핀”

“수혜자 참조”: “XYZ123”,

"금액": 10000,

“목적”: “지불”

우편 집배원

Postman에서 토큰을 사용하려면 다음으로 이동하세요. 권한 부여 요청의 탭에서 선택하세요 베어러 토큰 인증 유형으로 선택하고 제공된 필드에 토큰을 붙여넣습니다. Postman이 자동으로 추가합니다. 교군꾼 접두사와 토큰 토큰 필드.

2.4. Web갈고리

Web후크는 Cross River와의 모든 통합에 있어 중요한 구성 요소입니다. API를 사용하면 필요에 따라 데이터를 요청할 수 있지만, web후크는 실시간 업데이트를 시스템에 직접 푸시하여 지속적인 폴링의 필요성을 없애고 지연 시간을 줄입니다. 많은 경우, web후크는 API만 사용하는 것보다 효율적이고 안정적이어서 계정 변경, 거래 업데이트, 처리 결과와 같은 중요한 이벤트와 동기화된 상태를 애플리케이션에서 유지할 수 있습니다.

사용 web크로스 리버 시스템 내에서 다양한 이벤트 발생 시 알림을 제공하는 후크입니다. 이벤트는 각 이벤트 주제에 대한 관련 세부 정보가 포함된 리소스 객체를 반환합니다. 전체 이벤트 세부 정보가 포함되어 시스템으로 전송됩니다.

우리는 사용합니다 web거래 상태를 업데이트하고 거래 변경 사항을 보고하는 후크입니다. Web후크는 이벤트가 발생하면 실시간 알림을 시스템에 보고합니다.

사용하려면 API를 통해 등록해야 합니다. web후크:

계정, 카드 및 결제 이벤트에 등록하세요

카드 결제 이벤트에 등록하세요

대출 이벤트에 등록하세요

2.5. 샌드박스 환경

저희 샌드박스는 완전히 격리된 환경이므로 마음껏 실험해 보세요. 프로덕션 환경으로 전환할 준비가 되면 알려주세요. 라이브 환경에 액세스할 수 있는 프로덕션 자격 증명을 제공해 드리겠습니다.

고객 관리

모듈 기반 URL API 호출을 위해

고객 관리 https://sandbox.crbcos.com/core/ 계정

모듈 기반 URL API 호출을 위해

예금 계좌

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

입금 정리 https://sandbox.crbcos.com/sweepsintrafi/ 카드

모듈 기반 URL API 호출을 위해

카드 https://sandbox.crbcos.com/cardmanagement/결제

모듈 기반 URL API 호출을 위해

즉시 결제	https://sandbox.crbcos.com/rtp/
카드 결제: 푸시 투 페이	https://pushtopaystaging.crbnj.net/
카드 결제: 풀	https://pullfromcardapistg.crbnj.net/
국제 결제	https://sandbox.crbcos.com/international/
영어: ACH는 영어를 구사하는 사람입니다.	https://sandbox.crbcos.com/ach/
전선	https://sandbox.crbcos.com/wires/

체크 https://sandbox.crbcos.com/checks/ 코사인web갈고리

모듈 기반 URL API 호출을 위해

코사인 web갈고리

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

대출

모듈 기반 URL API 호출을 위해

대출 신청

https://arixapisandbox.crbnj.net

신청 결정 https://lendingsandbox.crbcos.com/preapproval/v1

2.6. 우편 배달부 컬렉션

개발을 보다 쉽게 하기 위해 사전 구축된 기능을 함께 제공했습니다.

우편 배달부 컬렉션 모든 Cross River에 대한 요청입니다. 이 컬렉션을 사용하여 API 엔드포인트를 탐색, 테스트 및 빌드하세요. Postman에서 직접 통합할 수 있습니다. 최소한의 추가 코딩 및 설정이 필요합니다. 컬렉션을 즉시 포크하려면 다음을 클릭하세요.

설정 세부 정보를 완료하고 Sandbox Postman 컬렉션에서 통화를 시작하세요. 을 통해 .

우편 집배원

액세스(보유자) 토큰

Cross River API를 안전하게 테스트할 수 있는 공간을 제공하기 위해 Postman 개발자 샌드박스 환경을 구축했습니다. Cross River Postman 컬렉션에서는 베어러 토큰을 사용하여 인증을 수행합니다.

ID를 얻으려면 컬렉션을 실행하는 데 필요한 액세스(베어러) 토큰을 설정해야 합니다.

1. : 이러한 자격 증명을 사용하여 액세스 토큰을 요청하고 수신합니다.

API 자격 증명 가져오기
샌드박스 환경에서 API를 전송하는 데 사용

2. : API 자격 증명을 받고 사용하기 전에

액세스 토큰 받기
API를 사용하면 액세스 토큰을 얻을 수 있습니다. 클라이언트_ID 그리고 클라이언트_비밀 등록 시 받으신 것입니다.

포크 크로스 리버 컬렉션

바로 저희 웹사이트로 가서 컬렉션을 구매하세요.

우편 배달부 작업 공간

포크한 후에는 샌드박스에 대한 환경 변수를 설정하는 것을 잊지 마세요.

Postman 환경 구성

방금 만든 컬렉션을 사용하려면 해당 컬렉션으로 이동하여 클릭하세요. 환경, 그리고 선택하세요 모래 상자. Cross River 클라이언트 ID와 클라이언트 비밀번호를 복사하여 붙여넣습니다. 클라이언트_아이디 그리고 클라이언트_비밀 필드. 카드 결제의 경우 붙여넣으세요. ptpe_client_id 그리고 ptpe_client_secret 전지.

이제 토큰을 얻고 요청을 보낼 준비가 되었습니다.

1. 달리다 승인/토큰 획득 토큰을 생성하려면 다음을 실행하세요. 카드 결제의 경우 카드 결제/승인/P2PE 토큰 받기 .

2. 변수 {{token}} (또는 ptpe_토큰 카드 결제의 경우)는 사후 응답 스크립트를 통해 환경에 자동으로 추가됩니다. 토큰이 만료되면 1단계를 다시 수행해야 합니다.

3. 운동 종료 시점에 따라 입력해야 할 변수가 여러 개 있습니다. 예를 들어amp르, 파트너_아이디 , 제품_아이디 , 구성_아이디 그리고 콜백_url .

4. 스크립트를 통해 채워지는 변수도 있습니다. 토큰 그리고 ptpe_토큰 수동으로 채워서는 안 됩니다.

핑더샌드박스

Cross River 샌드박스에 연결할 수 있는지 확인하기 위해 간단한 테스트를 실행하세요.

Ping 요청을 보내려면 Postman에서 다음을 엽니다. 컬렉션 > Cross River API 컬렉션 > 권한 부여 그리고 실행하다 핑 종착점.

수정 요청

요청을 업데이트하려면 다음에서 변경 사항을 적용하세요. 몸 탭. 이중 c의 값urly 괄호는 환경 변수에서 가져옵니다. 각 API 문서의 필드를 확인하려면 를 확인하세요.

엔드포인트가 수락하고 view 귀하가 선호하는 언어로 요청하세요.

3. 으로 빌드amp앱

1단계
API 자격 증명 가져오기 설정

2단계
액세스 토큰 받기

3단계
액세스 토큰 사용

4단계
S를 만들어라amp르 앱

: 시작하기 전에 빠른 시작 가이드를 참조하여 API에 연결하세요. API 호출을 테스트하려면 c를 사용할 수 있습니다.URL 명령줄이나 샌드박스의 Postman이나 Swagger와 같은 서비스를 통해 가능합니다.

고객 및 계정
: Cross River 서비스를 이용하기 전에 다음을 생성해야 합니다. 각 고객에 대한 고객 기록

카드
: Cross River와 협력하여 실제 카드나 가상 카드 등 무엇을 제공할지 결정하여 고객의 카드를 관리하세요.

대출
: 대출에는 대출 API 호출 세트가 포함되어 있어 대출을 생성, 업데이트할 수 있습니다. 대출을 관리하세요.

3.1. 설정

시작하기 전에 API 연결 가이드를 참조하세요. API 빠른 시작을 테스트하려면

호출하면 c를 사용할 수 있습니다URL 명령줄이나 샌드박스의 Postman이나 Swagger와 같은 서비스를 통해 가능합니다.

카드나 결제 앱을 만들려면 고객과 계정을 만들어야 합니다.

샌드박스 탐색

여러분이 탐험할 수 있는 모든 것이 있습니다. 샌드박스는 완전히 고립된 샌드박스 환경입니다. 프로덕션 환경에서 시작했으니 마음껏 실험해 보세요. 프로덕션 환경으로 전환할 준비가 되면 관계 관리자에게 문의하세요. 그러면 라이브 환경에 액세스할 수 있는 프로덕션 자격 증명을 제공해 드립니다.

3.2. 고객 및 계정

1단계
API 자격 증명 가져오기

2단계
액세스 토큰 받기

3단계
액세스 토큰 사용

4단계
S를 만들어라amp르 앱

고객 기록과 자금이 입금된 계좌를 만드세요.

고객 기록 생성

예금 계좌를 만드세요

계좌에 입금하세요

고객 기록 생성

Cross River 서비스를 사용하기 전에 각 고객에 대한 레코드를 만들어야 합니다.

고객. 고객 온보딩 프로세스에는 다음을 만드는 것이 포함됩니다. 고객 기록 관련 고객 정보와 함께.

모든 고객은 규정 준수 목적으로 자동으로 스캔되므로 관련 사항을 등록해야 합니다. web고객 기록 상태 업데이트를 수신하기 위해 이벤트를 연결합니다.

고객 기록은 다음 중 하나에 해당할 수 있습니다. 개인의 or 사업 고객. 등록이 완료되면 고객은 하나 이상의 계정과 연결될 수 있습니다.

Web갈고리

등록하다 ~을 위한 web후크. 다음 web후크는 다음과 같이 사용됩니다:

Web후크 설명

핵심.고객.온보딩됨	고객 레코드가 생성되었음을 알려줍니다.
핵심.고객.Ofac.변경됨	고객의 OFAC 상태가 업데이트되었음을 알려줍니다.

Core.Customer.PepScan.Chan ged

N고객의 PEP 상태가 업데이트되었음을 알려줍니다.

Examp레오프 레코드크리에이션

이 전에서amp이제 John Smith를 등록하겠습니다. 먼저 고객 레코드를 생성하겠습니다. John을 개인의 고객.

기업 고객을 등록하려면 먼저 개인 고객 기록을 작성해야 합니다. 주 소유자 해당 사업체의 경우, 사업 고객을 생성하고 개인 기록을 실질 소유자로 추가합니다.

1 부르다 POST /core/v1/cm/고객 .

다음 예에서amp당신이 볼 수 있는 것은 필수입니다. 어떤 속성이 필요한가요?

중요한

요청 헤더에 멱등성 키를 포함하는 것이 좋습니다.

장애 발생 시 이중 보호를 제공합니다.

Curl

curl -X POST /core/v1/cm/고객 –header '콘텐츠 유형: application/j {

“파트너 ID”: “6e80b097-693c-4592-8440-02f345335bbf”,

"이름": {

“이름”: "남자",

"성": "스미스"

"분류": "개인의",

"찬성file”: {

“레고”: 거짓,

"정치적으로 노출된 사람": 거짓,

“세금 ID 유형”: “SSN”,

“세금 ID”: “119988776”,

“생년월일”: “1953-09-22”,

“위험 등급”: "낮은"

“기본 주소”: {

“주소 유형”: "집",

"분류": “주거용”,

“기본입니다”: 진실,

“거리1”: “123 애니 스트리트”,

"도시": "어딘가에",

"상태": “뉴욕”,

“우편번호”: “12345”,

“국가 코드”: "우리를"

“기본 전화”: {

“기본입니다”: 진실,

“전화번호 유형”: "집",

“전화번호”: “2015551234”

"기본 이메일": {

“기본입니다”: 진실,

“이메일 유형”: "개인의",

“이메일 주소”: “John.Smith@xxxxx.com”

}

API 호출이 성공하면 응답 본문 첫 줄에 고유 고객 ID가 포함된 JSON 응답이 반환됩니다. 고객이 생성되었습니다.

고객 대응 기관 온보딩

{

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

“cif번호”: “32653745014”,

"분류": "개인의",

"상태": "활동적인",

“오팍”: "보류 중",

“펩스캔”: "보류 중",

"이름": {

“이름”: "남자",

"성": "스미스",

"성함": “존 스미스”

"찬성file”: {

“레고”: 거짓,

"정치적으로 노출된 사람": 거짓,

"백업 보류 활성화": 거짓,

“세금 ID 유형”: “SSN”,

“세금 ID”: “119988776”,

“생년월일”: “1953-09-22”,

“위험 등급”: "낮은"

"생성됨": “2021-01-25T17:55:24.4422582-05:00”,

"마지막 수정 시간": “2021-01-25T17:55:24.4432543-05:00”,

“파트너 ID”: “6e80b097-693c-4592-8440-02f345335bbf”

}

2 그만큼 핵심.고객.온보딩됨 web고객 레코드가 생성되면 hook 이벤트가 트리거됩니다.

고객 온보딩 이벤트

{

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

“이벤트 이름”: "핵심.고객.탑재",

"상태": "보류 중",

“파트너 ID”: “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

"생성됨": “2021-11-22T10:50:20.553-05:00”,

"자원": [

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

"세부": []

}

크로스리버는 OFAC 및 PEP 규정 준수를 위해 신규 고객 기록을 스캔합니다.

때로는 검사 결과에 재검사가 필요합니다.view 당사의 자금세탁방지(AML) 팀에 의해.

스캔이 완료되면, 핵심.고객.Ofac.변경됨 그리고

Core.Customer.PepScan.변경됨 web후크 이벤트는 상태와 함께 반환됩니다. 규정 준수 문제가 없는 고객은 분명한 상태.

고객 OFAC 스캔이 변경되었습니다.

{

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

“이벤트 이름”: “핵심.고객.Ofac.변경됨”,

"상태": "보류 중",

“파트너 ID”: “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

"생성됨": “2021-11-22T10:51:53.657-05:00”,

"자원": [

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

"세부": []

}

고객 PEP 스캔이 변경되었습니다.

{

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

“이벤트 이름”: “핵심.고객.펩스캔.변경됨”,

"상태": "보류 중",

“파트너 ID”: “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

"생성됨": “2021-11-22T10:51:53.597-05:00”,

"자원": [

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

"세부": []

}

이제 고객 기록이 생성되었습니다.

고객 기록 업데이트

주소, 전화번호, 이메일 등 고객 정보를 업데이트할 수 있습니다. 이러한 정보는 주요한 정보. 두 번째 주소를 추가하는 경우 반성.

1 고객 레코드를 생성할 때 반환된 고객 ID를 사용하여 호출합니다. POST /core/v1/cm/customers/{id}/주소 .을 추가하려면 첫 번째 고객 주소

당신이 추가하는 주소는 다음과 같습니다 주요한 주소. 다음 예에서amp어떤 속성이 필요한지 확인할 수 있습니다.

고객 주소 업데이트

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

“주소 유형”: "집",

"분류": “주거용”,

“기본입니다”: 진실,

“거리1”: “123 애니 스트리트”,

"도시": "어딘가에",

"상태": “뉴욕”,

“우편번호”: “12345”,

“국가 코드”: "우리를"

}

2 부르다 POST /core/v1/cm/customers/{id}/phones 추가하려면

고객 전화

. 추가하는 첫 번째 전화번호는 주요한 전화 번호.

숫자

고객 전화번호 업데이트

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

“기본입니다”: 진실,

“전화번호 유형”: "이동하는",

“전화번호”: “2015552345”

}

3 부르다 POST /core/v1/cm/customers/{id}/이메일 고객 이메일을 업데이트하려면

고객 이메일 업데이트

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

“기본입니다”: 진실,

“이메일 유형”: "개인의",

“이메일 주소”: “john.jones@xxx.com”

}

입금계좌 만들기

CR은 수표, 저축, 예금증서(CD 또는 정기예금 계좌) 등 다양한 유형의 계좌를 제공합니다.

예금 계좌를 개설하려면 개설하려는 계좌 유형에 대한 유효한 상품 ID와 계좌 소유자의 고객 ID(온보딩된 고객 기록 ID)가 있어야 합니다. 계좌 소유자는 고객 기록에 최소 하나의 주소와 전화번호를 등록해야 하며, OFAC(외국환관리국) 자격은 다음과 같아야 합니다. 분명한. 또한, 고객 분류는 제품에 대해 구성된 분류와 일치해야 합니다. 예를 들어amp즉, 비즈니스 고객만 비즈니스 제품에 추가할 수 있습니다.

시작하기 전에

다음 사항이 있는지 확인하세요.

API 자격 증명

파트너 ID(등록 시 받은)

고객 ID

제품 ID(개설되는 계좌 유형을 정의함)

중요한

요청 헤더에 멱등성 키를 포함하는 것이 좋습니다. 실패 시 중복 지불을 방지하기 위함입니다.

종료 지점 및 web갈고리

다음 API 엔드포인트가 사용됩니다.

API 설명

예금계좌 개설 고객의 예금계좌를 개설합니다.

다음은 web후크가 사용됩니다:

Web후크 설명

핵심 계정 개설됨 새로운 계좌가 개설되었습니다

계좌 개설

다음 시나리오에서는 귀하가 성공적으로 온보딩한 고객인 John Smith의 계좌를 개설하게 됩니다.

Toopenanaccount

1 부르다 POST 코어/v1/dda/계정 이 호출에는 몇 가지 속성이 필요합니다. 전체 내용을 참조하세요.

속성 목록

Samp요청

POST /core/v1/dda/계정

{

“고객 ID”: “59e3bc15-bbec-4990-88e9-a9a600d3296c”,

“제품 ID”: “44015e68-1afb-40fc-9497-abc1014f52da”,

"제목": “존 스미스”,

“statementAddress”: {

“거리1”: “257 달튼 그로브스”,

"도시": “바튼 시티”,

"상태": "미",

“우편번호”: “48705”,

“국가 코드”: "우리를"

}

2 성공적인 API 호출은 새 계정의 세부 정보가 포함된 JSON 응답을 반환합니다.

Samp르 응답

우편 /핵심/v1/디다/계정

{

“고객 ID”: “59e3bc15-bbec-4990-88e9-a9a600d3296c”,

“제품 ID”: “44015e68-1afb-40fc-9497-abc1014f52da”,

"제목": “존 스미스”,

“statementAddress”: {

“거리1”: “257 달튼 그로브스”,

"도시": “바튼 시티”,

"상태": "미",

“우편번호”: “48705”,

“국가 코드”: "우리를"

}

3 그만큼 계정 번호 필드는 새 계좌의 계좌 번호를 제공합니다.

4 응답에서 example, 계정은 다음과 같이 분류됩니다. 개인의 사용자가 제품 분류를 다음과 같이 구성했기 때문입니다. 개인의계정 분류는 항상 구성된 제품 분류와 일치합니다.

5 계정 상태는 자동으로 업데이트됩니다. 활동적인 , 즉시 사용할 수 있습니다. 이렇게 하면 핵심 계정 개설됨 이벤트.

Core.Account.Opened 이벤트 세부 정보

{

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

“이벤트 이름”: “핵심 계정 개설됨”,

"상태": "보류 중",

“파트너 ID”: “e6c3824a-377f-44d5-a2f6-a9a600c9b37e”,

"생성됨": “2021-01-26T09:48:10.1011462-05:00”,

"자원": [

“코어/v1/dda/계정/2235223803”

"세부": []

}

펀드계정

샌드박스에서 결제 레일과 계좌 동작을 테스트하려면 계좌에 자금이 있어야 합니다.

인바운드 시뮬레이션 엔드포인트가 있는 모든 레일을 사용하여 샌드박스 계정에 자금을 조달할 수 있습니다(계정이 샌드박스 계정으로 구성된 경우). 특히 다음과 같은 작업을 수행할 수 있습니다.

인바운드 ACH 지불 시뮬레이션

인바운드 와이어 시뮬레이션

모든 시뮬레이션에는 자금을 조달하려는 Cross River 샌드박스 계좌 번호가 필요합니다. 송금인 정보는 중요하지 않으며, 경우에 따라 완전히 허위일 수도 있습니다.

넥스트스텝스

당사의 결제 방법을 확인해 보세요.

튜토리얼

3.3. 카드

1단계
API 자격 증명 가져오기

2단계
액세스 토큰 받기

3단계
액세스 토큰 사용

4단계
S를 만들어라amp르 앱

Cross River API 사용 방법을 알아보세요. 이 페이지에서는 다음 작업을 수행하는 방법을 보여줍니다.

카드 만들기

카드 활성화

카드 만들기

Cross River와 협력하여 실제 카드 또는 가상 카드 등 무엇을 제공할지 결정하여 고객의 카드를 관리하세요. 카드 구성. Cross River는 카드 구성 프로를 생성합니다.file 귀하가 선택한 금융 상품의 각 유형에 대해 고객.

시작하기 전에

다음을 수행해야 합니다.

고객 기록 생성

예금 계좌를 만드세요

카드 소지자 계좌번호

고객 ID(고객을 생성할 때 얻습니다)

구성 ID(Cross River는 유형/카드를 구성할 때 ID를 제공합니다)

또한 관련 사항에 대해서도 권장합니다. web후크 이벤트. 등록

엔드포인트sandweb갈고리

등록하다 ~을 위한 web후크. 다음 API 엔드포인트가 사용됩니다.

API 설명

새 카드 만들기 새 직불 카드 생성을 요청합니다.

다음은 web후크는 다음과 같이 사용됩니다:

Web후크 설명

카드.카드.생성됨 직불카드가 생성되었습니다

오더카드

John Smith의 카드를 만들어서 새로운 직불 카드를 주문/생성하는 방법을 배워보세요.

1 부르다 POST /카드관리/v1/카드 .

다음 예에서amp어떤 속성이 필요한지 확인할 수 있습니다. 전체 API에 대한 자세한 내용을 확인하세요.

카드 추가

Samp카드를 만들다

curl -X POST /카드관리/v1/카드 –header 'Content-Type: applicatio “accountNumber”: “2608927303”, \

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

“configurationId”: “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”, \ “firstName”: “John”, \

“lastName”: “Smith”, \

"핸드폰": { \

“phoneType”: “홈”, \

“전화번호”: “9133413131” \

}, \

“이메일 주소”: “John.Smith@xxxxx.com”, \

“배송 주소”: { \

“street1”: “Lane Ave”, \

“street2”: “문자열”, \

“도시”: “대도시”, \

“state”: “IL”, \

“우편번호”: “72410”, \

“countryCode”: “US” \

}, \

“청구 주소”: { \

“street1”: “Lane Ave”, \

“street2”: “문자열”, \

“도시”: “대도시”, \

“state”: “IL”, \

“우편번호”: “72410”, \

“countryCode”: “US” \

}, \

“nameOnCard”: “John Smith”, \

“shippingType”: “일반”, \

“클라이언트 식별자”: “문자열” \

}' 'https://sandbox.crbcos.com/카드관리/v1/카드'

2 API 호출이 성공하면 새 카드의 세부 정보가 포함된 JSON 응답이 반환됩니다. 카드를 활성화할 때까지 카드 상태는 '비활성화'로 유지됩니다. 여기서 ID는 카드 ID입니다. example 8709163d-140c-4d95-a111-afa8009e9cd1당신이 필요로 할 것입니다 활성화하다 카드.

Samp카드 주문 응답

{

"ID": “8709163d-140c-4d95-a111-afa8009e9cd1”, “파트너 ID”: “cd9c12f4-7691-424a-b38b-af5b0134c611”, “제품 ID”: “83bed086-8182-4151-a1e3-af5b01362783”, “계정 번호”: “2608927303”,

"상태": "활성화되지 않음",

“상태이유코드”: "설정되지 않음",

“이름”: "남자",

"성": "스미스",

“배송 주소”: {

“거리1”: “레인 애비뉴”,

“거리2”: "끈",

"도시": “빅 타운”,

"상태": “일”,

“우편번호”: “72410”,

“국가 코드”: "우리를"

“청구지 주소”: {

“거리1”: “레인 애비뉴”,

“거리2”: "끈",

"도시": “빅 타운”,

"상태": “일”,

“우편번호”: “72410”,

“국가 코드”: "우리를"

"핸드폰": {

“전화번호 유형”: "집",

“전화번호”: “9133413131”

“이메일 주소”: “john@anygoogle.com”,

“nameOnCard”: “존 스미스”,

“isPinSet”: 거짓,

"관리자 차단됨": 거짓,

“사기용의자”: 거짓,

“구성 ID”: “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”, "범주": "신용 거래",

“결제 수단”: “가상 팬”,

"프로세서": "프로세서 이름",

“배송 유형”: "정상",

“주문 상태”: "주문 보류",

“교체 상태”: “해당 없음”,

“고객 ID”: “2b15a695-13dc-4b10-b4e5-af5b0138873c”, “클라이언트 식별자”: "끈",

"생성됨": “2023-02-13T04:37:29.4869172-05:00”,

"마지막 수정 시간": “2023-02-13T04:37:29.4869172-05:00”

}

3 그만큼 카드.카드.생성됨 web카드가 프로세서에서 생성될 때 후크 이벤트가 트리거됩니다.

SampCards.Card.Created 이벤트

{

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

“이벤트 이름”: “카드.카드.생성됨”,

"상태": "보류 중",

“파트너 ID”: “cd9c12f4-7691-424a-b38b-af5b0134c611”,

"생성됨": “2023-02-13T04:42:29.4869172-05:00”,

"자원": [

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

"세부": [

{

“카드ID”: “8709163d-140c-4d95-a111-afa8009e9cd1”,

"상태": "활성화되지 않음",

“상태이유코드”: "설정되지 않음"

}

]

}

카드 활성화

시작하기 전에

다음 사항이 있는지 확인하세요.

API 자격 증명

카드를 주문할 당시의 카드 ID

엔드포인트sandweb갈고리

API 설명

POST /cardmanagement/v1/cards/{id}/activate 카드 ID를 사용하여 카드를 활성화합니다. 이 튜토리얼에서는 다음을 사용합니다. web후크:

Web후크 설명

카드.카드.활성화됨 직불카드 활성화됨

카드 활성화

s에서 생성한 카드를 활성화하세요tage.

카드를 만들다

1 부르다 POST /카드 관리/v1/카드/{id}/활성화 . 그 id 속성은 카드 ID로 설정해야 합니다.ampID 아래의 le는 8709163d-140c-4d95-a111 afa8009e9cd1.

Samp카드 활성화 요청

curl -X 우편

–헤더 '수락: application/json'

–헤더 '권한 부여: 소지자'<토큰>'

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

2 API 호출이 성공하면 카드 세부 정보가 포함된 JSON 응답이 반환됩니다. 카드 상태 지금은 활성화됨. 그 주문 상태 is 완전한.

Samp카드 활성화 응답

{

"ID": “8709163d-140c-4d95-a111-afa8009e9cd1”, “파트너 ID”: “cd9c12f4-7691-424a-b38b-af5b0134c611”, “제품 ID”: “83bed086-8182-4151-a1e3-af5b01362783”, “프로세서카드ID”: “804951250206718”,

“계정 번호”: “2608927303”,

"상태": "활동적인",

“상태이유코드”: "설정되지 않음",

“이름”: "남자",

"성": "스미스",

“배송 주소”: {

“거리1”: “레인 애비뉴”,

“거리2”: "끈",

"도시": “빅 타운”,

"상태": “일”,

“우편번호”: “72410”,

“국가 코드”: "우리를"

“청구지 주소”: {

“거리1”: “레인 애비뉴”,

“거리2”: "끈",

"도시": “빅 타운”,

"상태": “일”,

“우편번호”: “72410”,

“국가 코드”: "우리를"

"핸드폰": {

“전화번호 유형”: "집",

“전화번호”: “9133413131”

“이메일 주소”: “john@anygoogle.com”,

“nameOnCard”: “존 스미스”,

“팬라스트포”: “3629”,

“isPinSet”: 거짓,

“만료일”: “2026-02-13”,

"관리자 차단됨": 거짓,

“사기용의자”: 거짓,

“구성 ID”: “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”, "범주": "신용 거래",

“결제 수단”: “가상 팬”,

"프로세서": "프로세서 이름",

“배송 유형”: "정상",

“주문 상태”: "완료",

“교체 상태”: “해당 없음”,

“고객 ID”: “2b15a695-13dc-4b10-b4e5-af5b0138873c”,

“클라이언트 식별자”: "끈",

“프로세서고객ID”: “T83E9D675A3N3N9O8RZ1”,

"생성됨": “2023-02-13T04:37:29.487-05:00”,

"초기 활성화": “2023-02-13T00:00:00-05:00”,

"활성화됨": “2023-02-13T04:43:19.282287-05:00”,

"마지막 수정 시간": “2023-02-13T04:43:19.2962845-05:00”

}

3 카드 상태가 변경되면 활동적인 , 그 카드.카드.활성화됨 web후크 이벤트가 발생합니다.

카드.카드.활성화됨 web후크 이벤트

{

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

“이벤트 이름”: "카드.카드.활성화됨",

"상태": "보류 중",

“파트너 ID”: “cd9c12f4-7691-424a-b38b-af5b0134c611”,

"생성됨": “2023-02-13T04:44:31.282287-05:00”,

"자원": [

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

"세부": [

{

“카드ID”: “8709163d-140c-4d95-a111-afa8009e9cd1”,

"상태": "활동적인",

“상태이유코드”: "설정되지 않음"

3.4. 대출

1단계
API 자격 증명 가져오기

2단계
액세스 토큰 받기

3단계
액세스 토큰 사용

4단계
S를 만들어라amp르 앱

대출에는 대출 API를 생성, 업데이트 및 관리할 수 있는 일련의 호출이 포함됩니다. 귀하의 대출.

대출을 시작하려면 다음 사항을 확인하세요.

대출에 필요한 범위로 API 자격 증명을 받습니다.

셀프 서비스 관리를 사용하여 API 자격 증명을 생성한 경우

, 그러면 당신도 요청을 보내야 합니다.

arix.support@crossriver.com

조직, 클라이언트 ID 및 MPLID와 함께 완료하려면 창조물.

사용하려는 API에 맞는 올바른 범위를 사용하세요.

샌드박스의 API 범위는 다음과 같습니다. CosLending:PreApproval:stg

모래 상자

모듈 기반 URL API 호출에 대한 설명

대출 개시

신청 결정

https://arixapisandbox.crbnj. net

베이스 URL Arix 샌드박스 환경에 대한 대출 발급 API 호출을 위해

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

베이스 URL 샌드박스용

응용 프로그램 결정

멋진

모듈 Swagger 링크

API 참조

선적 서류 비치

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

후크

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

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

상태 페이지

예정된 릴리스 목록을 보려면 현재 API 상태를 모니터링하세요. view 사고 보고서를 받거나 예정된 유지 관리에 대한 알림을 받으려면 당사를 방문하여 알림을 구독하세요. 상태 페이지

4. 프로그램 설정

SFTP 설정: SFTP를 사용하여 보내십시오. file귀하의 요구 사항과 당사의 요구 사항에 맞게 Cross River에서 다운로드할 수도 있습니다.

고객 온보딩: Cross River에서 고객 정보를 관리하세요 API 또는 COS 탐색기를 사용하는 운영 체제(COS)

COS 제품 유형 및 ID: COS 제품 유형과 ID에 대해 설명합니다.

COS 탐색기: COS Explorer를 사용하는 방법.

조직 관리 포털: 조직 관리 포털을 사용하는 방법.

4.1. SFTP 설정

민감한 정보를 교환해야 할 때 file Cross River를 사용하여 포맷하려면 보안을 사용해야 합니다. File 전송 프로토콜(SFTP). SFTP를 사용하여 전송하거나 file귀하의 요구 사항과 당사의 요구 사항에 따라 Cross River에서 다운로드하거나 다운로드할 수 있습니다. 경우에 따라 귀하 또는 당사가 이를 암호화합니다. file특히 개인 식별 정보(PII)가 포함되어 있는 경우 더욱 그렇습니다.

SFTP 사용

SFTP를 사용하면 민감한 정보를 안전하게 보내고 받을 수 있습니다. file보안 서버에서 비즈니스에 특별히 할당된 폴더를 사용하여 s 및 보고서를 업로드하고 다운로드하세요. file귀하의 특정 요구 사항에 따라 해당 폴더 또는 해당 폴더의 하위 폴더를 통해 이동합니다.

암호화 사용

암호화 files는 추가적인 보호 계층을 추가합니다. 올바른 키를 가진 권한이 있는 사람만 암호화된 내용을 복호화할 수 있습니다. file크로스리버에서는 PGP 암호화를 사용합니다.

시작하세요

SFTP 서버를 사용하려면 여러 단계를 거쳐야 합니다.

1 RM에서 Cross River SFTP 서비스에 대한 IP 액세스 요청 양식을 작성합니다.

공유해야 하는 경우 fileCross River를 사용하는 경우, 담당 관리자가 CRB SFTP 서비스용 IP 액세스 요청 양식을 보내드립니다. SFTP 폴더에 접속하는 데 사용할 고정 공용 IP 주소와 암호화 및 복호화를 위한 PGP 공개 키를 비롯한 여러 정보를 제공해 주셔야 합니다. files. 작성된 양식을 관계 관리자에게 다시 보내십시오.

중요한

Cross River는 허용 IP 주소를 5개까지만 설정하므로 이 점을 유의하세요. IP 주소는 고정 IP여야 합니다. 따라서 고정 IP가 아닌 모든 IP 주소는 사용자 측에서 프록시 설정을 해야 합니다.

2 SFTP 폴더 구조를 설정했습니다.

Cross River에서 고객님의 정보를 수집하면 IT 엔지니어링 부서에서 고객님을 위한 표준 폴더 및 하위 폴더를 생성합니다. 이 고유한 경로는 고객님의 비즈니스에만 사용되며, 다른 파트너는 접근할 수 없습니다. IT 엔지니어링 부서에서 폴더 접근에 필요한 정보가 담긴 이메일을 보내드립니다. 이메일에는 고객님의 자격 증명 링크가 포함되어 있습니다. Cross River는 고객님의 비밀번호를 저장하지 않습니다!

중요한

해당 링크는 며칠 동안만 유효하며, 그 기간 이후에는 사용하지 않을 경우 비밀번호 재설정을 요청해야 합니다.

두 명 이상이 링크에 접속하는 경우에도 자격 증명은 무효화됩니다..

3 SFTP 업로드를 테스트합니다.

당신이 공급할 경우 fileCross River로의 업로드를 위해 IT 부서에서는 자동화된 프로세스를 갖춘 서비스 계정을 설정해야 합니다. fileSFTP 폴더로 전송하세요. 실제 데이터를 전송하기 전에 테스트해 보시기를 강력히 권장합니다. 질문이나 문제가 있는 경우 고객 지원 담당자에게 문의하거나 1차 지원팀에 티켓을 제출하세요.

4 PGP를 설정하여 보내거나 받으세요 file크로스 리버에서 전송합니다. (이 단계는 개인 식별 정보(PII)를 전송하거나 수신하는 경우에만 필요합니다. 담당 RM에게 문의하세요.)

크로스리버를 보내야 하는 경우 files, 우리는 먼저 암호화에 사용할 PGP 공개 키를 귀하에게 보낼 것입니다. files.

PGP 공개 키를 받으려면 이미 Cross River에 보내야 합니다. file우리에게서.

5 데이터를 공유하세요.

SFTP 폴더가 설정되고 프로세스가 완료되면 공유를 시작할 수 있습니다. file저희와 함께합니다. 담당 관리자는 보고서를 받기 위해 더 구체적으로 해야 할 일이 있는지, 또는 저희에게 보낼 데이터를 준비하는 방법을 알려드립니다.

특정 보고서

보고서 준비 및 전송에 대해 자세히 알아보세요. file의 경우:

계정 및 지불

카드 결제

신용 위험

대출

XML 일괄 지불(ISO 20022)

4.2. 고객 온보딩

API 또는 .NET을 사용하여 Cross River 운영 체제(COS)에서 고객 정보를 관리하세요. 이 정보에는 은행 COS Explorer를 개설하는 데 필요한 기본 정보가 포함되어 있습니다.

필요에 따라 계좌 또는 신용카드 사용, 그리고 고객에 대한 보다 구체적인 데이터도 제공합니다. 이를 고객 기록.

예금 계좌를 개설하거나 카드를 생성하기 전에 고객 레코드를 만들어야 합니다. 이를 고객 레코드라고도 합니다. 온보딩. 그런 다음 고객 관리를 통해 하나 이상의 고객을 계정에 할당할 수 있습니다. 관계.

고객 온보딩 프로세스에는 관련 고객 기록을 만드는 것이 포함됩니다. 고객 정보. 이 튜토리얼을 따라 각자의 고객 레코드 고객을 만드세요..

선택 단계

ID 세부 정보 추가

실질 소유자 추가

오류 코드

COS COS 시스템 오류 코드에 대한 많은 다른 참조 정보와 함께 다음을 참조하세요.

참조 코드 페이지.

4.2.1. 고객 기록

고객 기록

고객 레코드는 크로스리버 시스템에서 고객 정보가 포함된 주요 리소스입니다. 따라서 고객 계정을 생성하기 전에 해당 고객을 등록해야 합니다. 고객 레코드는 개인 또는 기업 유형으로 분류할 수 있습니다. 등록이 완료되면 고객을 하나 이상의 계정에 연결할 수 있습니다.

전직amp아래는 개인 고객의 고객을 등록하는 방법을 보여줍니다.

탑승자 요청

POST /core/v1/cm/고객 {

“파트너 ID”: “7cc038be-fde9-4455-b27b-1497cf667362”,

"이름": {

"접두사": "씨.",

“이름”: "남자",

“중간 이름”: “로버트”,

"성": "스미스",

"접미사": “주니어.”,

"선호하는 이름": “짐” },

"분류": "개인의",

"찬성file”: {

“레고”: 거짓,

“시민권국가코드”: "우리를",

"정치적으로 노출된 사람": 거짓,

"백업 보류 활성화": 거짓,

“백업보류퍼센트”: 0,

“세금 ID 유형”: “SSN”,

“세금 ID”: “123456789”,

“생년월일”: “1965-09-15”,

“위험 등급”: "낮은",

“개인정보취소”: 진실 }

} 약간 다른 속성을 가진 동일한 엔드포인트를 사용하여 법인이나 LLC와 같은 비즈니스 고객을 온보딩합니다.

Curl

POST /core/v1/cm/고객 {

“파트너 ID”: “a24cba49-2bb6-431d-a867-1de81d6e4127”,

"이름": {

"엔티티 이름": “ACME CO”, },

"분류": "사업",

"찬성file”: {

“시민권국가코드”: "우리를",

"백업 보류 활성화": 거짓,

“백업보류퍼센트”: 0,

“세금 ID 유형”: “아인”,

“세금 ID”: “123456789”,

"dateFormed": “2019-09-10”,

“엔티티 유형”: "법인",

“위험 등급”: "낮은",

“소유권 유형”: “법인”,

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

개인 고객이나 비즈니스 고객을 온보딩하는지 여부에 관계없이 기본 소유자 고객 ID 속성에는 개인 유형의 고객 레코드를 참조하는 고객 ID가 포함되어야 합니다. 따라서 비즈니스를 온보딩하려면 먼저 해당 비즈니스의 주 소유자에 대한 개인 고객 레코드를 만들어야 합니다.

중요한

일부 고객 엔드포인트에는 다음이 포함됩니다. 실사 개인 고객 온보딩 시 필요할 수도 있고 필요하지 않을 수도 있는 리소스입니다. 담당 규정 준수 담당자는 온보딩 프로세스 중 실사(Due Diligence) 분야에 대한 요구 사항을 전달합니다.

수익자

실소유자는 사업체의 25% 이상을 소유한 사람입니다. 규제상의 이유로 다음 사항을 충족해야 합니다. 사업 고객 기록은 실질 소유자를 생성합니다

해당 사업의 각 실질 소유자에 대해. 소유자고객ID 속성은 각 실질 소유자의 개인 고객 레코드를 참조합니다. 일반적으로 비즈니스를 온보딩한 직후 실질 소유자 리소스를 비즈니스 고객 레코드에 추가합니다.

Curl

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

“소유자고객ID”: “c1210a2d-932e-43ca-be29-f358a4382385”,

“소유자 직함”: "대통령" }

주소

고객과 관련된 물리적 주소는 다음과 같습니다.

업데이트됨

Curl

POST /core/v1/cm/customers/{customerId}/주소

{

“기본입니다”: 진실,

"상태": "활동적인",

"분류": “주거용”,

“주소 유형”: "집",

“거리1”: “메이플 스트리트 123번지”,

“거리2”: “아파트 12”,

“거리3”: “”,

"도시": "뉴욕",

"상태": “뉴욕”,

“우편번호”: “10025”,

“국가 코드”: "우리를",

}

이메일 주소

이메일 업데이트

고객 연락처 정보.

Curl

POST /core/v1/cm/customers/{customerId}/이메일 {

“기본입니다”: 진실,

“이메일 유형”: "개인의",

“이메일 주소”: “john.smith@crossriver.com” }

전화

전화 업데이트 Curl

고객 연락처 정보.

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

{

“전화번호 유형”: "집",

“기본입니다”: 진실,

“전화번호”: “2015551234”

}

식별

신분증은 운전면허증, 여권 등 고객 식별 문서의 메타데이터를 추적하는 데 사용됩니다. 새로운 신분증 정보를 추가하는 데 사용할 수 있습니다. 신분증 정보 추가

Curl

POST /core/v1/cm/customers/{customerId}/식별 {

“기본입니다”: 진실,

“아이디번호”: “DL123456789”,

“idType”: 운전면허증,

“발급일”: “2018-08-30”,

“유효기간”: “2018-08-30”,

“확인된 날짜”: “2018-08-30”,

"발급 기관": “뉴저지 DMV”,

“발행 주 또는 지방”: “뉴저지”,

“발급국가코드”: "우리를",

}

4.2.2. COS 제품 유형 및 ID

크로스 리버에서는 제품 유형 고객에게 제공하는 고유하게 구성된 금융 상품입니다. 예를 들어amp상품 유형은 직불 카드 또는 저축 계좌일 수 있으며, 고객님의 필요와 사양에 따라 구성될 수 있습니다. 고객님께서는 저희와 함께 정의하고 구성하신 상품 유형에 따라 고객 계좌를 개설하실 수 있습니다. 고객 상품 유형 설정 방법을 포함한 자세한 내용은 담당 관리자에게 문의해 주십시오.

예를 들어amp예를 들어, 전신 송금 및 ACH 결제를 사용하는 저축 계좌 상품으로 상품 유형을 설정할 수 있습니다. 그러면 고객에게 이러한 서비스와 구성을 갖춘 저축 계좌를 제공할 수 있습니다.

크로스리버는 고객에게 제공하고자 하는 각 상품 유형에 대한 상품 ID를 제공합니다. 모든 종류의 예금 계좌를 개설하려면 유효한 상품 ID와 계좌 소유자의 고객 ID(온보딩된 고객 기록 ID)가 있어야 합니다. 계좌 소유자는 고객 기록에 최소 하나의 주소와 전화번호를 등록해야 하며, OFAC(외국환은행) 자격은 다음과 같아야 합니다. 분명한. 또한, 고객 분류는 제품에 대해 구성된 분류와 일치해야 합니다. 예를 들어amp즉, 비즈니스 고객만 비즈니스 제품에 추가할 수 있습니다.

4.2.3. COS 탐색기

Cross River 시스템에 접속하고 온보딩 이메일을 받으면

당신의 고객 ID 그리고 비밀 COS Explorer에 로그인할 준비가 되었습니다. COSExplorer 포털에 접속하세요

생산:

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

모래 상자:

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

환영 이메일

귀하께서는 다음으로부터 환영 이메일을 받게 됩니다. CrossRiver_답장하지 마세요@crossriver.com받은 편지함에 메일이 보이지 않으면 스팸이나 차단된 메일 폴더를 확인해 보세요.

딸깍 하는 소리 크로스리버 계정을 만드세요.

언제든지 마법사를 종료하면 원래 이메일의 링크를 클릭하여 중단했던 부분으로 돌아갈 수 있습니다.

이용약관

이용약관을 꼼꼼히 읽어보시고, 수용하다, 그리고 클릭하세요 다음.

SMS(문자메시지)인증

본인 확인을 위해 기기로 SMS(문자 메시지)를 보내드립니다. 로그인 화면에서 받은 6자리 코드를 입력하고 다음을 클릭하세요. 코드 확인.

비밀번호를 생성하세요

1. 화면 요구 사항을 충족하는 비밀번호를 입력하고 비밀번호를 다시 입력하세요.

2. 딸깍 하는 소리 비밀번호 생성.

인증기 앱 설정

등록 과정을 계속 진행하고 나중에 로그인하려면 이 단계를 완료해야 합니다.

귀하의 신원과 계정 및 정보를 보호하기 위해 다중 요소/2단계 인증을 사용하여 로그인해야 합니다.

기기에 인증 앱이 없는 경우 계속 진행하기 전에 앱을 다운로드해야 합니다.

Android 및 iOS의 경우 다음 인증 앱을 사용하는 것이 좋습니다.

구글 인증기

Microsoft 인증자

인증 앱을 설치한 후에는 다음 중 하나를 수행해야 합니다. QR코드를 스캔하세요 or 수동으로 키를 입력하세요 인증 앱으로 들어갑니다.

QR코드

1. 인증 앱에서 QR 코드를 스캔하고, 필요한 경우 다중 인증 요소 페이지에 6자리 코드를 입력하세요.

2. 계속을 클릭하세요.

수동

1. 딸깍 하는 소리 키 표시

2. 키를 다음과 같이 복사하세요. 비밀 인증 앱에서.

3. 6자리 코드를 입력합니다.

4. 딸깍 하는 소리 계속하다.

잘못된 MFA코드

잘못된 MFA 코드를 입력하면 빨간색 메시지가 나타나 다시 시도하라는 알림을 받습니다.

죄송합니다! 잘못된 MFA 코드를 입력했습니다. 다음 사항을 다시 확인해 보세요.

1. 클릭하기 전에 코드 시간이 초과되었나요? 계속하다? 남은 시간은 계정 이름과 MFA 코드 오른쪽에 있는 카운트다운 원으로 표시됩니다.

2. 여러 환경이나 애플리케이션에 대해 인증 앱을 설정한 경우 올바른 코드를 입력했는지 다시 한번 확인하세요.

1. MFA 연결 이름에서 어떤 옵션이 올바른지 확실하지 않은 경우, 작동하는 코드를 찾을 때까지 다른 코드를 시도해야 할 수도 있습니다.

2. 올바른 연결을 찾으면 앱에서 MFA 연결의 이름을 변경할 수 있습니다. MFA 앱 화면 상단의 연필 아이콘을 클릭하면 편집 모드로 전환됩니다. 일부 앱에서는 편집할 연결을 먼저 선택하거나 길게 눌러야 아이콘이 나타납니다.

3. 편집 모드에서는 필요에 따라 연결의 이름을 바꿔서 어떤 연결이 어떤 환경에 적용되는지 명확하게 알 수 있습니다.

4. 변경 사항을 저장하면 다음에 어떤 코드를 사용해야 할지 더 쉽게 이해할 수 있을 것입니다.

복구 코드

기기를 분실한 경우 복구 코드를 사용하여 인증을 받으세요.

1. 복구 코드를 다운로드하거나 복사하여 기억할 수 있는 안전한 장소에 보관하세요.

2. 복구 코드를 저장했는지 확인하세요

3. 딸깍 하는 소리 계정 생성.

복구 코드 페이지는 10분 후에 시간 초과됩니다.

복구 코드는 한 번만 다운로드할 수 있습니다.

이제 귀하의 계정이 활성화되었으며 이를 사용하여 모든 CR 앱에 로그인할 수 있습니다.

IP 허용 목록

COS Explorer에 접속하려면 고정 IP만 사용할 수 있습니다. 도움이 필요하시면 IP 지원팀에 문의하세요.

Identity Server IP 주소는 다음과 같습니다.

172.67.26.222 104.22.40.134 104.22.41.134

서버는 Cloudflare를 통해 프록시됩니다.

다음 FQDN을 허용할 수 있습니다.

idptest.crbcos.com

문제 해결

비밀번호를 잊으셨나요?

1. 딸깍 하는 소리 비밀번호를 잊으셨나요? 이메일을 입력하세요.

2. 인증 앱에서 6자리 인증 코드를 입력하세요. 3. 당신은 얻을 비밀번호를 잊으셨나요? 이메일. 클릭 비밀번호 재설정.

4. 비밀번호 재설정 페이지에서 새 비밀번호를 입력하고 클릭하세요. 비밀번호 재설정, 그리고 응용 프로그램을 계속 진행하세요.

다중 요소 인증 재설정

이미 MFA를 구성한 경우:

1. Identity Server에서 다음으로 이동하세요. MFA 재설정 그리고 클릭하세요 MFA 장치를 재설정하세요. 2. 다중 요소 인증 페이지가 열리고 MFA를 재설정할 수 있습니다.

새로운 다중 인증 복구 코드를 생성할 수도 있습니다.

1. 딸깍 하는 소리 새로운 다중 인증 복구 코드 생성.

2. 복구 코드 페이지가 열리면 10개의 새로운 복구 코드를 복사하거나 다운로드할 수 있습니다.

아직 다중 요소 인증을 구성하지 않은 경우 MFA를 활성화할 수 있습니다. 계정 설정.

1. 딸깍 하는 소리 MFA 방법 재설정.

2. 딸깍 하는 소리 MFA 구성.

3. 다중 인증/2단계 인증의 지침을 따르세요.

현재 MFA가 SMS인 경우 인증 앱에서 MFA를 활성화할 수 있습니다. 계정 설정

1. 딸깍 하는 소리 MFA 방법 재설정.

2. 딸깍 하는 소리 MFA 구성.

3. 다중 인증/2단계 인증의 지침을 따르세요.

복구 코드를 사용하세요

다중 인증(2단계)을 사용할 수 없는 경우 복구 코드 중 하나를 사용하여 로그인할 수 있습니다.

1. 평소처럼 로그인하세요

2. 다중 요소 인증 페이지에서는 복구 코드를 인증 옵션으로 사용할 수 있습니다.

3. 텍스트 상자에 복구 코드 중 하나를 입력하세요. 복구 코드는 일회용이며 재사용할 수 없습니다. 향후 혼란을 방지하기 위해 복구 코드를 '사용됨'으로 표시하는 것이 좋습니다.

계정 잠금

사용자 이름에 대한 비밀번호를 5회 잘못 입력하면 시스템에서 약 5분간 계정을 잠급니다. 5분이 지나도 계정에 접속할 수 없는 경우 Cross River 지원팀에 문의하세요.

브라우저 오류 - 방화벽

COS Explorer에 로그인하면 다음과 같은 오류 화면이 나타납니다.

방화벽에 의해 차단되었습니다.

1. 귀사에서 아웃바운드 트래픽에 방화벽 규칙을 적용하는지 확인하려면 내부 IT 부서에 문의하세요. 아웃바운드 트래픽에 방화벽 규칙이 없는 경우:

2. 내부 IT 부서에 문의하여 승인된 IP 주소에서 Cross River COS Explorer Portal에 연결하고 있는지 확인하세요. IP 주소를 더 등록해야 하는 경우 COS 지원팀으로 이메일을 보내주세요.

4.2.3.1. 사용자 관리

사용자 관리

당신은 사용할 수 있습니다 사용자 의 화면 관리자 고객, 제품, 계정 등의 리소스 집합을 그룹화하려면 탭을 사용합니다. 리소스(예: 제품 또는 고객)가 사용자에게 할당되면 변경할 수 없습니다.

이 공간을 활용하여 고객을 지원하고 변경 사항을 적용할 수 있습니다. 고객 요구에 맞춰 사용자를 생성할 수 있도록 관리자 2명을 배정해 드립니다. 이를 통해 고객을 독립적으로 관리하고, 고객의 요청에 따라 업무 시간 외에 변경 사항을 적용할 수 있습니다.

새로운 사용자를 만들거나 등록할 수도 있습니다.

새로운 사용자 만들기

1 에서 관리자 탭을 클릭하세요 사용자 열다 사용자 검색 화면. 2 딸깍 하는 소리 + 신규 사용자. 그 사용자 생성 화면이 표시됩니다.

3 In 사용자 생성 사용자의 입력 이메일, 다음 필드가 표시됩니다. 이름, 성 그리고 전화 번호.

4 딸깍 하는 소리 상태 그리고 선택하세요 활동적인.

그만큼 전화 번호 필드는 사용자를 인증하는 MFA에 사용되므로 휴대전화 번호여야 합니다.

필드 설명

이름	사용자 이름. 사용자가 Explorer에 로그인할 때 브라우저 창에 표시할 전체 사용자 이름을 입력하세요.
이메일	사용자 이메일 주소입니다. 이 주소는 Explorer 로그인에 사용되며, 비밀번호 재설정 시 복구 이메일로도 사용됩니다.
상태	사용자 상태를 선택하세요. 사용자 상태는 다음과 같습니다. 비활성 기본적으로. 다음으로 변경하세요. 활동적인 사용자를 생성할 때.
사용자 유형	이 필드는 다음을 표시합니다. 파트너 사용자가 생성될 때.
역할	사용자에게 추가할 역할을 선택하거나 클릭하세요. 모든 역할 포함 사용자에게 사용 가능한 모든 역할을 추가합니다. 메모: 귀하에게 할당된 역할만 표시됩니다. 일부 역할에는 Explorer에서 결제를 시작할 수 있는 권한이 포함되어 있습니다. Explorer 관리자는 사용자에게 적절한 사용자 역할과 권한 한도만 부여하여 올바르게 구성되도록 할 책임이 있습니다.

승인된 한도

각 필드에 대해 달러 한도를 선택하세요(해당되는 경우)

5 딸깍 하는 소리 상태 그리고 선택하세요 활동적인.

6 딸깍 하는 소리 역할 새 사용자를 할당할 항목을 선택합니다. 클릭하세요. 구하다 역할 변화.

모두 사용자는 다음으로 구성되어야 합니다. 파트너 코어 레디 전용 역할.

사용자에게 할당된 경우 파트너 와이어 오리지네이션 역할을 수행하려면 해당 사용자의 발신 제한을 구성해야 합니다.

7 사용자에게 다음을 할당하는 경우 파트너 와이어 오리지네이션 역할에 값을 입력하세요 전신송금.결제.발행 송금당 최대 금액 한도를 나타내는 필드입니다. 그렇지 않으면 이 필드를 무시해도 됩니다.

8 모든 필드 구성을 마치면 다음을 클릭하세요. 변경 사항을 저장합니다.

9 새로운 사용자를 성공적으로 생성한 경우 확인 화면이 표시됩니다.

10 사용자 추가 및 구성을 완료하려면 다른 관리자가 필요합니다. 변경 사항 승인.

11 그만큼 보류 중인 변경 사항 승인 화면이 표시됩니다. 클릭하세요 확인하다.

12 View사용자 정보

문서 / 리소스

크로스리버 API 플랫폼 [PDF 파일] 사용자 매뉴얼
API 플랫폼, API 플랫폼, 플랫폼

참고문헌

사용자 설명서

API 플랫폼

시작하세요

1. 환영

크로스 리버에 오신 것을 환영합니다 선적 서류 비치

2. 빠른 시작

2.1. API 자격 증명 가져오기

중요한

2.2. 액세스 토큰 받기

명령줄 인터페이스

Sampc에서의 요청URL COS를 위해

우편 집배원

COS익스플로러

토큰 요청 응답

HTTP 구성 요소

문제 해결

2.3. 액세스 토큰 사용

중요한

API 요청 헤더

2.4. Web갈고리

2.5. 샌드박스 환경

코사인 web갈고리

대출

대출 신청

2.6. 우편 배달부 컬렉션

우편 집배원

우편 배달부 작업 공간

3. 으로 빌드amp앱

3.1. 설정

샌드박스 탐색

관련 등록 web 후크 이벤트

3.2. 고객 및 계정

Web갈고리

Web후크 설명

Examp레오프 레코드크리에이션

중요한

고객 주소 업데이트

API 자격 증명

고객 ID

중요한

3.3. 카드

시작하기 전에

3.4. 대출

신청 결정

멋진

상태 페이지

4. 프로그램 설정

4.1. SFTP 설정

SFTP 사용

암호화 사용

시작하세요

중요한

4.2. 고객 온보딩

4.2.1. 고객 기록

중요한

수익자

Curl

4.2.2. COS 제품 유형 및 ID

4.2.3. COS 탐색기

인증기 앱 설정

QR코드

수동

복구 코드

복구 코드를 사용하세요

계정 잠금

브라우저 오류 - 방화벽

방화벽에 의해 차단되었습니다.

4.2.3.1. 사용자 관리

필드 설명

승인된 한도

문서 / 리소스

참고문헌

댓글을 남겨주세요

답변 취소