Hướng dẫn bắt đầu với neoConnect: Cẩm nang thiết lập toàn diện

neoConnect là nền tảng hạ tầng thanh toán thống nhất của chúng tôi, giúp đơn giản hóa việc xử lý thanh toán cho các doanh nghiệp ở mọi quy mô. Hướng dẫn này sẽ giúp bạn thiết lập neoConnect từ đầu.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo bạn có:

• Tài khoản neoBrillia đang hoạt động
• Thông tin định danh API từ bảng điều khiển của bạn
• Kiến thức cơ bản về REST API
• Môi trường phát triển đã sẵn sàng

Bước 1: Tạo tài khoản

Đầu tiên, hãy đăng ký tài khoản neoBrillia và điều hướng đến phần neoConnect trong trang quản trị. Bạn sẽ nhận được các khóa API ngay sau khi tạo tài khoản.

Bước 2: Cài đặt SDK

Cài đặt neoConnect SDK cho ngôn ngữ lập trình bạn ưu tiên:

npm install @neobrillia/neoconnect-sdk

Bước 3: Cấu hình môi trường

Thiết lập biến môi trường với các khóa API của bạn:

NEO_CONNECT_API_KEY=your_api_key_here
NEO_CONNECT_SECRET_KEY=your_secret_key_here
NEO_CONNECT_ENVIRONMENT=sandbox

Bước 4: Khởi tạo Client

Khởi tạo neoConnect client trong ứng dụng của bạn:

import { NeoConnect } from '@neobrillia/neoconnect-sdk';

const client = new NeoConnect({
  apiKey: process.env.NEO_CONNECT_API_KEY,
  secretKey: process.env.NEO_CONNECT_SECRET_KEY,
  environment: process.env.NEO_CONNECT_ENVIRONMENT,
});

Bước 5: Xử lý giao dịch đầu tiên

Tạo yêu cầu thanh toán và xử lý một giao dịch thử nghiệm:

const payment = await client.payments.create({
  amount: 1000,
  currency: 'USD',
  description: 'Thanh toán thử nghiệm',
});

Bước 6: Kiểm thử tích hợp

Sử dụng chế độ thử nghiệm (test mode) của neoConnect để xác nhận tích hợp hoạt động chính xác trước khi ra mắt thực tế. Kiểm tra các tình huống khác nhau bao gồm thanh toán thành công, thất bại và hoàn tiền.

Các bước tiếp theo

Sau khi tích hợp đã được kiểm thử, bạn có thể:

• Cấu hình webhook để nhận thông báo theo thời gian thực
• Thiết lập nhiều cổng thanh toán để dự phòng
• Kích hoạt định tuyến thông minh để tối ưu tỷ lệ thành công
• Chuyển sang chế độ chạy thực tế (production mode)

Để tìm hiểu các tính năng nâng cao hơn, hãy xem tài liệu API hoặc liên hệ với đội ngũ hỗ trợ của chúng tôi.