Hướng dẫn sử dụng nền tảng API Cross River

Nền tảng API

Bắt đầu

1. Chào mừng

MỚI! Công chúng Cross River với các yêu cầu được xây dựng sẵn cho bộ sưu tập Cross Postman
Dòng sông. Điểm cuối API

Chào mừng đến với Cross River tài liệu

Khám phá, tìm hiểu và bắt đầu tích hợp sản phẩm của chúng tôi một cách dễ dàng

Bắt đầu nhanh Khám phá tất cả sản phẩm

Lấy bắt đầu
Thiết lập và bắt đầu hành trình sử dụng API Cross River

Các khái niệm
Khám phá cách các giải pháp của Cross River có thể thay đổi hành trình công nghệ tài chính của bạn

API
Phát triển bằng cách sử dụng ngân hàng Cross River
nền tảng và bộ API mạnh mẽ

Hướng dẫn
Tìm hiểu cách sử dụng Cross
API sông từng bước

2. Bắt đầu nhanh 

Bước 1
Bước 2
Bước 3
Bước 4

Nhận mã thông báo truy cập

Sử dụng mã thông báo truy cập

Xây dựng một Sampứng dụng le

Nhận thông tin xác thực API: Bước đầu tiên để làm việc với Cross River API là đăng ký thông tin xác thực API.

Nhận mã thông báo truy cập: Sau khi bạn nhận được thông tin xác thực API và trước khi bạn có thể sử dụng API của chúng tôi, bạn phải nhận được mã thông báo truy cập bằng cách sử dụng khách hàng_id Và bí mật của khách hàng bạn nhận được khi đăng ký.

Sử dụng mã thông báo truy cập: Sau khi bạn đã xác thực thành công, một mã thông báo truy cập được trả về cho bạn. Hãy đưa mã thông báo này vào tiêu đề lệnh gọi API của bạn.

Webmóc: WebHook là một thành phần quan trọng của bất kỳ tích hợp nào với Cross River. Mặc dù API cho phép bạn yêu cầu dữ liệu theo yêu cầu, webHooks đẩy các bản cập nhật thời gian thực trực tiếp vào hệ thống của bạn—loại bỏ nhu cầu thăm dò liên tục và giảm độ trễ.

Môi trường hộp cát: Hộp cát là một môi trường hoàn toàn biệt lập, vì vậy hãy thoải mái

2.1. Nhận thông tin xác thực API

Bước 1
Nhận thông tin xác thực API

Bước 2
Nhận mã thông báo truy cập

Bước 3
Sử dụng mã thông báo truy cập

Bước 4
Xây dựng một Sampứng dụng le

Bước đầu tiên để làm việc với Cross River API là đăng ký thông tin xác thực API. Với thông tin xác thực này, bạn có thể yêu cầu và nhận mã thông báo truy cập để sử dụng cho việc gửi API trong môi trường sandbox của chúng tôi.

QUAN TRỌNG

Địa chỉ IP của bạn, phải là địa chỉ công khai và tĩnh, phải nằm trong danh sách cho phép của chúng tôi. Bộ phận CNTT nội bộ của bạn sẽ có thể cung cấp cho bạn IP này. Tìm hiểu thêm về IP tĩnh.

SandboxAccess

Gửi yêu cầu để truy cập hộp cát, để nhận thông tin xác thực API.

Sau khi IP tĩnh của bạn được thêm vào danh sách cho phép của chúng tôi, chúng tôi sẽ gửi cho bạn 2 email được mã hóa có thông tin đăng nhập của bạn:

Một email chứa thông tin của bạn khách hàng_id , id_đối_tác và các thông tin khác mà bạn cần tùy thuộc vào những gì bạn yêu cầu.

Email thứ hai, được mã hóa, chứa thông tin của bạn bí mật của khách hàng Và webbí mật móc . Bạn sẽ cần những thông tin này để xác thực và làm việc trong môi trường thử nghiệm.

GHI CHÚ

Nếu bạn yêu cầu quyền truy cập vào Thanh toán bằng thẻ, bạn sẽ nhận được một bộ thông tin xác thực bổ sung bao gồm thông tin thứ hai khách hàng_id Và bí mật của khách hàng

2.2. Nhận mã thông báo truy cập

Bước 1
Nhận thông tin xác thực API

Bước 2
Nhận mã thông báo truy cập

Bước 3

Sử dụng mã thông báo truy cập

Bước 4
Xây dựng một Sampứng dụng le

Cross River sử dụng OAuth 2.0 để xác thực và ủy quyền. Điều này kiểm soát việc truy cập vào hệ thống của chúng tôi và đảm bảo rằng chỉ những thực thể được ủy quyền mới có thể truy cập API và các tài nguyên được bảo vệ khác của chúng tôi. Thông tin bạn nhập vào hệ thống xác thực của chúng tôi được bảo mật và không bao giờ có thể bị truy cập từ bất kỳ ứng dụng Cross River nào khác.

Sau khi bạn nhận được và trước khi bạn có thể sử dụng API của chúng tôi, bạn phải có thông tin xác thực API một mã thông báo truy cập sử dụng khách hàng_id Và bí mật của khách hàng Bạn đã nhận được mã thông báo truy cập này khi đăng ký. Mã thông báo truy cập này cho phép bạn gửi thông tin một cách an toàn dưới dạng đối tượng JSON để sử dụng trong API của chúng tôi. Bạn phải thêm mã thông báo này vào tiêu đề của mỗi yêu cầu API.

Có một số cách để yêu cầu và nhận mã thông báo truy cập:

Sử dụng Giao diện dòng lệnh (CLI) với cURL hoặc bất kỳ ngôn ngữ nào khác

Sử dụng Postman hoặc bất kỳ công cụ kiểm tra API nào khác

Sau khi nhận được, hãy sao chép mã thông báo truy cập vào bộ nhớ tạm. Nhớ lưu lại.

Giao diện dòng lệnh

Để yêu cầu một mã thông báo gửi một POST kết nối/mã thông báo lệnh chứa khách hàng_id Và bí mật của khách hàng Và Grant_type đến (máy chủ xác thực) của máy chủ xác thực hộp cát thích hợp, như được hiển thị trong sampbên dưới.

Tham khảo để biết lời giải thích về những điều này tags. Bảng thành phần HTTP

Các ví dụ sau đâyample sử dụng cURL để yêu cầu mã thông báo từ một trong các máy chủ xác thực.

Sampyêu cầu trong cURL cho COS

curl –vị trí –yêu cầu 'POST https://idptest.crbcos.com/connect/token' \ –header 'Content-Type: application/x-www-form-urlđược mã hóa' \ –dữ liệu-urlmã hóa 'client_id=[id của bạn ở đây]' \

 –dữ liệu-urlmã hóa 'client_secret=[bí mật của bạn ở đây]' \

 –dữ liệu-urlmã hóa 'grant_type=client_credentials' \

 –dữ liệu-urlmã hóa 'khán giả=https://api.crbcos.com/'

Sampphản hồi từ cURL lời yêu cầu

{ “mã thông báo truy cập”: “chứa nhiều ký tự”, \

 “hết hạn vào”: 86400, \

 “kiểu_mã_mã_token”: “Người mang” }

Người đưa thư

Để yêu cầu mã thông báo bằng Postman, hãy gửi POST kết nối/mã thông báo lệnh cho xác thực máy chủ của hộp cát thích hợp. Thêm Grant_type , phạm vi (tùy chọn) ,

khách hàng_id Và bí mật của khách hàng để gọi.

Tham khảo để biết lời giải thích về những điều này tags. Bảng thành phần HTTP

Nếu xác thực thành công, mã trạng thái là 200 (OK).

COSExplorer

Trong , nhấp vào mũi tên xuống bên cạnh thông tin đăng nhập của bạn và nhấp vào Sao chép mã thông báo truy cập. Trình khám phá COS

Mã thông báo truy cập được sao chép vào bảng tạm của bạn, sẵn sàng để sử dụng trong . Sandbox

Phản hồi yêu cầu mã thông báo

Mô tả thuộc tính

truy cập vào ken	JSON được ký kỹ thuật số web mã thông báo (JWT) được gửi từ máy chủ oAuth cho phép truy cập vào các tài nguyên Cross River cụ thể
phạm vi	Một loạt các dịch vụ mà người dùng có thể truy cập
hết hạn_i n	Khoảng thời gian cho đến khi mã thông báo hết hạn. – Nhóm tích hợp của chúng tôi sẽ thông báo cho bạn về thời gian hết hạn hoặc bạn cũng có thể giải mã mã thông báo truy cập của mình. – Chúng tôi khuyên bạn nên lấy lại mã truy cập mới trước khi mã cũ hết hạn một thời gian ngắn. – Tái sử dụng mã thông báo trong toàn bộ vòng đời của chúng thay vì nhận mã thông báo mới cho mỗi lần gọi đến cùng một tài nguyên được bảo vệ (API). QUAN TRỌNG: Không bao giờ giải mã mã thông báo của bạn trên một máy chủ công cộng webđịa điểm

loại mã thông báo

Mã thông báo người mang

Các thành phần HTTP

Các thành phần HTTP sau đây được sử dụng trong cả yêu cầu API và Postman.

Giao thức HTTP

thành phần

Tag Sự miêu tả

Điểm cuối	BƯU KIỆN /kết nối/toke n	Điểm cuối để lấy mã thông báo truy cập
Tiêu đề	nội dung kiểu	ứng dụng/x-www-form- urlđược mã hóa
Thân hình	khách hàng_id	Mã định danh duy nhất cho một khách hàng
Thân hình	client_secre t	Một chuỗi ký tự được mã hóa dùng để ký và xác thực mã thông báo ID. Quan trọng: Bí mật không thể khôi phục bằng CR. Nếu bạn mất bí mật, bạn phải tạo bí mật mới. Không được chuyển giao bí mật của bạn vào bộ phận kiểm soát nguồn.
Thân hình	Grant_type	Trường này sẽ luôn có giá trị là thông tin đăng nhập của khách hàng
Thân hình	khán giả không bắt buộc	Một cách để người dùng xác thực xem mã thông báo truy cập cụ thể có dành cho họ hay không.
Thân hình	phạm vi không bắt buộc	Một phạm vi cụ thể hoặc một tập hợp các dịch vụ giới hạn mà người dùng có thể truy cập bằng mã thông báo truy cập. Nếu phạm vi không được chỉ định, mã thông báo trả về sẽ chứa tất cả phạm vi được liên kết với thông tin đăng nhập của bạn. Ghi chú: Có thể gửi nhiều phạm vi trong cùng một yêu cầu bằng cách thêm khoảng trắng giữa tên của từng phạm vi. Ví dụ:ample: 'scope=scope1 phạm vi2 phạm vi3'

Máy chủ xác thựcURLs

Mô-đun máy chủ xác thực URL

Tài khoản	https://idptest.crbcos.com/connect/token
ACH	https://idptest.crbcos.com/connect/token
Dây điện	https://idptest.crbcos.com/connect/token
Kiểm tra	https://idptest.crbcos.com/connect/token
Lõi	https://idptest.crbcos.com/connect/token
Thanh toán tức thì	https://idptest.crbcos.com/connect/token
Phát hành thẻ	https://idptest.crbcos.com/connect/token
Thanh toán bằng thẻ	https://crbcos-sandbox.auth0.com/oauth/token

Cho vay https://oauthtest.crbnj.net/connect/token

Xử lý sự cố

Nếu mã xác thực hợp lệ, nó sẽ trả về mã 200. Nếu mã xác thực không hợp lệ, nó sẽ trả về mã 401.

Nếu bạn không thể nhận được mã thông báo mang theo và trước đây bạn chưa từng nhận được mã thông báo nào:

Xác nhận URL.

Kiểm tra xem khách hàng_id Và bí mật của khách hàng được gõ đúng. Chúng phân biệt chữ hoa và chữ thường.

Kiểm tra của bạn khách hàng_id Và bí mật của khách hàng so với thông tin bạn nhận được. Đảm bảo không có vấn đề gì về mạng hoặc danh sách cho phép.

Liên hệ với Nhóm tích hợp của chúng tôi nếu tài khoản của bạn bị khóa do 3 lần đăng nhập không chính xác cố gắng.

2.3. Sử dụng mã thông báo truy cập

Bước 1
Nhận thông tin xác thực API

Bước 2
Nhận mã thông báo truy cập

Bước 3
Sử dụng mã thông báo truy cập

Bước 4
Xây dựng một Sampứng dụng le

Khi bạn đã thành công, một mã thông báo truy cập được trả lại cho bạn. Bao gồm xác thực mã thông báo này trong tiêu đề lệnh gọi API của bạn.

Mã thông báo truy cập sẽ hết hạn sau một khoảng thời gian nhất định. Phản hồi chứa mã thông báo cũng chỉ định thời gian hết hạn tính bằng giây. Hãy lưu trữ và sử dụng mã thông báo truy cập của bạn cho đến khi hết hạn. Chúng tôi khuyên bạn nên sử dụng mã thông báo cho đến khi gặp lỗi 401, sau đó yêu cầu mã thông báo mới.

QUAN TRỌNG

1. Không yêu cầu mã thông báo mới cho mọi yêu cầu API.

2. Hãy đảm bảo bảo vệ token của bạn. Bất kỳ ai đánh cắp token của bạn đều có thể mạo danh khách hàng của bạn trong suốt thời gian tồn tại của token.

Tiêu đề yêu cầu API

Trong tiêu đề của mỗi yêu cầu API, hãy bao gồm mã thông báo truy cập như sau:

Sampgọi điện để thanh toán bằng chuyển khoảnURL

curl –location –request 'POST https://sandbox.crbcos.com/Wires/v1/payments' –header 'Ủy quyền: Người mang [MÃ THÔNG BÁO CỦA BẠN TẠI ĐÂY]' \

–header 'Content-Type: application/x-www-form-urlđược mã hóa' \

–dữ liệu thô '{

 “accountNumber”: “2255685659”,

 “businessFunctionCode”: “CTR”,

 “receiverRoutingNumber”: “021000021”,

 “người thụ hưởngFi”: {

 “idCode”: “F”,

 “mã định danh”: “021000021”,

 “tên”: “JP Morgan Chase”

 },

 “người thụ hưởng”: {

 “idCode”: “D”,

 “mã định danh”: “123456789”,

 “tên”: “Peter Griffin”

 },

 “beneficiaryReference”: “XYZ123”,

 “số tiền”: 10000,

 “mục đích”: “thanh toán”

}'

Người đưa thư

Để sử dụng mã thông báo trong Postman, hãy điều hướng đến Ủy quyền tab trong yêu cầu của bạn, chọn Người mang Token làm loại xác thực và dán mã thông báo của bạn vào trường được cung cấp. Người đưa thư sẽ tự động thêm Người mang tiền tố và mã thông báo cho Mã thông báo cánh đồng.

2.4. Webmóc

WebHook là một thành phần quan trọng của bất kỳ tích hợp nào với Cross River. Mặc dù API cho phép bạn yêu cầu dữ liệu theo yêu cầu, webHooks đẩy các bản cập nhật thời gian thực trực tiếp vào hệ thống của bạn, loại bỏ nhu cầu thăm dò liên tục và giảm độ trễ. Trong nhiều trường hợp, webhook hiệu quả và đáng tin cậy hơn so với chỉ sử dụng API, đảm bảo ứng dụng của bạn luôn đồng bộ với các sự kiện quan trọng như thay đổi tài khoản, cập nhật giao dịch và kết quả xử lý.

Sử dụng webCác hook trong hệ thống Cross River để thông báo cho bạn khi các sự kiện khác nhau xảy ra. Sự kiện này trả về một đối tượng tài nguyên chứa thông tin chi tiết liên quan đến chủ đề của mỗi sự kiện. Toàn bộ chi tiết sự kiện sẽ được bao gồm và gửi đến hệ thống của bạn.

Chúng tôi sử dụng webmóc để cập nhật cho bạn về trạng thái và báo cáo những thay đổi trong giao dịch. Webhooks báo cáo cho hệ thống của bạn bằng thông báo thời gian thực khi có sự kiện xảy ra.

Bạn phải đăng ký qua API để sử dụng webmóc:

Đăng ký tài khoản, thẻ và sự kiện thanh toán

Đăng ký sự kiện thanh toán bằng thẻ

Đăng ký sự kiện cho vay

2.5. Môi trường hộp cát

Hộp thử nghiệm của chúng tôi là một môi trường hoàn toàn biệt lập, vì vậy hãy thoải mái thử nghiệm. Khi bạn sẵn sàng chuyển sang môi trường sản xuất, hãy cho chúng tôi biết và chúng tôi sẽ cấp cho bạn thông tin đăng nhập sản xuất để truy cập môi trường trực tiếp.

Quản lý khách hàng

Cơ sở mô-đun URL cho các cuộc gọi API

Quản lý khách hàng https://sandbox.crbcos.com/core/ Tài khoản

Cơ sở mô-đun URL cho các cuộc gọi API

Tài khoản tiền gửi

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

Quét tiền gửi https://sandbox.crbcos.com/sweepsintrafi/ Thẻ

Cơ sở mô-đun URL cho các cuộc gọi API

Thẻ https://sandbox.crbcos.com/cardmanagement/Thanh toán

Cơ sở mô-đun URL cho các cuộc gọi API

Thanh toán tức thì	https://sandbox.crbcos.com/rtp/
Thanh toán bằng thẻ: Nhấn để thanh toán	https://pushtopaystaging.crbnj.net/
Thanh toán bằng thẻ: Kéo	https://pullfromcardapistg.crbnj.net/
Thanh toán quốc tế	https://sandbox.crbcos.com/international/
ACH	https://sandbox.crbcos.com/ach/
Dây điện	https://sandbox.crbcos.com/wires/

Kiểm tra https://sandbox.crbcos.com/checks/ COSwebmóc

Cơ sở mô-đun URL cho các cuộc gọi API

COS webmóc

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

Cho vay

Cơ sở mô-đun URL cho các cuộc gọi API

Nguồn gốc khoản vay

https://arixapisandbox.crbnj.net

Quyết định ứng dụng https://lendingsandbox.crbcos.com/preapproval/v1

2.6. Bộ sưu tập của người đưa thư

Để phát triển dễ dàng hơn, chúng tôi đã kết hợp một số tính năng được xây dựng sẵn

Bộ sưu tập của người đưa thư yêu cầu cho tất cả Cross River. Sử dụng bộ sưu tập này để khám phá, kiểm tra và xây dựng các điểm cuối API tích hợp của bạn trực tiếp trong Postman. với yêu cầu mã hóa và thiết lập bổ sung tối thiểu. Để phân nhánh ngay bộ sưu tập của chúng tôi, hãy nhấp vào

Chỉ cần hoàn tất các chi tiết thiết lập và bắt đầu thực hiện cuộc gọi trong bộ sưu tập Sandbox Postman bởi vì .

Người đưa thư

Mã thông báo truy cập (người mang)

Chúng tôi đã tạo môi trường sandbox dành cho nhà phát triển Postman để cung cấp một không gian an toàn cho việc kiểm tra các API Cross River. Trong bộ sưu tập Cross River Postman, bạn thực hiện xác thực bằng mã thông báo người mang.

Để lấy ID, bạn cần thiết lập mã thông báo truy cập (người mang) cần thiết để chạy bộ sưu tập:

1. : Với những thông tin xác thực này, bạn yêu cầu và nhận được mã thông báo truy cập

Nhận thông tin xác thực API
để sử dụng để gửi API trong môi trường hộp cát của chúng tôi

2. : Sau khi bạn nhận được thông tin xác thực API của mình và trước khi bạn có thể sử dụng

Nhận mã thông báo truy cập
API, bạn nhận được mã thông báo truy cập bằng cách sử dụng khách hàng_id Và bí mật của khách hàng bạn nhận được khi đăng ký.

Bộ sưu tập Fork Cross River

Hãy đến thẳng để xem bộ sưu tập của chúng tôi.

Không gian làm việc của người đưa thư

Sau khi phân nhánh, đừng quên thiết lập biến môi trường cho sandbox.

Cấu hình môi trường Postman của bạn

Để sử dụng bộ sưu tập bạn vừa tạo, hãy điều hướng đến bộ sưu tập đó, nhấp vào Môi trường, và chọn Hộp cát. Sao chép ID khách hàng Cross River và bí mật khách hàng của bạn và dán chúng vào client_Id Và bí mật của khách hàng trường. Đối với Thanh toán bằng Thẻ, hãy dán chúng vào ptpe_client_id Và ptpe_client_secret cánh đồng.

Bây giờ bạn đã sẵn sàng, hãy lấy mã thông báo và bắt đầu gửi yêu cầu.

1. Chạy Ủy quyền/Nhận mã thông báo để tạo mã thông báo của bạn. Đối với Thanh toán bằng thẻ, hãy chạy Thanh toán bằng thẻ/Ủy quyền/Nhận mã thông báo P2PE .

2. Biến số {{token}} (hoặc ptpe_token (đối với Thanh toán bằng Thẻ) sẽ được tự động thêm vào môi trường của bạn bằng một tập lệnh phản hồi sau. Khi mã thông báo hết hạn, bạn cần thực hiện lại bước 1.

3. Có một số biến mà bạn có thể cần phải điền tùy thuộc vào điểm cuối bạn đang thực hiện. Ví dụ:amplà, id_đối_tác , sản phẩm_id , cấu hình_id Và gọi lại_url .

4. Ngoài ra còn có một số biến được điền thông qua các tập lệnh, chẳng hạn như dấu hiệu Và ptpe_token không nên điền thông tin theo cách thủ công.

Pingthesandbox

Chạy một thử nghiệm đơn giản để xác minh rằng bạn có thể kết nối với hộp cát Cross River.

Để gửi yêu cầu Ping, trong Postman mở Bộ sưu tập > Bộ sưu tập API Cross River > Ủy quyền và chạy Bình điểm cuối.

Yêu cầu sửa đổi

Để cập nhật yêu cầu, hãy thực hiện các thay đổi của bạn trên Thân hình tab. Các giá trị trong double curlDấu ngoặc y được lấy từ các biến môi trường của bạn. Hãy kiểm tra tài liệu API của chúng tôi để xem mỗi trường có những trường nào.

điểm cuối chấp nhận và view yêu cầu bằng ngôn ngữ bạn muốn.

3. Xây dựng nhưampứng dụng

Bước 1
Nhận thông tin xác thực API Cài đặt

Bước 2
Nhận mã thông báo truy cập

Bước 3
Sử dụng mã thông báo truy cập

Bước 4
Xây dựng một Sampứng dụng le

: Trước khi bắt đầu, hãy tham khảo hướng dẫn bắt đầu nhanh của chúng tôi để kết nối với API. Để kiểm tra các lệnh gọi API, bạn có thể sử dụng cURL từ dòng lệnh hoặc một dịch vụ như Postman hoặc Swagger trong hộp cát của chúng tôi.

Khách hàng và tài khoản
: Trước khi sử dụng dịch vụ Cross River, bạn cần tạo một hồ sơ khách hàng cho mỗi khách hàng của bạn

Thẻ
: Quản lý thẻ của khách hàng bằng cách làm việc với Cross River để quyết định những gì bạn muốn cung cấp, chẳng hạn như thẻ vật lý hoặc thẻ ảo.

Cho vay
: Cho vay bao gồm một tập hợp các lệnh gọi API cho vay để cho phép bạn tạo, cập nhật, và quản lý các khoản vay của bạn.

3.1. Cài đặt

Trước khi bắt đầu, hãy tham khảo hướng dẫn của chúng tôi để kết nối với API. Để kiểm tra API, hãy bắt đầu nhanh

cuộc gọi, bạn có thể sử dụng cURL từ dòng lệnh hoặc một dịch vụ như Postman hoặc Swagger trong hộp cát của chúng tôi.

Để tạo thẻ hoặc ứng dụng thanh toán, bạn phải tạo khách hàng và tài khoản.

Khám phá hộp cát

Chúng tôi có đầy đủ để bạn khám phá. Hộp cát là môi trường hộp cát hoàn toàn biệt lập từ môi trường sản xuất, vì vậy hãy thoải mái thử nghiệm. Khi bạn đã sẵn sàng chuyển sang môi trường sản xuất, hãy trao đổi với quản lý quan hệ khách hàng của bạn, người sẽ cấp cho bạn thông tin đăng nhập sản xuất để truy cập vào môi trường trực tiếp.

Đăng ký có liên quan web sự kiện móc

WebHook là một thành phần quan trọng của bất kỳ tích hợp nào với Cross River. Mặc dù API cho phép bạn yêu cầu dữ liệu theo yêu cầu, webHooks đẩy các bản cập nhật thời gian thực trực tiếp vào hệ thống của bạn—loại bỏ nhu cầu thăm dò liên tục và giảm độ trễ. Trong nhiều trường hợp, webhook hiệu quả và đáng tin cậy hơn so với chỉ sử dụng API, đảm bảo ứng dụng của bạn luôn đồng bộ với các sự kiện quan trọng như thay đổi tài khoản, cập nhật giao dịch và kết quả xử lý.

Đăng ký để nhận được websự kiện móc. Khi websự kiện móc được kích hoạt, sự kiện các đối tượng được gửi đến nơi đã đăng ký URLs.

3.2. Khách hàng và tài khoản

Bước 1
Nhận thông tin xác thực API

Bước 2
Nhận mã thông báo truy cập

Bước 3
Sử dụng mã thông báo truy cập

Bước 4
Xây dựng một Sampứng dụng le

Tạo hồ sơ khách hàng và tài khoản được cấp vốn:

Tạo hồ sơ khách hàng

Tạo tài khoản tiền gửi

Nạp tiền vào tài khoản

Tạo hồ sơ khách hàng

Trước khi sử dụng dịch vụ Cross River, bạn cần tạo hồ sơ khách hàng cho từng dịch vụ

khách hàng của bạn. Quy trình tiếp nhận khách hàng bao gồm việc tạo ra một hồ sơ khách hàng với thông tin khách hàng có liên quan.

Tất cả khách hàng đều được quét tự động cho mục đích tuân thủ quy định, vì vậy bạn cần đăng ký cho các mục đích liên quan webmóc sự kiện để nhận thông tin cập nhật trạng thái hồ sơ khách hàng.

Hồ sơ khách hàng có thể dành cho một trong hai Riêng tư or Việc kinh doanh khách hàng. Sau khi đăng ký, một khách hàng có thể được liên kết với một hoặc nhiều tài khoản.

Webmóc

Đăng ký vì webmóc. Sau đây webmóc được sử dụng:

WebMô tả móc

Core.Customer.Onboarded	Thông báo cho bạn rằng hồ sơ khách hàng đã được tạo
Core.Customer.Ofac.Changed	Thông báo cho bạn rằng trạng thái OFAC của khách hàng đã được cập nhật

Core.Customer.PepScan.Chan ged

Nthông báo cho bạn rằng trạng thái PEP của khách hàng đã được cập nhật

Exampleof recordcreation

Trong ví dụ nàyample, chúng ta sẽ đưa John Smith lên tàu. Trước tiên, hãy tạo một hồ sơ khách hàng. Chúng ta đang đăng ký John là Riêng tư khách hàng.

Để đưa một khách hàng doanh nghiệp lên tàu, trước tiên hãy tạo một hồ sơ khách hàng cá nhân cho chủ sở hữu chính của doanh nghiệp đó. Sau đó, tạo khách hàng doanh nghiệp và thêm hồ sơ cá nhân với tư cách là chủ sở hữu thực sự.

1 Gọi POST /core/v1/cm/customers .

Trong ví dụ sauampnhững gì bạn có thể thấy là bắt buộc. những thuộc tính nào

QUAN TRỌNG

Chúng tôi thực sự khuyên bạn nên bao gồm khóa idempotency trong tiêu đề yêu cầu của bạn

để cung cấp khả năng bảo vệ trùng lặp trong trường hợp xảy ra lỗi.

Curl

curl -X POST /core/v1/cm/customers –header 'Content-Type: application/j {

 “ID đối tác”: “6e80b097-693c-4592-8440-02f345335bbf”,

 "tên": {

 “Tên”: “John”,

 "họ": “Thợ rèn”

 },

 “phân loại”: "Riêng tư",

 “Chuyên nghiệpfile": {

 “regO”: SAI,

 “politicallyExposedPerson”: SAI,

 “taxIdType”: “Ssn”,

 “mã số thuế”: “119988776”,

 “Ngày sinh”: “1953-09-22”,

 “Rủi ro Xếp hạng”: "Thấp"

 “địa chỉ chính”: {

 “Loại địa chỉ”: "Trang chủ",

 “phân loại”: “Khu dân cư”,

 “isPrimary”: ĐÚNG VẬY,

 “đường phố1”: “123 Đường Any”,

 "thành phố": “Bất cứ nơi đâu”,

 "tình trạng": “NY”,

 “Mã bưu chính”: “12345”,

 “Mã quốc gia”: "CHÚNG TA"

 },

 “điện thoại chính”: {

 “isPrimary”: ĐÚNG VẬY,

 “Loại điện thoại”: "Trang chủ",

 “Số điện thoại”: “2015551234”

 },

 “primaryEmail”: {

 “isPrimary”: ĐÚNG VẬY,

 “Loại email”: "Riêng tư",

 “Địa chỉ email”: “John.Smith@xxxxx.com”

 }

}

Một lệnh gọi API thành công sẽ trả về phản hồi JSON với ID khách hàng duy nhất ở dòng đầu tiên của nội dung phản hồi. Khách hàng của bạn đã được tạo.

Đưa một cơ quan phản hồi khách hàng lên tàu

{

 "nhận dạng": “9052b6a5-3f09-41d1-b526-ade80104eb79”,

 “cifNumber”: “32653745014”,

 “phân loại”: "Riêng tư",

 "trạng thái": "Tích cực",

 “ofac”: "Chưa giải quyết",

 “pepScan”: "Chưa giải quyết",

 "tên": {

 “Tên”: “John”,

 "họ": “Thợ rèn”,

 “Tên đầy đủ”: “John Smith”

 },

 “Chuyên nghiệpfile": {

 “regO”: SAI,

 “politicallyExposedPerson”: SAI,

 “bật BackupWithholding”: SAI,

 “taxIdType”: “Ssn”,

 “mã số thuế”: “119988776”,

 “Ngày sinh”: “1953-09-22”,

 “Rủi ro Xếp hạng”: "Thấp"

 },

 “createdAt”: “2021-01-25T17:55:24.4422582-05:00”,

 “lastModifiedAt”: “2021-01-25T17:55:24.4432543-05:00”,

 “ID đối tác”: “6e80b097-693c-4592-8440-02f345335bbf”

}

2 Các Core.Customer.Onboarded webSự kiện hook được kích hoạt khi bản ghi khách hàng được tạo.

Sự kiện chào đón khách hàng

{

 "nhận dạng": “3d9c5e1a-623b-4cf2-812e-ade80105048e”,

 “tên sự kiện”: “Core.Customer.Onboarded”,

 "trạng thái": "Chưa giải quyết",

 “ID đối tác”: “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 “createdAt”: “2021-11-22T10:50:20.553-05:00”,

 "tài nguyên": [

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

 "chi tiết": []

}

Cross River quét hồ sơ khách hàng mới để đảm bảo tuân thủ OFAC và PEP.

Đôi khi kết quả quét đòi hỏi phải xem lạiview bởi nhóm Chống rửa tiền (AML) của chúng tôi.

Khi quét xong, Core.Customer.Ofac.Changed Và

Core.Customer.PepScan.Changed websự kiện móc trả về với trạng thái. Khách hàng không có vấn đề tuân thủ sẽ hiển thị Thông thoáng trạng thái.

Quét OFAC của khách hàng đã thay đổi

{

 "nhận dạng": “45db5592-56ee-41f5-85e7-ade8010571ce”,

 “tên sự kiện”: “Core.Customer.Ofac.Changed”,

 "trạng thái": "Chưa giải quyết",

 “ID đối tác”: “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 “createdAt”: “2021-11-22T10:51:53.657-05:00”,

 "tài nguyên": [

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

 "chi tiết": []

}

Quét PEP của khách hàng đã thay đổi

{

 "nhận dạng": “a5000831-3e01-4231-9ec2-ade8010571c5”,

 “tên sự kiện”: “Core.Customer.PepScan.Changed”,

 "trạng thái": "Chưa giải quyết",

 “ID đối tác”: “30dee145-b6a2-4058-8dc3-ac4000dee91f”,

 “createdAt”: “2021-11-22T10:51:53.597-05:00”,

 "tài nguyên": [

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

 "chi tiết": []

}

Bây giờ bạn đã tạo xong hồ sơ khách hàng.

Cập nhật hồ sơ khách hàng

Có thể cập nhật thông tin khách hàng như địa chỉ, số điện thoại và email. Những thông tin này được xem xét sơ đẳng thông tin. Nếu bạn thêm địa chỉ thứ hai, đây là sơ trung.

1 Sử dụng ID khách hàng được trả về khi bạn tạo hồ sơ khách hàng để gọi POST /core/v1/cm/customers/{id}/addresses để thêm . Địa chỉ khách hàng đầu tiên

địa chỉ bạn thêm là sơ đẳng địa chỉ. Trong ví dụ sauampbạn có thể thấy những thuộc tính nào là bắt buộc.

Cập nhật địa chỉ khách hàng

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

 “Loại địa chỉ”: "Trang chủ",

 “phân loại”: “Khu dân cư”,

 “isPrimary”: ĐÚNG VẬY,

 “đường phố1”: “123 Đường Any”,

 "thành phố": “Bất cứ nơi đâu”,

 "tình trạng": “NY”,

 “Mã bưu chính”: “12345”,

 “Mã quốc gia”: "CHÚNG TA"

}

2 Gọi POST /core/v1/cm/customers/{id}/phones để thêm vào

điện thoại khách hàng

. Số điện thoại đầu tiên bạn thêm vào là sơ đẳng số điện thoại.

con số

Cập nhật số điện thoại của khách hàng

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

 “isPrimary”: ĐÚNG VẬY,

 “Loại điện thoại”: “Di động”,

 “Số điện thoại”: “2015552345”

}

3 Gọi POST /core/v1/cm/customers/{id}/email để cập nhật email của khách hàng

Cập nhật email khách hàng

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

 “isPrimary”: ĐÚNG VẬY,

 “Loại email”: "Riêng tư",

 “Địa chỉ email”: “john.jones@xxx.com”

}

Tạo tài khoản tiền gửi

CR cung cấp nhiều loại tài khoản khác nhau, bao gồm séc và tiết kiệm, Giấy chứng nhận tiền gửi (CD hoặc tài khoản tiền gửi có kỳ hạn) và nhiều loại khác.

Để mở bất kỳ loại tài khoản tiền gửi nào, bạn phải có ID sản phẩm hợp lệ cho loại tài khoản bạn muốn mở và ID khách hàng (ID hồ sơ khách hàng đã được tích hợp) của chủ tài khoản. Lưu ý rằng chủ tài khoản phải có ít nhất một địa chỉ và số điện thoại trong hồ sơ khách hàng của họ, và tình trạng OFAC của họ phải là Thông thoáng. Ngoài ra, phân loại khách hàng phải khớp với phân loại đã cấu hình cho sản phẩm. Ví dụ:ample, chỉ có khách hàng doanh nghiệp mới có thể được thêm vào sản phẩm doanh nghiệp.

Trước khi bạn bắt đầu

Hãy đảm bảo bạn có:

Thông tin xác thực API

ID đối tác (mà bạn nhận được khi đăng ký)

Mã khách hàng

ID sản phẩm (xác định loại tài khoản đang được mở)

QUAN TRỌNG

Chúng tôi thực sự khuyên bạn nên bao gồm khóa idempotency trong tiêu đề yêu cầu để ngăn chặn việc thanh toán trùng lặp trong trường hợp xảy ra lỗi.

Điểm cuối và webmóc

Điểm cuối API sau đây được sử dụng:

Mô tả API

Mở tài khoản tiền gửi Mở tài khoản tiền gửi cho khách hàng

Sau đây là webmóc được sử dụng:

WebMô tả móc

Lõi.Tài khoản.Đã mở Một tài khoản mới đã được mở

Mở tài khoản

Trong tình huống sau, bạn sẽ mở tài khoản cho John Smith, một khách hàng mà bạn đã tiếp nhận thành công.

Mở tài khoản

1 Gọi POST core/v1/dda/tài khoản .Đối với lệnh gọi này, một số thuộc tính là bắt buộc. Xem đầy đủ .

danh sách các thuộc tính

Sampyêu cầu

POST /core/v1/dda/accounts

{

 “customerId”: “59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 “productId”: “44015e68-1afb-40fc-9497-abc1014f52da”,

 "tiêu đề": “John Smith”,

 “statementAddress”: {

 “đường phố1”: “257 Dalton Groves”,

 "thành phố": “Thành phố Barton”,

 "tình trạng": “Tôi”,

 “Mã bưu chính”: “48705”,

 “Mã quốc gia”: "CHÚNG TA"

 }

}

2 Cuộc gọi API thành công sẽ trả về phản hồi JSON với thông tin chi tiết về tài khoản mới.

Sampcâu trả lời

BƯU KIỆN /cốt lõi/v1/dda/tài khoản

{

 “customerId”: “59e3bc15-bbec-4990-88e9-a9a600d3296c”,

 “productId”: “44015e68-1afb-40fc-9497-abc1014f52da”,

 "tiêu đề": “John Smith”,

 “statementAddress”: {

 “đường phố1”: “257 Dalton Groves”,

 "thành phố": “Thành phố Barton”,

 "tình trạng": “Tôi”,

 “Mã bưu chính”: “48705”,

 “Mã quốc gia”: "CHÚNG TA"

 }

}

3 Các Số tài khoản trường này cung cấp số tài khoản cho tài khoản mới.

4 Trong phản hồi example, tài khoản được phân loại là Riêng tư vì người dùng đã cấu hình phân loại sản phẩm như Riêng tư. Phân loại tài khoản luôn khớp với phân loại sản phẩm đã cấu hình.

5 Trạng thái tài khoản được tự động cập nhật thành Tích cực và có thể sử dụng ngay lập tức. Điều này kích hoạt Lõi.Tài khoản.Đã mở sự kiện.

Chi tiết sự kiện Core.Account.Opened

{

 "nhận dạng": “259cdbca-6a89-4af8-a50e-ada3010fb13f”,

 “tên sự kiện”: “Tài khoản.Cốt lõi.Đã mở”,

 "trạng thái": "Chưa giải quyết",

 “ID đối tác”: “e6c3824a-377f-44d5-a2f6-a9a600c9b37e”,

 “createdAt”: “2021-01-26T09:48:10.1011462-05:00”,

 "tài nguyên": [

 “core/v1/dda/accounts/2235223803”

 ],

 "chi tiết": []

}

Fundanaccount

Khi bạn làm việc trong môi trường thử nghiệm để kiểm tra phương thức thanh toán và hành vi tài khoản, bạn cần phải có tiền trong tài khoản.

Bạn có thể sử dụng bất kỳ đường ray nào có điểm cuối mô phỏng đầu vào để cấp vốn cho tài khoản sandbox, nếu tài khoản được cấu hình cho điểm cuối này. Cụ thể, bạn có thể:

Mô phỏng thanh toán ACH đến

Mô phỏng một dây dẫn đến

Đối với bất kỳ mô phỏng nào, bạn cần số tài khoản sandbox Cross River mà bạn muốn tài trợ. Thông tin người khởi tạo không quan trọng, và trong một số trường hợp thậm chí có thể hoàn toàn là thông tin giả mạo.

Các bước tiếp theo

Kiểm tra thanh toán của chúng tôi.

hướng dẫn

3.3. Thẻ

Bước 1
Nhận thông tin xác thực API

Bước 2
Nhận mã thông báo truy cập

Bước 3
Sử dụng mã thông báo truy cập

Bước 4
Xây dựng một Sampứng dụng le

Tìm hiểu cách làm việc với Cross River API. Trang này hướng dẫn bạn cách:

Tạo một thẻ

Kích hoạt thẻ

Tạo thẻ

Quản lý thẻ của khách hàng bằng cách làm việc với Cross River để quyết định những gì bạn muốn cung cấp, chẳng hạn như thẻ vật lý hoặc thẻ ảo. Đây là cấu hình thẻ. Cross River tạo ra một cấu hình thẻ chuyên nghiệpfile cho bạn cho mỗi loại bạn chọn cho công cụ tài chính của mình khách hàng.

Trước khi bạn bắt đầu

Hãy đảm bảo bạn thực hiện và có:

Tạo hồ sơ khách hàng

Tạo tài khoản tiền gửi

Số tài khoản của chủ thẻ

ID khách hàng (bạn nhận được thông tin này khi tạo khách hàng)

ID cấu hình (Cross River cung cấp ID cho bạn khi bạn cấu hình loại/thẻ của mình)

Chúng tôi cũng khuyên bạn nên sử dụng các thông tin liên quan websự kiện móc. đăng ký

Điểm cuối vàwebmóc

Đăng ký vì webmóc. Các điểm cuối API sau đây được sử dụng:

Mô tả API

Tạo thẻ mới Yêu cầu tạo thẻ ghi nợ mới

Sau đây là webmóc được sử dụng:

WebMô tả móc

Thẻ.Thẻ.Đã tạo Thẻ ghi nợ đã được tạo

Orderacard

Bạn sẽ học cách đặt hàng/tạo thẻ ghi nợ mới bằng cách tạo thẻ cho John Smith.

1 Gọi POST /cardmanagement/v1/cards .

Trong ví dụ sauampBạn có thể xem những thuộc tính nào là bắt buộc. Xem chi tiết về API đầy đủ.

Thêm thẻ

Samptạo một thẻ

curl -X POST /cardmanagement/v1/cards –header 'Content-Type: applicatio “accountNumber”: “2608927303”, \  

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

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

 “họ”: “Smith”, \  

 "điện thoại": { \  

 “phoneType”: “Nhà riêng”, \  

 “Số điện thoại”: “9133413131” \  

 }, \  

 “emailAddress”: “John.Smith@xxxxx.com”, \  

 “Địa chỉ giao hàng”: { \  

 “street1”: “Lane Ave”, \  

 “street2”: “chuỗi”, \  

 “thành phố”: “Thị trấn lớn”, \  

 “tiểu bang”: “IL”, \  

 “Mã bưu chính”: “72410”, \  

 “countryCode”: “US” \  

 }, \  

 “billingAddress”: { \  

 “street1”: “Lane Ave”, \  

 “street2”: “chuỗi”, \  

 “thành phố”: “Thị trấn lớn”, \  

 “tiểu bang”: “IL”, \  

 “Mã bưu chính”: “72410”, \  

 “countryCode”: “US” \  

 }, \  

 “nameOnCard”: “John Smith”, \  

 “shippingType”: “Bình thường”, \  

 “clientIdentifier”: “chuỗi” \  

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

2 Một lệnh gọi API thành công sẽ trả về phản hồi JSON với thông tin chi tiết về thẻ mới. Trạng thái thẻ sẽ không được kích hoạt cho đến khi bạn kích hoạt thẻ. ID là ID của thẻ, trong trường hợp này example 8709163d-140c-4d95-a111-afa8009e9cd1, mà bạn sẽ cần phải kích hoạt thẻ.

Sampđặt hàng một thẻ phản hồi

{

 "nhận dạng": “8709163d-140c-4d95-a111-afa8009e9cd1”,  “ID đối tác”: “cd9c12f4-7691-424a-b38b-af5b0134c611”,  “productId”: “83bed086-8182-4151-a1e3-af5b01362783”,  “Số tài khoản”: “2608927303”,

 "trạng thái": “Chưa kích hoạt”,

 “Mã lý do trạng thái”: “Không được thiết lập”,

 “Tên”: “John”,

 "họ": “Thợ rèn”,

 “Địa chỉ giao hàng”: {

 “đường phố1”: “Đường Lane”,

 “đường phố2”: "sợi dây",

 "thành phố": “Thị trấn lớn”,

 "tình trạng": “IL”,

 “Mã bưu chính”: “72410”,

 “Mã quốc gia”: "CHÚNG TA"

 },

 “địa chỉ thanh toán”: {

 “đường phố1”: “Đường Lane”,

 “đường phố2”: "sợi dây",

 "thành phố": “Thị trấn lớn”,

 "tình trạng": “IL”,

 “Mã bưu chính”: “72410”,

 “Mã quốc gia”: "CHÚNG TA"

 },

 "điện thoại": {

 “Loại điện thoại”: "Trang chủ",

 “Số điện thoại”: “9133413131”

 },

 “Địa chỉ email”: “john@anygoogle.com”,

 “tên trên thẻ”: “John Smith”,

 “isPinSet”: SAI,

 “adminBlocked”: SAI,

 “nghi phạm gian lận”: SAI,

 “configurationId”: “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  "loại": "Tín dụng",

 “paymentInstrument”: “VirtualPan”,

 “bộ xử lý”: “tên bộ xử lý”,

 “Loại vận chuyển”: "Bình thường",

 “trạng thái đơn hàng”: “Đơn hàng đang chờ xử lý”,

 “trạng thái thay thế”: “Không áp dụng”,

 “customerId”: “2b15a695-13dc-4b10-b4e5-af5b0138873c”,  “clientIdentifier”: "sợi dây",

 “createdAt”: “2023-02-13T04:37:29.4869172-05:00”,

 “lastModifiedAt”: “2023-02-13T04:37:29.4869172-05:00”

}

3 Các Thẻ.Thẻ.đã.tạo webSự kiện hook được kích hoạt khi thẻ được tạo ra tại bộ xử lý.

Sampsự kiện le Cards.Card.Created

{

 "nhận dạng": “cea6c5b5-13e7-4c2f-ba75-afce01110fe5”,

 “tên sự kiện”: “Thẻ.Thẻ.Đã tạo”,

 "trạng thái": "Chưa giải quyết",

 “ID đối tác”: “cd9c12f4-7691-424a-b38b-af5b0134c611”,

 “createdAt”: “2023-02-13T04:42:29.4869172-05:00”,

 "tài nguyên": [

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

 "chi tiết": [

 {

 “ID thẻ”: “8709163d-140c-4d95-a111-afa8009e9cd1”,

 "trạng thái": “Chưa kích hoạt”,

 “Mã lý do trạng thái”: “Không được thiết lập”

 }

 ]

}

Kích hoạt thẻ

Trước khi bạn bắt đầu

Hãy đảm bảo bạn có:

Thông tin xác thực API

ID thẻ từ khi bạn đặt thẻ

Điểm cuối vàwebmóc

Mô tả API

POST /cardmanagement/v1/cards/{id}/activate Kích hoạt thẻ bằng ID thẻ Hướng dẫn sử dụng các webmóc:

WebMô tả móc

Thẻ.Thẻ.Đã.Kích.Thẻ Thẻ ghi nợ đã được kích hoạt

Kích hoạt thẻ

Kích hoạt thẻ bạn đã tạo trong stage.

tạo một thẻ

1 Gọi POST /cardmanagement/v1/cards/{id}/activate . Các id thuộc tính phải được đặt thành ID thẻ. Trong sampbên dưới ID là 8709163d-140c-4d95-a111 afa8009e9cd1.

Sampyêu cầu kích hoạt thẻ le

curl -X BƯU KIỆN  

–header 'Chấp nhận: application/json'

–header 'Ủy quyền: Người mang'<dấu hiệu>'

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

2 Một cuộc gọi API thành công sẽ trả về phản hồi JSON với thông tin chi tiết về thẻ. Thẻ trạng thái bây giờ là đã kích hoạt. Các Trạng thái đơn hàng is Hoàn thành.

Sampphản hồi thẻ kích hoạt le

{

 "nhận dạng": “8709163d-140c-4d95-a111-afa8009e9cd1”,  “ID đối tác”: “cd9c12f4-7691-424a-b38b-af5b0134c611”,  “productId”: “83bed086-8182-4151-a1e3-af5b01362783”,  “processorCardId”: “804951250206718”,

 “Số tài khoản”: “2608927303”,

 "trạng thái": "Tích cực",

 “Mã lý do trạng thái”: “Không được thiết lập”,

 “Tên”: “John”,

 "họ": “Thợ rèn”,

 “Địa chỉ giao hàng”: {

 “đường phố1”: “Đường Lane”,

 “đường phố2”: "sợi dây",

 "thành phố": “Thị trấn lớn”,

 "tình trạng": “IL”,

 “Mã bưu chính”: “72410”,

 “Mã quốc gia”: "CHÚNG TA"

 },

 “địa chỉ thanh toán”: {

 “đường phố1”: “Đường Lane”,

 “đường phố2”: "sợi dây",

 "thành phố": “Thị trấn lớn”,

 "tình trạng": “IL”,

 “Mã bưu chính”: “72410”,

 “Mã quốc gia”: "CHÚNG TA"

 },

 "điện thoại": {

 “Loại điện thoại”: "Trang chủ",

 “Số điện thoại”: “9133413131”

 },

 “Địa chỉ email”: “john@anygoogle.com”,

 “tên trên thẻ”: “John Smith”,

 “panLastFour”: “3629”,

 “isPinSet”: SAI,

 “ngày hết hạn”: “2026-02-13”,

 “adminBlocked”: SAI,

 “nghi phạm gian lận”: SAI,

 “configurationId”: “a6b5a94c-f8f9-462b-8ce8-afa400f5b640”,  "loại": "Tín dụng",

 “paymentInstrument”: “VirtualPan”,

 “bộ xử lý”: “tên bộ xử lý”,

 “Loại vận chuyển”: "Bình thường",

 “trạng thái đơn hàng”: "Hoàn thành",

 “trạng thái thay thế”: “Không áp dụng”,

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

 “clientIdentifier”: "sợi dây",

 “processorCustomerId”: “T83E9D675A3N3N9O8RZ1”,

 “createdAt”: “2023-02-13T04:37:29.487-05:00”,

 “Kích hoạt ban đầu”: “2023-02-13T00:00:00-05:00”,

 “activatedAt”: “2023-02-13T04:43:19.282287-05:00”,

 “lastModifiedAt”: “2023-02-13T04:43:19.2962845-05:00”

}

3 Khi trạng thái thẻ thay đổi thành Tích cực , các Thẻ.Thẻ.Đã.Kích.Thẻ websự kiện móc câu bắn ra.

Thẻ.Thẻ.Đã.Kích.Thẻ websự kiện móc

{

 "nhận dạng": “95ac33ca-3d7f-49aa-bfc2-afce01113310”,

 “tên sự kiện”: “Thẻ.Thẻ.Đã.Kích.Thẻ”,

 "trạng thái": "Chưa giải quyết",

 “ID đối tác”: “cd9c12f4-7691-424a-b38b-af5b0134c611”,

 “createdAt”: “2023-02-13T04:44:31.282287-05:00”,

 "tài nguyên": [

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

 "chi tiết": [

 {

 “ID thẻ”: “8709163d-140c-4d95-a111-afa8009e9cd1”,

 "trạng thái": "Tích cực",

 “Mã lý do trạng thái”: “Không được thiết lập”

3.4. Cho vay

Bước 1
Nhận thông tin xác thực API

Bước 2
Nhận mã thông báo truy cập

Bước 3
Sử dụng mã thông báo truy cập

Bước 4
Xây dựng một Sampứng dụng le

Cho vay bao gồm một tập hợp các lệnh gọi cho phép bạn tạo, cập nhật và quản lý API cho vay các khoản vay của bạn.

Để bắt đầu làm việc với hoạt động cho vay, hãy đảm bảo rằng bạn:

Nhận thông tin xác thực API với phạm vi cần thiết cho Cho vay

Nếu bạn đã tạo Thông tin xác thực API, sử dụng Quản lý tự phục vụ

, sau đó bạn cũng nên gửi yêu cầu đến

arix.support@crossriver.com

Tổ chức, cùng với clientid và MPLID của bạn, để hoàn thành sự sáng tạo.

Sử dụng phạm vi phù hợp cho các API bạn muốn sử dụng.

Phạm vi API cho hộp cát là: CosLending:PreApproval:stg

Hộp cát

Cơ sở mô-đun URL cho các cuộc gọi API Mô tả

Khoản vay nguồn gốc

Quyết định ứng dụng

https://arixapisandbox.crbnj. net	Căn cứ URL cho các cuộc gọi API khởi tạo khoản vay đến môi trường hộp cát Arix
https://lendingsandbox.crbco s.com/preapproval/v1	Căn cứ URL cho hộp cát của quyết định ứng dụng

Đi vênh vang

Mô-đun Swagger Link

Tài liệu tham khảo API tài liệu	https://arixapisandbox.crbnj.net/swagger-ui
Móc	https://lendingsandbox.crbcos.com/hooks/swagger/inde x.html

Bán https://lendingsandbox.crbcos.com/selling/swagger/inde x.html

Trang trạng thái

Để xem danh sách các bản phát hành sắp tới, hãy theo dõi trạng thái API hiện tại, view báo cáo sự cố hoặc nhận thông báo về bảo trì theo lịch trình, hãy truy cập trang trạng thái của chúng tôi và đăng ký nhận thông báo.

4. Thiết lập chương trình

Thiết lập SFTP: Sử dụng SFTP để gửi filehoặc tải chúng xuống từ Cross River, tùy theo nhu cầu của bạn và chúng tôi.

Khách hàng mới: Quản lý thông tin khách hàng của bạn tại Cross River hệ điều hành (COS) sử dụng API hoặc trình khám phá COS

Các loại sản phẩm và ID của COS: Giải thích về các loại sản phẩm và ID của COS.

Trình khám phá COS: Cách sử dụng COS Explorer của chúng tôi.

Cổng thông tin quản lý tổ chức: Cách làm việc với Cổng thông tin quản lý tổ chức của chúng tôi.

4.1. Thiết lập SFTP

Khi bạn cần trao đổi thông tin nhạy cảm trong một file định dạng với Cross River, chúng tôi yêu cầu bạn sử dụng Secure File Giao thức truyền tải (SFTP). Sử dụng SFTP để gửi filehoặc tải xuống từ Cross River, tùy theo nhu cầu của bạn và của chúng tôi. Trong một số trường hợp, bạn hoặc chúng tôi sẽ mã hóa những dữ liệu này files, đặc biệt nếu chúng chứa bất kỳ Thông tin nhận dạng cá nhân (PII) nào.

Sử dụng SFTP

SFTP cho phép bạn gửi và nhận thông tin nhạy cảm một cách an toàn filevà báo cáo bằng cách sử dụng một thư mục được chỉ định cụ thể cho doanh nghiệp của bạn trên một máy chủ an toàn. Tải lên và tải xuống files thông qua thư mục đó hoặc các thư mục con của thư mục đó, tùy theo nhu cầu cụ thể của bạn.

Sử dụng mã hóa

Mã hóa files bổ sung thêm một lớp bảo vệ. Chỉ những người được ủy quyền có khóa chính xác mới có thể giải mã dữ liệu đã mã hóa. file. Ở Cross River chúng tôi sử dụng mã hóa PGP.

Bắt đầu

Có một số bước để bạn có thể bắt đầu sử dụng máy chủ SFTP của chúng tôi.

1 Bạn hoàn thành biểu mẫu Yêu cầu truy cập IP cho Dịch vụ SFTP Cross River (từ RM của bạn).

Nếu bạn cần chia sẻ fileVới Cross River, Quản lý Quan hệ Khách hàng của bạn sẽ gửi cho bạn mẫu Yêu cầu Truy cập IP cho Dịch vụ SFTP CRB. Trong số các thông tin khác, bạn cần cung cấp địa chỉ IP công cộng tĩnh mà bạn sẽ sử dụng để truy cập thư mục SFTP và khóa công khai PGP để mã hóa và giải mã. files. Gửi lại mẫu đã hoàn thành cho Quản lý quan hệ của bạn

QUAN TRỌNG

Cross River sẽ chỉ cho phép 5 địa chỉ IP của bạn, vì vậy hãy lưu ý điều này. Các địa chỉ IP phải là địa chỉ tĩnh. Do đó, bạn cần proxy bất kỳ địa chỉ nào không tĩnh về phía bạn.

2 Chúng tôi thiết lập cấu trúc thư mục SFTP của bạn.

Sau khi Cross River có thông tin chi tiết của bạn, bộ phận kỹ thuật CNTT của chúng tôi sẽ tạo một bộ thư mục và thư mục con tiêu chuẩn cho bạn. Đường dẫn duy nhất này chỉ dành riêng cho doanh nghiệp của bạn. Không đối tác nào khác có thể truy cập vào đường dẫn này. Bộ phận kỹ thuật CNTT sẽ gửi cho bạn một email chứa thông tin cần thiết để truy cập các thư mục. Email này bao gồm một liên kết đến thông tin đăng nhập của bạn. Cross River không lưu mật khẩu của bạn!

QUAN TRỌNG

Liên kết này chỉ có hiệu lực trong vài ngày, sau đó bạn sẽ cần yêu cầu đặt lại mật khẩu nếu không sử dụng.

Thông tin đăng nhập cũng trở nên không hợp lệ nếu có nhiều hơn hai người truy cập vào liên kết.

3 Kiểm tra tải lên SFTP.

Nếu bạn sẽ cung cấp fileĐối với Cross River, bộ phận CNTT của bạn nên thiết lập một tài khoản dịch vụ với quy trình tự động để tải lên những files vào thư mục SFTP của bạn. Chúng tôi thực sự khuyên bạn nên kiểm tra điều này trước khi thử gửi dữ liệu thực. Hãy liên hệ với quản lý quan hệ khách hàng của bạn nếu có bất kỳ câu hỏi hoặc vấn đề nào, hoặc mở một phiếu yêu cầu hỗ trợ trực tiếp.

4 Thiết lập PGP để gửi hoặc nhận files từ Cross River. (Bước này chỉ cần thiết nếu bạn đang gửi hoặc nhận PII. Vui lòng kiểm tra với RM của bạn.)

Nếu bạn cần gửi Cross River files, trước tiên chúng tôi sẽ gửi cho bạn khóa công khai PGP của chúng tôi để sử dụng trong việc mã hóa những files.

Bạn nên đã gửi cho Cross River khóa công khai PGP của bạn để nhận filetừ chúng tôi.

5 Chia sẻ dữ liệu của bạn.

Sau khi thư mục SFTP của bạn được thiết lập và quy trình của bạn đã sẵn sàng, bạn có thể bắt đầu chia sẻ filevới chúng tôi. Người quản lý quan hệ khách hàng sẽ cho bạn biết nếu có điều gì cụ thể hơn bạn cần làm để nhận báo cáo hoặc cách chuẩn bị dữ liệu để gửi cho chúng tôi.

Báo cáo cụ thể

Tìm hiểu thêm về việc chuẩn bị và gửi báo cáo và files cho:

Tài khoản và thanh toán

Thanh toán bằng thẻ

Rủi ro tín dụng

Cho vay

Thanh toán hàng loạt XML (ISO 20022)

4.2. Khách hàng mới

Quản lý thông tin khách hàng của bạn trong hệ điều hành Cross River (COS) bằng API hoặc . Thông tin này bao gồm các chi tiết cơ bản cần thiết để mở tài khoản ngân hàng COS Explorer.

tài khoản hoặc sử dụng thẻ tín dụng, cũng như dữ liệu cụ thể hơn về khách hàng, nếu cần. Chúng tôi gọi đây là hồ sơ khách hàng.

Trước khi bạn có thể mở tài khoản tiền gửi hoặc tạo thẻ, bạn phải tạo hồ sơ khách hàng, đôi khi được gọi là lên tàu. Sau đó, bạn có thể chỉ định một hoặc nhiều khách hàng cho một tài khoản thông qua khách hàng mối quan hệ.

Quy trình tiếp nhận khách hàng bao gồm việc tạo hồ sơ khách hàng có liên quan thông tin khách hàng. Thực hiện theo hướng dẫn này để mỗi bạn tạo một hồ sơ khách hàng.

Các bước tùy chọn

Thêm thông tin chi tiết ID

Thêm chủ sở hữu có lợi

Mã lỗi

Xem , cùng với nhiều thông tin tham khảo khác, về mã lỗi hệ thống COS COS

trang mã tham chiếu.

4.2.1. Hồ sơ khách hàng

Hồ sơ khách hàng

Hồ sơ khách hàng là tài nguyên chính chứa thông tin khách hàng trong hệ thống Cross River. Do đó, trước khi tạo tài khoản cho khách hàng, bạn phải đăng ký khách hàng đó. Hồ sơ khách hàng hỗ trợ phân loại thành Cá nhân hoặc Doanh nghiệp. Sau khi đăng ký, bạn có thể liên kết một khách hàng với một hoặc nhiều tài khoản.

Người cũampbên dưới hướng dẫn cách đưa khách hàng lên tàu đối với khách hàng cá nhân.

Yêu cầu của người trên tàu

POST /core/v1/cm/customers {

 “ID đối tác”: “7cc038be-fde9-4455-b27b-1497cf667362”,

 "tên": {

 “tiền tố”: "Ông.",

 “Tên”: “John”,

 “Tên đệm”: “Robert”,

 "họ": “Thợ rèn”,

 “hậu tố”: “Jr.”,

 “tên ưa thích”: “Jim” },

 “phân loại”: "Riêng tư",

 “Chuyên nghiệpfile": {

 “regO”: SAI,

 “citizenshipCountryCode”: "CHÚNG TA",

 “politicallyExposedPerson”: SAI,

 “bật BackupWithholding”: SAI,

 “backupWithholdingPercent”: 0,

 “taxIdType”: “Ssn”,

 “mã số thuế”: “123456789”,

 “Ngày sinh”: “1965-09-15”,

 “Rủi ro Xếp hạng”: "Thấp",

 “privacyOptOut”: ĐÚNG VẬY }

} Đưa khách hàng doanh nghiệp lên tàu như công ty hoặc LLC bằng cùng một điểm cuối với các thuộc tính hơi khác nhau.

Curl

POST /core/v1/cm/customers {

 “ID đối tác”: “a24cba49-2bb6-431d-a867-1de81d6e4127”,

 "tên": {

 “tên thực thể”: “Công ty ACME”, },

 “phân loại”: "Việc kinh doanh",

 “Chuyên nghiệpfile": {

 “citizenshipCountryCode”: "CHÚNG TA",  

 “bật BackupWithholding”: SAI,

 “backupWithholdingPercent”: 0,  

 “taxIdType”: “Một”,

 “mã số thuế”: “123456789”,

 “ngày tháng được hình thành”: “2019-09-10”,

 “entityType”: "Tập đoàn",

 “Rủi ro Xếp hạng”: "Thấp",

 “ownershipType”: “Thực thể pháp lý”,

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

Bất kể bạn đang tiếp nhận khách hàng cá nhân hay doanh nghiệp, Chủ sở hữu chính CustomerId Thuộc tính phải chứa ID khách hàng tham chiếu đến hồ sơ khách hàng loại Cá nhân. Vì vậy, để tích hợp một doanh nghiệp, trước tiên bạn phải tạo hồ sơ khách hàng cá nhân cho chủ sở hữu chính của doanh nghiệp đó.

QUAN TRỌNG

Một số điểm cuối của khách hàng bao gồm thẩm định Tài nguyên có thể cần hoặc không cần khi tiếp nhận khách hàng cá nhân. Nhân viên liên lạc tuân thủ được chỉ định của bạn sẽ truyền đạt các yêu cầu cho bất kỳ trường Thẩm định nào trong quá trình tiếp nhận khách hàng.

Chủ sở hữu có lợi

Chủ sở hữu thực thụ là người sở hữu 25% hoặc hơn một doanh nghiệp. Vì lý do pháp lý, bạn cần phải có nguồn lực trong Việc kinh doanh hồ sơ khách hàng tạo ra một chủ sở hữu có lợi

cho mỗi chủ sở hữu có lợi của doanh nghiệp đó. chủ sở hữuCustomerId Thuộc tính này tham chiếu đến hồ sơ khách hàng cá nhân của mỗi chủ sở hữu thực thụ. Bạn thường thêm tài nguyên chủ sở hữu thực thụ vào hồ sơ khách hàng doanh nghiệp ngay sau khi doanh nghiệp được đưa vào hoạt động.

Curl

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

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

 “ownerTitle”: "Chủ tịch" }

Địa chỉ

Địa chỉ vật lý liên quan đến khách hàng có thể là .

đã cập nhật

Curl

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

{

 “isPrimary”: ĐÚNG VẬY,

 "trạng thái": "Tích cực",

 “phân loại”: “Khu dân cư”,

 “Loại địa chỉ”: "Trang chủ",

 “đường phố1”: “123 Phố Maple”,

 “đường phố2”: “Căn hộ số 12”,

 “đường phố3”: “”,

 "thành phố": “New York”,

 "tình trạng": “NY”,

 “Mã bưu chính”: “10025”,

 “Mã quốc gia”: "CHÚNG TA",

}

Địa chỉ email

Cập nhật email

thông tin liên lạc của khách hàng.

Curl

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

 “isPrimary”: ĐÚNG VẬY,

 “Loại email”: "Riêng tư",

 “Địa chỉ email”: “john.smith@crossriver.com” }

Điện thoại

Cập nhật điện thoại Curl

thông tin liên lạc của khách hàng.

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

{

 “Loại điện thoại”: "Trang chủ",

 “isPrimary”: ĐÚNG VẬY,

 “Số điện thoại”: “2015551234”

}

Nhận dạng

Mã định danh được sử dụng để theo dõi siêu dữ liệu cho các tài liệu nhận dạng khách hàng như giấy phép lái xe và hộ chiếu. Có thể được sử dụng để thêm thông tin chi tiết về ID mới. Thêm thông tin chi tiết về ID

Curl

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

 “isPrimary”: ĐÚNG VẬY,

 “Số ID”: “DL123456789”,

 “Loại id”: “Giấy phép lái xe”,

 “ngày phát hành”: “2018-08-30”,

 “ngày hết hạn”: “2018-08-30”,

 “ngày xác minh”: “2018-08-30”,

 “Cơ quan cấp phép”: “DMV NJ”,

 “issuingStateOrProvince”: “NJ”,

 “mã quốc gia đang phát hành”: "CHÚNG TA",

}

4.2.2. Các loại sản phẩm COS và ID

Ở Cross River, một loại sản phẩm là một sản phẩm tài chính được cấu hình độc đáo mà bạn cung cấp cho khách hàng của mình. Ví dụ:ampLoại sản phẩm có thể là thẻ ghi nợ hoặc tài khoản tiết kiệm, được cấu hình theo nhu cầu và thông số kỹ thuật của bạn. Bạn mở tài khoản cho khách hàng theo bất kỳ loại sản phẩm nào bạn xác định và cấu hình cùng với chúng tôi. Vui lòng liên hệ với quản lý quan hệ khách hàng của bạn để biết thêm chi tiết, bao gồm cả cách thiết lập loại sản phẩm cho khách hàng.

Ví dụampVí dụ, bạn có thể muốn cấu hình một loại sản phẩm thành sản phẩm tài khoản tiết kiệm sử dụng thanh toán qua Chuyển khoản và ACH. Sau đó, bạn có thể cung cấp cho khách hàng tài khoản tiết kiệm với các dịch vụ và cấu hình này.

Cross River cung cấp cho bạn một mã sản phẩm cho mỗi loại sản phẩm bạn muốn cung cấp cho khách hàng. Để mở bất kỳ loại tài khoản tiền gửi nào, bạn phải có mã sản phẩm hợp lệ và mã khách hàng (mã hồ sơ khách hàng đã được tích hợp) của chủ tài khoản. Lưu ý rằng chủ tài khoản phải có ít nhất một địa chỉ và số điện thoại trong hồ sơ khách hàng, và tình trạng OFAC của họ phải là Thông thoáng. Ngoài ra, phân loại khách hàng phải khớp với phân loại đã cấu hình cho sản phẩm. Ví dụ:ample, chỉ có khách hàng doanh nghiệp mới có thể được thêm vào sản phẩm doanh nghiệp.

4.2.3. Nhà thám hiểm COS

Khi bạn đã vào hệ thống Cross River và nhận được email thông báo đã được tích hợp

của bạn ID khách hàng Và Bí mật bạn đã sẵn sàng để đăng nhập vào COS Explorer. Truy cập cổng thông tin COSExplorer

Sản xuất:

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

Hộp cát:

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

Email chào mừng

Bạn sẽ nhận được email chào mừng từ CrossRiver_KHÔNG_TRẢ_LỜI@crossriver.com. Nếu bạn không thấy thư trong hộp thư đến, hãy kiểm tra thư mục thư rác hoặc thư bị chặn.

Nhấp chuột Tạo tài khoản Cross River của bạn.

Nếu bạn thoát khỏi trình hướng dẫn bất cứ lúc nào, hãy nhấp vào liên kết trong email gốc để quay lại nơi bạn đã dừng lại.

Điều khoản và điều kiện

Đọc kỹ các điều khoản và điều kiện, kiểm tra Chấp nhậnvà nhấp vào Kế tiếp.

Xác minh tin nhắn SMS

Chúng tôi sẽ gửi cho bạn một tin nhắn SMS (tin nhắn văn bản) đến thiết bị của bạn để xác minh danh tính. Nhập mã 6 chữ số bạn nhận được trên màn hình đăng nhập và nhấp vào Xác minh mã.

Tạo mật khẩu của bạn

1. Nhập mật khẩu đáp ứng các yêu cầu trên màn hình và nhập lại mật khẩu. 

2. Nhấp chuột Tạo mật khẩu.

Thiết lập ứng dụng xác thực

Bạn phải hoàn tất bước này để tiếp tục quá trình đăng ký và có thể đăng nhập trong tương lai

Để bảo vệ danh tính, tài khoản và thông tin của bạn, chúng tôi yêu cầu bạn đăng nhập bằng xác thực đa yếu tố/2 yếu tố.

Nếu bạn chưa có ứng dụng xác thực trên thiết bị, bạn cần tải xuống ứng dụng trước khi tiếp tục.

Đối với Android và iOS, chúng tôi khuyên bạn nên sử dụng ứng dụng xác thực sau:

Trình xác thực của Google

Trình xác thực Microsoft

Sau khi cài đặt ứng dụng xác thực, bạn cần phải quét mã QR or nhập thủ công khóa vào ứng dụng xác thực.

Mã QR

1. Quét mã QR trong ứng dụng xác thực của bạn và nếu cần, hãy nhập mã 6 chữ số vào trang Xác thực đa yếu tố.

2. Nhấp vào tiếp tục.

Thủ công

1. Nhấp chuột Hiển thị chìa khóa

2. Sao chép khóa như Bí mật trong ứng dụng xác thực của bạn.

3. Nhập mã gồm 6 chữ số.

4. Nhấp chuột Tiếp tục.

Mã MFA không hợp lệ

Nếu bạn nhập mã MFA không hợp lệ, một thông báo màu đỏ sẽ nhắc bạn thử lại.

Rất tiếc! Bạn đã nhập mã MFA không hợp lệ. Dưới đây là một số điều cần kiểm tra lại:

1. Mã có hết thời gian chờ trước khi bạn nhấp không? Tiếp tục? Thời gian còn lại được biểu thị bằng vòng tròn đếm ngược bên phải tên tài khoản và mã MFA.

2. Nếu bạn đã thiết lập ứng dụng xác thực cho nhiều môi trường hoặc ứng dụng, hãy kiểm tra lại xem bạn đã nhập đúng mã chưa.

1. Nếu không rõ tên kết nối MFA là tùy chọn nào đúng, bạn có thể cần thử nhiều mã khác nhau cho đến khi tìm được mã phù hợp.

2. Sau khi tìm thấy kết nối chính xác, bạn có thể đổi tên kết nối MFA trong ứng dụng. Biểu tượng bút chì ở đầu màn hình ứng dụng MFA sẽ đưa bạn đến chế độ chỉnh sửa. Trong một số ứng dụng, trước tiên bạn cần chọn (hoặc nhấn và giữ) kết nối cần chỉnh sửa, sau đó biểu tượng sẽ xuất hiện.

3. Khi ở chế độ chỉnh sửa, bạn có thể đổi tên các kết nối theo nhu cầu để có thể biết rõ kết nối nào áp dụng cho môi trường nào.

4. Lưu lại mọi thay đổi, lần sau bạn sẽ dễ dàng hiểu được nên sử dụng mã nào.

Mã phục hồi

Sử dụng mã khôi phục để xác thực trong trường hợp bạn làm mất thiết bị.

1. Tải xuống hoặc sao chép mã khôi phục và lưu chúng ở nơi an toàn mà bạn có thể nhớ được.

2. Xác nhận rằng bạn đã lưu trữ mã khôi phục của mình

3. Nhấp chuột Tạo tài khoản.

Trang mã khôi phục sẽ hết hạn sau 10 phút.

Bạn chỉ có thể tải xuống mã phục hồi một lần.

Tài khoản của bạn hiện đã hoạt động và bạn có thể sử dụng nó để đăng nhập vào bất kỳ ứng dụng CR nào của mình.

IP cho phép liệt kê

Chỉ có thể sử dụng IP tĩnh để truy cập COS Explorer. Vui lòng liên hệ với bộ phận Hỗ trợ IP nếu bạn cần trợ giúp.

Địa chỉ IP của Máy chủ nhận dạng là:

172.67.26.222 104.22.40.134 104.22.41.134

Máy chủ được ủy quyền thông qua Cloudflare.

Bạn có thể cho phép các FQDN sau:

idptest.crbcos.com

Xử lý sự cố

Quên mật khẩu

1. Nhấp chuột Quên mật khẩu? và nhập email của bạn.

2. Nhập mã xác thực gồm 6 chữ số từ ứng dụng xác thực của bạn. 3. Bạn nhận được một Quên mật khẩu email. Nhấp vào Đặt lại mật khẩu.

4. Trong trang Đặt lại mật khẩu, nhập mật khẩu mới, nhấp vào Đặt lại mật khẩu, Và Tiếp tục ứng dụng.

Đặt lại xác thực đa yếu tố

Nếu bạn đã cấu hình MFA:

1. Trong Identity Server, hãy đi tới Đặt lại MFA và nhấp vào Đặt lại thiết bị MFA của bạn. 2. Trang Xác thực đa yếu tố sẽ mở ra và bạn có thể đặt lại MFA của mình.

Bạn cũng có thể tạo mã khôi phục xác thực đa yếu tố mới.

1. Nhấp chuột tạo mã khôi phục xác thực đa yếu tố mới.

2. Trang Mã khôi phục sẽ mở ra và bạn có thể sao chép hoặc tải xuống 10 mã khôi phục mới của mình.

Nếu bạn chưa cấu hình xác thực đa yếu tố, bạn có thể bật MFA từ Cài đặt tài khoản.

1. Nhấp chuột Đặt lại phương pháp MFA.

2. Nhấp chuột Cấu hình MFA.

3. Làm theo hướng dẫn trong Xác thực đa yếu tố/Xác thực 2 bước.

Nếu MFA hiện tại của bạn là SMS, bạn có thể bật MFA bằng ứng dụng xác thực của mình. Trong Cài đặt tài khoản

1. Nhấp chuột Đặt lại phương pháp MFA.

2. Nhấp chuột Cấu hình MFA.

3. Làm theo hướng dẫn trong Xác thực đa yếu tố/Xác thực 2 bước.

Sử dụng mã khôi phục

Nếu bạn không có quyền truy cập vào trình xác thực đa yếu tố (2 yếu tố), bạn có thể đăng nhập bằng một trong các mã khôi phục của mình.

1. Đăng nhập như bình thường

2. Trên trang Xác thực đa yếu tố, bạn có tùy chọn sử dụng mã khôi phục làm tùy chọn xác thực.

3. Nhập một trong các mã khôi phục của bạn vào hộp văn bản. Mã khôi phục chỉ sử dụng một lần và không thể tái sử dụng. Để tránh nhầm lẫn trong tương lai, chúng tôi khuyên bạn nên đánh dấu mã khôi phục là đã sử dụng.

Khóa tài khoản

Nếu bạn nhập sai mật khẩu tên người dùng 5 lần, hệ thống sẽ khóa tài khoản của bạn trong khoảng 5 phút. Nếu sau 5 phút mà bạn vẫn không thể truy cập tài khoản, hãy liên hệ với bộ phận Hỗ trợ Cross River.

Lỗi trình duyệt - Tường lửa

Bạn đăng nhập vào COS Explorer và nhận được màn hình lỗi sau:

Bạn bị tường lửa chặn.

1. Liên hệ với bộ phận CNTT nội bộ để xem tổ chức của bạn có áp dụng quy tắc tường lửa cho lưu lượng truy cập ra ngoài hay không. Nếu không có quy tắc tường lửa nào cho lưu lượng truy cập ra ngoài, thì:

2. Liên hệ với bộ phận CNTT nội bộ của bạn để đảm bảo bạn đang kết nối với Cổng thông tin Cross River COS Explorer từ một địa chỉ IP được phê duyệt. Nếu bạn cần đăng ký thêm địa chỉ IP, hãy gửi email đến bộ phận hỗ trợ của COS.

4.2.3.1. Quản lý người dùng

Quản lý người dùng

Bạn có thể sử dụng Người sử dụng màn hình của Quản trị viên Tab để nhóm một tập hợp các tài nguyên, chẳng hạn như khách hàng, sản phẩm và tài khoản. Một khi tài nguyên (tức là sản phẩm hoặc khách hàng) đã được gán cho bạn, nó sẽ không thể thay đổi được nữa.

Bạn có thể sử dụng khu vực này để hỗ trợ và thực hiện thay đổi cho khách hàng. Chúng tôi có thể thiết lập cho bạn 2 người dùng quản trị để bạn có thể tạo người dùng theo yêu cầu cho khách hàng. Điều này giúp bạn độc lập quản lý khách hàng và cho phép bạn thực hiện thay đổi ngoài giờ làm việc theo yêu cầu của họ.

Bạn cũng có thể tạo hoặc đưa người dùng mới vào sử dụng.

Tạo người dùng mới

1 Trong Quản trị viên tab, nhấp chuột Người sử dụng để mở Người sử dụng màn hình tìm kiếm. 2 Nhấp chuột + Người dùng mới. Các Tạo người dùng màn hình hiển thị.

3 In Tạo người dùng nhập thông tin của người dùng E-mail, các trường sau đó sẽ hiển thị Tên đầu tiên, Họ Và Số điện thoại.

4 Nhấp chuột Trạng thái và chọn Tích cực.

Các Số điện thoại trường này phải là số điện thoại di động vì số này sẽ được MFA sử dụng để xác thực người dùng.

Mô tả trường

Tên	Tên người dùng. Nhập tên người dùng đầy đủ để hiển thị trong cửa sổ trình duyệt khi người dùng đăng nhập vào Explorer.
E-mail	Địa chỉ email của người dùng. Địa chỉ này được sử dụng để đăng nhập vào Explorer và cũng dùng làm email khôi phục để đặt lại mật khẩu.
Trạng thái	Chọn trạng thái người dùng. Trạng thái người dùng là Không hoạt động theo mặc định. Thay đổi nó thành Tích cực khi tạo người dùng.
Loại người dùng	Trường này hiển thị Cộng sự khi người dùng được tạo.
Vai trò	Chọn các vai trò để thêm vào người dùng hoặc nhấp vào Bao gồm tất cả các vai trò để thêm tất cả các vai trò có sẵn cho người dùng. Ghi chú: Chỉ những vai trò được chỉ định cho bạn mới hiển thị. Một số vai trò có chứa các quyền cho phép bạn tạo thanh toán trong Explorer. Quản trị viên Explorer của bạn có trách nhiệm đảm bảo rằng người dùng được cấu hình đúng với các vai trò người dùng phù hợp cũng như các giới hạn được ủy quyền.

Giới hạn được phép

Đối với mỗi trường, hãy chọn giới hạn đô la (nếu có)

5 Nhấp chuột Trạng thái và chọn Tích cực.

6 Nhấp chuột Vai trò và chọn người dùng bạn muốn chỉ định. Nhấp vào Cứu vai trò Thay đổi.

Tất cả người dùng phải được cấu hình với Chỉ sẵn sàng cho lõi đối tác vai trò.

Nếu người dùng được chỉ định Nguồn gốc dây đối tác vai trò bạn phải cấu hình giới hạn nguồn gốc của người dùng đó.

7 Nếu bạn đang chỉ định người dùng Nguồn gốc dây đối tác vai trò, nhập một giá trị vào Wire.Payments.Originate trường này để chỉ ra giới hạn đô la tối đa cho mỗi lần chuyển khoản. Nếu không, bạn có thể bỏ qua trường này.

8 Khi bạn hoàn tất việc cấu hình tất cả các trường. Nhấp vào Lưu thay đổi.

9 Nếu bạn đã tạo thành công người dùng mới, màn hình xác nhận sẽ hiển thị. 

10 Để hoàn tất việc thêm và cấu hình người dùng, một quản trị viên khác phải Phê duyệt thay đổi.

11 Các Phê duyệt các thay đổi đang chờ xử lý màn hình hiển thị. Nhấp vào Xác nhận. 

12 Viewthông tin người dùng