Tích hợp hệ thống với SoNo

Mục đích

SoNo cung cấp các API cho phép hệ thống bên ngoài tích hợp để thực hiện đồng bộ và đối soát giao dịch tự động. Các đối tác bên thứ ba có thể khai thác và lưu trữ dữ liệu vào SoNo thông qua API, đảm bảo khả năng mở rộng và tích hợp dễ dàng.

Nguyên tắc hoạt động

• Việc truy cập và tương tác với dữ liệu được thực hiện thông qua API do SoNo cung cấp.
• Dữ liệu chỉ có thể tác động trong phạm vi workspaceId của người dùng, không ảnh hưởng đến tài khoản hoặc dữ liệu của người dùng khác trong hệ thống.
• API hỗ trợ đồng bộ giao dịch tự động, giúp cập nhật trạng thái giao dịch một cách chính xác.
• Tất cả API đều yêu cầu xác thực bằng app-id và api-key để đảm bảo tính bảo mật.

Các tính năng chính

• Đối soát giao dịch tự động: Hỗ trợ xác minh và cập nhật trạng thái giao dịch một cách chính xác.

Danh sách API

Hiện tại, SoNo cung cấp API cho đồng bộ giao dịch. Bạn có thể tham khảo chi tiết tại:

• API đồng bộ giao dịch

Xác thực API

Mọi yêu cầu gửi đến API của SoNo đều phải được xác thực bằng app-id và api-key.

Cách sử dụng app-id và api-key:

1. app-id và api-key được cung cấp khi đăng ký tích hợp.
2. Khi gửi request, api-key cần được đặt trong phần headers của HTTP request.
3. api-key được sử dụng để tạo chữ ký bảo mật cho từng request.

Ví dụ HTTP request với api-key:

GET /api/v1/transactions HTTP/1.1
Host: api.vietsono.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Ví dụ tích hợp API

Dưới đây là một ví dụ về cách gửi dữ liệu giao dịch đến SoNo bằng cURL:

curl --location 'https://api.vietsono.com/webhook/sepay-incoming-transaction?app-id=****' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'Authorization: Apikey ****' \
--data '{
    "gateway": "MBBank",
    "transactionDate": "2024-12-31 22:20:17",
    "accountNumber": "************",
    "subAccount": null,
    "code": null,
    "content": "TEST",
    "transferType": "in",
    "description": "TEST",
    "transferAmount": 100000,
    "referenceCode": "FT24366249040796",
    "accumulated": 0,
    "id": 769
}'

Hướng dẫn sử dụng API

Để bắt đầu tích hợp, vui lòng tham khảo tài liệu API chi tiết tại: Trang API.

Nếu bạn có bất kỳ câu hỏi nào liên quan đến tích hợp hệ thống, vui lòng liên hệ với đội ngũ hỗ trợ SoNo qua email: support@vietsono.com.