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-sdkBướ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=sandboxBướ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.