> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Nạp và rút tiền pháp định bảo mật

> Nạp và rút tiền pháp định trực tiếp vào và từ số dư riêng tư mà không tiết lộ tài sản hoặc số tiền.

Người dùng có thể nạp và rút số dư tiền pháp định trực tiếp vào và từ số dư Solana bảo mật của họ.
Cả hai thao tác đều không gửi tiền vào số dư công khai, do đó không tiết lộ tài sản hoặc số tiền mà người dùng nạp hay rút.

<Tabs>
  <Tab title="On-ramp from fiat balance">
    | Trường                                   | Khả năng hiển thị    | Lý do                                                                       |
    | ---------------------------------------- | -------------------- | --------------------------------------------------------------------------- |
    | Số dư tiền pháp định và khoản thanh toán | Không nằm trên chuỗi | Khoản thanh toán bằng tiền pháp định không nằm trên chuỗi                   |
    | Tài sản                                  | Riêng tư             | Tài sản được mã hóa trên chuỗi                                              |
    | Số tiền                                  | Riêng tư             | Số tiền được chuyển được mã hóa trên chuỗi                                  |
    | Nhà cung cấp dịch vụ on-ramp             | Công khai            | Trong một Ring bảo mật, địa chỉ ví của nhà cung cấp được hiển thị.          |
    | Địa chỉ ví của người dùng                | Công khai            | Trong một Ring bảo mật, địa chỉ ví của người dùng được hiển thị trên chuỗi. |
  </Tab>

  <Tab title="Off-ramp to fiat balance">
    | Trường                                              | Khả năng hiển thị | Lý do                                                                       |
    | --------------------------------------------------- | ----------------- | --------------------------------------------------------------------------- |
    | Khoản thanh toán bằng tiền pháp định                | Không trên chuỗi  | Khoản thanh toán bằng tiền pháp định không diễn ra trên chuỗi               |
    | Tài sản                                             | Riêng tư          | Tài sản được mã hóa trên chuỗi                                              |
    | Số tiền                                             | Riêng tư          | Số tiền được chuyển được mã hóa trên chuỗi                                  |
    | Nhà cung cấp dịch vụ chuyển đổi sang tiền pháp định | Công khai         | Trong một Ring bảo mật, địa chỉ ví của nhà cung cấp được hiển thị.          |
    | Địa chỉ ví của người dùng                           | Công khai         | Trong một Ring bảo mật, địa chỉ ví của người dùng được hiển thị trên chuỗi. |
  </Tab>
</Tabs>

<img src="https://mintcdn.com/helius/q7LsEOD0O5LZhnha/images/privacy/on-off-ramp/on-offramp-overview.svg?fit=max&auto=format&n=q7LsEOD0O5LZhnha&q=85&s=5678250e0ea926b6461a4c09e2fa5886" alt="A fiat on-ramp and off-ramp. On the fiat side, a User fiat balance box connects by a two-way arrow to an Onramp Provider and Offramp Provider circle that straddles a dashed divider between fiat and onchain. On the private onchain side, the provider connects by a two-way arrow to user wallets holding private balances." width="1560" height="500" data-path="images/privacy/on-off-ramp/on-offramp-overview.svg" />

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

* Nhà cung cấp (ví dụ: sàn giao dịch tập trung hoặc đơn vị xử lý chuyển đổi tiền pháp định sang tiền mã hóa) nắm giữ số dư riêng tư của tài sản để phục vụ hoạt động nạp và rút tiền riêng tư (SOL hoặc bất kỳ token SPL / Token 2022 nào, chẳng hạn như USDC).
* Đảm bảo tài khoản nạp và rút tiền riêng tư có đủ số dư để phục vụ người dùng.
* Người dùng có Ví Riêng tư.

## Luồng tổng quan

Phần giao dịch tiền pháp định phụ thuộc vào sổ cái nội bộ của bạn.
Có thể tích hợp tính năng nạp và rút tiền riêng tư vào Vòng Mặc định hoặc Vòng Tùy chỉnh. Vòng Tùy chỉnh có thể ở chế độ bảo mật hoặc ẩn danh.

### 1. Nạp tiền

Thao tác nạp tiền ghi có vào số dư riêng tư: người dùng thanh toán tiền pháp định ngoài chuỗi; nhà cung cấp gửi một giao dịch chuyển tiền riêng tư trên chuỗi từ tài khoản nạp tiền của họ đến Ví Riêng tư của người dùng.

1. Người dùng gửi tiền pháp định.
2. Nhà cung cấp đối chiếu khoản tiền pháp định người dùng đã gửi với một Ví Riêng tư trong sổ cái nội bộ.
3. Nhà cung cấp đồng bộ số dư riêng tư của tài khoản nạp tiền để lấy số dư mới nhất, sau đó gửi một giao dịch chuyển tiền riêng tư đến Ví Riêng tư của người dùng.

```mermaid theme={"system"}
%%{init: {
  'theme': 'base',
  'themeVariables': {
    'lineColor':           '#FF6B35',
    'primaryTextColor':    '#737373',
    'primaryBorderColor':  '#9CA3AF',
    'actorBkg':            '#FFFFFF',
    'actorBorder':         '#9CA3AF',
    'actorTextColor':      '#737373',
    'signalColor':         '#FF6B35',
    'signalTextColor':     '#737373',
    'labelBoxBkgColor':    '#FF6B351F',
    'labelBoxBorderColor': '#FF6B35',
    'noteBkgColor':        '#F5F5F5',
    'noteTextColor':       '#737373',
    'noteBorderColor':     '#9CA3AF'
  }
}}%%
sequenceDiagram
    participant User
    participant UW as UserWallet
    participant P as Provider OnOfframp
    participant RPC as RPC
    participant SPP as Solana

    User->>P: onramp request (fiat amount)

    P->>RPC: sync the on-ramp account balance
    RPC-->>P: latest on-ramp account balance
    Note over P: build and sign the private transfer
    P->>RPC: request proof
    RPC-->>P: proof
    P->>SPP: submit private transfer (on-ramp account to user)
    SPP-->>P: confirmed, transaction hash

    UW->>RPC: sync private balance
    RPC-->>UW: confirm private balance
```

### 2. Rút tiền

Thao tác rút tiền bao gồm một giao dịch chuyển tiền riêng tư từ Ví Riêng tư của người dùng đến tài khoản rút tiền và cập nhật sổ cái nội bộ của nhà cung cấp để chi trả tiền pháp định cho người dùng.

Các bước hoàn tất một giao dịch rút tiền riêng tư bao gồm:

1. Người dùng đồng bộ số dư riêng tư và gửi một giao dịch chuyển tiền riêng tư đến tài khoản rút tiền của nhà cung cấp.
2. Trong Vòng bảo mật, nhà cung cấp có thể đối chiếu giao dịch chuyển tiền bằng địa chỉ ví người dùng hiển thị công khai. Trong Vòng ẩn danh, sổ cái công khai không tiết lộ người gửi hoặc người nhận; hãy đối chiếu thông qua yêu cầu rút tiền trong sổ cái nội bộ.

```mermaid theme={"system"}
%%{init: {
  'theme': 'base',
  'themeVariables': {
    'lineColor':           '#FF6B35',
    'primaryTextColor':    '#737373',
    'primaryBorderColor':  '#9CA3AF',
    'actorBkg':            '#FFFFFF',
    'actorBorder':         '#9CA3AF',
    'actorTextColor':      '#737373',
    'signalColor':         '#FF6B35',
    'signalTextColor':     '#737373',
    'labelBoxBkgColor':    '#FF6B351F',
    'labelBoxBorderColor': '#FF6B35',
    'noteBkgColor':        '#F5F5F5',
    'noteTextColor':       '#737373',
    'noteBorderColor':     '#9CA3AF'
  }
}}%%
sequenceDiagram
    participant User
    participant UW as UserWallet
    participant P as Provider OnOfframp
    participant RPC as RPC
    participant SPP as Solana

    User->>P: send off-ramp request (amount)

    UW->>RPC: sync private balance
    Note over UW: build and sign the private transfer
    UW->>RPC: request proof
    RPC-->>UW: proof
    UW->>SPP: submit private transfer (user to off-ramp account)
    SPP-->>UW: confirmed, transaction hash

    P->>RPC: sync off-ramp account
    RPC-->>P: off-ramp request confirmed
    Note over P: match sender to a user, credit fiat ledger
    P->>User: pay out fiat
```

### 3. Tài khoản nạp và rút tiền

Tài khoản nạp và rút tiền là số dư riêng tư của nhà cung cấp dùng để phục vụ hoạt động nạp và rút tiền của người dùng. Tài khoản này có thể giữ SOL hoặc bất kỳ token SPL hay Token-2022 nào bạn muốn hỗ trợ, chẳng hạn như USDC.

Đảm bảo tài khoản nạp và rút tiền có đủ số dư để phục vụ người dùng, tương tự như hoạt động nạp và rút tiền công khai.

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

Để nạp tiền vào số dư riêng tư của tài khoản, hãy gửi từ một số dư Solana công khai (ví nguồn công khai) sang một số dư riêng tư. Người dùng chỉ tương tác với tài khoản thông qua các giao dịch chuyển tiền riêng tư, vì vậy số tiền và tài sản được chuyển cho người dùng không bao giờ bị tiết lộ.

| Trường                       | Khả năng hiển thị | Lý do                                               |
| ---------------------------- | ----------------- | --------------------------------------------------- |
| Ví công khai nguồn           | Công khai         | Địa chỉ ví nguồn hiển thị trên chuỗi                |
| Tài sản                      | Công khai         | Tài sản hiển thị trên chuỗi                         |
| Số lượng                     | Công khai         | Số lượng đã nạp hiển thị trên chuỗi                 |
| Địa chỉ ví đích              | Công khai         | Địa chỉ ví đích hiển thị trên chuỗi                 |
| Số dư riêng tư sau giao dịch | Riêng tư          | Số dư riêng tư sau giao dịch được mã hóa trên chuỗi |

## Bắt đầu tích hợp

<Card title="Native Wallet Integration" icon="wallet" href="/docs/vi/privacy/integration/wallet">
  Thêm hỗ trợ quyền riêng tư bằng cơ chế quản lý khóa của riêng bạn. Dành cho các nhà cung cấp muốn quản lý khóa mã hóa và chạy quá trình đồng bộ trạng thái.
</Card>

<Card title="Integrate Embedded Privacy Wallet" icon="key" href="/docs/vi/privacy/integration/embedded-wallet">
  Thêm hỗ trợ quyền riêng tư vào ứng dụng của bạn thông qua REST API. Dành cho các nhà cung cấp và ứng dụng muốn bắt đầu nhanh chóng mà không cần tự quản lý khóa và đồng bộ trạng thái.
</Card>

<Card title="Integration with Custom Ring" icon="building" href="/docs/vi/privacy/integration/enterprise">
  Thêm hỗ trợ quyền riêng tư thông qua REST API và cấu hình một vòng tùy chỉnh với các biện pháp kiểm soát chính sách và tuân thủ.
  Dành cho các công ty fintech, nền tảng quản lý tiền lương, công ty chuyển tiền, ngân hàng số và doanh nghiệp.
</Card>

## Không tìm thấy nội dung bạn đang tìm kiếm?

<Callout type="info">
  Hãy liên hệ với chúng tôi! [Telegram](https://t.me/tilo_light) | [Email](mailto:sales@helius.xyz) | [Liên hệ](https://www.helius.dev/contact)
</Callout>
