> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# 6MM Agent SDK

> Sử dụng 6MM Agent SDK để thực hiện lệnh gọi API có chữ ký từ backend Java và PHP, liên kết người dùng, chuyển tài sản, tạo URL truy cập giao dịch, bảo đảm tính lũy đẳng và xác minh webhook.

6MM Agent SDK này dành cho các dịch vụ backend đối tác cần gọi API Agent đặc quyền mà không cần triển khai ký và xử lý yêu cầu từ đầu. Nó không được chạy trên trình duyệt, di động hoặc mã máy tính công cộng vì tích hợp sử dụng bí mật API đối tác.

<h2 id="when-to-use-the-agent-sdk">
  Khi nào nên sử dụng Agent SDK
</h2>

Sử dụng Agent SDK khi backend cần liên kết người dùng đối tác, chuyển tài sản qua quy trình đã được phê duyệt, truy vấn lịch sử giao dịch, tạo URL truy cập giao dịch nhúng hoặc xác minh thông báo Webhook. Sử dụng [Trading Widget SDK](/vi/sdk/trading-widget/overview) riêng khi frontend đối tác cần hiển thị giao diện giao dịch.

<h2 id="capabilities">
  Khả năng
</h2>

| Kịch bản                | Java SDK    | PHP SDK     |
| ----------------------- | ----------- | ----------- |
| Liên kết người dùng     | Được hỗ trợ | Được hỗ trợ |
| Chuyển khoản cố định    | Được hỗ trợ | Được hỗ trợ |
| Chuyển toàn bộ ra ngoài | Được hỗ trợ | Được hỗ trợ |
| Chuyển ngược            | Được hỗ trợ | Được hỗ trợ |
| Lệnh truy vấn           | Được hỗ trợ | Được hỗ trợ |
| Tạo URL nhập            | Được hỗ trợ | Được hỗ trợ |
| Xác minh Webhook        | Được hỗ trợ | Được hỗ trợ |

<h2 id="common-configuration">
  Cấu hình chung
</h2>

| Chìa khóa       | Ví dụ                                                                              | Mô tả                                               |
| --------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------- |
| baseUrl         | `https://agent-api.6mm.com`                                                        | 6MM Agent API dịch vụ URL không có dấu gạch chéo.   |
| agentCode       | AGENT001                                                                           | Mã agent đối tác.                                   |
| apiSecret       | your-api-secret                                                                    | API bí mật ký chỉ được lưu trên backend.            |
| defaultCurrency | USDT                                                                               | Tiền tệ mặc định cho chuyển khoản và API tài khoản. |
| webhookUrl      | [https://partner.example.com/6mm/webhook](https://partner.example.com/6mm/webhook) | Điểm cuối đối tác cho 6MM thông báo webhook.        |

<h2 id="typical-integration-flow">
  Quy trình tích hợp điển hình
</h2>

1. Giao diện đối tác xác thực người dùng thông qua hệ thống tài khoản riêng của đối tác.
2. Backend đối tác ánh xạ người dùng với định danh ổn định phía đối tác.
3. Backend gọi Agent SDK với `agentCode` và bảo vệ API bí mật.
4. SDK ký và gửi yêu cầu API cho Đại lý.
5. Backend lưu trữ định danh doanh nghiệp trả về và xử lý các webhook sau đó một cách đồng nhất.
6. Frontend chỉ nhận được kết quả ngắn hạn hoặc xác nhận nhập khẩu mà nó cần.

<h2 id="choose-an-sdk">
  Chọn một SDK
</h2>

| Ngăn xếp backend | Bắt đầu từ đây                                                                                                     |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| Java             | [Tổng quan Java SDK](/vi/sdk/agent-sdk/java/overview) và [Java Khởi Đầu Nhanh](/vi/sdk/agent-sdk/java/quick-start) |
| PHP              | [Tổng quan PHP SDK](/vi/sdk/agent-sdk/php/overview) và [PHP Khởi Đầu Nhanh](/vi/sdk/agent-sdk/php/quick-start)     |

<h2 id="production-checklist">
  Danh sách kiểm tra sản xuất
</h2>

* Tải `apiSecret` từ trình quản lý bí mật backend, không phải mã nguồn.
* Giữ chứng chỉ phát triển, dàn dựng và sản xuất riêng biệt.
* Sử dụng ánh xạ người dùng đối tác ổn định và định danh đơn hàng kinh doanh duy nhất.
* Giữ nguyên định danh gốc khi kiểm tra trạng thái của yêu cầu hết thời gian.
* Xác minh chữ ký webhook và lưu trữ các ID sự kiện đã xử lý.
* Chỉnh sửa bí mật và chữ ký khỏi nhật ký đồng thời giữ lại ID yêu cầu để hỗ trợ.

<h2 id="next-steps">
  Các bước tiếp theo
</h2>

#### [Java Khởi Đầu Nhanh](/vi/sdk/agent-sdk/java/quick-start)

Cài đặt và khởi tạo Agent SDK trong backend Java .

#### [PHP Khởi Đầu Nhanh](/vi/sdk/agent-sdk/php/quick-start)

Cài đặt và khởi tạo Agent SDK trong backend PHP .

#### [Webhook và tính lũy đẳng](/vi/sdk/security/webhooks-idempotency)

Xác minh các cuộc gọi lại và ngăn chặn xử lý kinh doanh trùng lặp.