# Onboarding (/vi/merchants/onboarding)



















Trước khi có thể xử lý thanh toán, merchant phải hoàn tất quy trình onboarding KYB (Know Your Business). Tapaya xác minh danh tính và thông tin doanh nghiệp của merchant để đáp ứng các yêu cầu của đơn vị xử lý thanh toán và các yêu cầu pháp lý theo khu vực.

<div className="bg-background relative h-auto w-full overflow-hidden rounded-lg border">
  <FlickeringGrid className="absolute inset-0 z-0 size-full" squareSize="4" gridGap="6" maxOpacity="0.1" flickerChance="0.1" height="800" width="2000" />

  <KybStatusDiagram />
</div>

## Bật thanh toán trực tuyến [#enable-online-payments]

Checkout đã hoạt động cho các merchant được phê duyệt. Trong quá trình onboarding, hãy chọn thanh toán trực tuyến hoặc cả thanh toán trực tuyến lẫn thanh toán tại cửa hàng. Cung cấp website của cửa hàng và thông tin về hoạt động kinh doanh trực tuyến. Onboarding chỉ dành cho Checkout không yêu cầu máy thanh toán.

Merchant yêu cầu thanh toán trực tuyến sẽ tự động xuất hiện trong mục **Checkout** của [Tapaya Platform](https://platform.tapaya.com/checkout-settings). Họ không thể nhận thanh toán cho đến khi đơn vị xử lý thanh toán trực tuyến phê duyệt và cổng thanh toán của họ được cấu hình. Chỉ riêng việc đã được phê duyệt cho thanh toán tại cửa hàng không đủ để bật Checkout. Merchant cũng phải ở trạng thái hoạt động.

Kiểm tra trạng thái **Ready** trong bảng merchant của Checkout, sau đó cấu hình key, ví điện tử và các URL trả về (nếu có) cho Hosted Checkout trong [cài đặt Checkout](/online/integration/checkout_settings). Chỉ tạo bản ghi merchant hoặc API key thôi thì không bật được thanh toán.

## Ma trận trách nhiệm [#responsibility-matrix]

Mọi quy trình đều kết thúc bằng cùng một quyết định xác minh, nhưng công việc dẫn đến quyết định đó được phân chia khác nhau. Hãy xác nhận ai phụ trách từng bước trước khi bạn chọn một quy trình dưới đây.

<ResponsibilityMatrix
  columns="[
  { key: &#x22;platform&#x22;, label: &#x22;Platform UI&#x22; },
  { key: &#x22;own&#x22;, label: &#x22;Giao diện riêng&#x22; },
  { key: &#x22;invite&#x22;, label: &#x22;Lời mời qua email&#x22; },
  { key: &#x22;campaign&#x22;, label: &#x22;Liên kết chiến dịch&#x22; },
]"
  rows="[
  { label: &#x22;Tạo bản ghi merchant&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;you&#x22;, note: &#x22;qua API&#x22; }, invite: { owner: &#x22;you&#x22;, note: &#x22;hoặc lời mời sẽ tạo bản ghi&#x22; }, campaign: { owner: &#x22;merchant&#x22;, note: &#x22;tự đăng ký&#x22; } } },
  { label: &#x22;Cung cấp biểu mẫu và quy tắc kiểm tra dữ liệu&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;you&#x22;, invite: { owner: &#x22;tapaya&#x22;, note: &#x22;do Tapaya lưu trữ&#x22; }, campaign: { owner: &#x22;tapaya&#x22;, note: &#x22;do Tapaya lưu trữ&#x22; } } },
  { label: &#x22;Phân phối liên kết&#x22;, cells: { platform: &#x22;none&#x22;, own: &#x22;none&#x22;, invite: { owner: &#x22;you&#x22;, note: &#x22;một người nhận&#x22; }, campaign: { owner: &#x22;you&#x22;, note: &#x22;mọi kênh&#x22; } } },
  { label: &#x22;Nhập thông tin doanh nghiệp, ngân hàng và chủ sở hữu&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;merchant&#x22;, note: &#x22;trong giao diện của bạn&#x22; }, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Đồng ý với điều khoản và Chính sách quyền riêng tư của Tapaya&#x22;, cells: { platform: &#x22;merchant&#x22;, own: &#x22;merchant&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Gửi hồ sơ đến đơn vị xử lý thanh toán&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Xác minh hồ sơ (KYB)&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Theo dõi trạng thái xác minh&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;you&#x22;, campaign: &#x22;you&#x22; } },
  { label: &#x22;Sửa thông tin bị từ chối hoặc còn thiếu&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
]"
/>

Khi onboarding có hỗ trợ trong Platform UI, nhân viên vận hành của bạn điền biểu mẫu thay cho merchant. Merchant vẫn là bên đồng ý với điều khoản và Chính sách quyền riêng tư của Tapaya, vì vậy hãy xác nhận rằng họ đã xem và đồng ý trước khi bạn gửi hồ sơ.

## Chọn quy trình onboarding [#choose-an-onboarding-flow]

Hãy chọn quy trình dựa trên việc ai sẽ nhập thông tin của merchant và bạn muốn phân phối onboarding theo cách nào. Mọi quy trình đều có sẵn trong Tapaya Platform UI. Nếu muốn tự động hóa, hãy sử dụng API tương ứng được mô tả trong [API onboarding merchant](/platform-api/merchant_onboarding).

<Tabs defaultValue="platform" groupId="merchant-onboarding-flow" className="border-0 bg-transparent">
  <TabsList>
    <TabsTrigger value="platform">
      Platform UI
    </TabsTrigger>

    <TabsTrigger value="api">
      Giao diện riêng
    </TabsTrigger>

    <TabsTrigger value="email">
      Lời mời qua email
    </TabsTrigger>

    <TabsTrigger value="campaign">
      Liên kết chiến dịch
    </TabsTrigger>
  </TabsList>

  <TabsContent value="platform">
    ### Tapaya Platform UI [#tapaya-platform-ui]

    Quản trị viên nhập thông tin của merchant và hoàn tất onboarding thay cho họ trong [Tapaya Platform](https://platform.tapaya.com). Cách này phù hợp cho onboarding có hỗ trợ, danh mục merchant nhỏ hơn, hoặc những trường hợp đội ngũ vận hành của bạn đã có sẵn thông tin cần thiết.

    **Cách bắt đầu:** Tạo hoặc chọn merchant trong Tapaya Platform và mở phần onboarding của họ. Quy trình tương tự có thể được khởi tạo qua [API](/platform-api/merchant_onboarding) khi bạn cần tự động hóa.

    Trong thanh bên, mở rộng **Payments** và mở **Merchants**. Đi tới mục **Add a merchant**. Trên thẻ **Add a merchant manually**, chọn **Start onboarding**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Bắt đầu onboarding merchant từ Tapaya Platform" src="__img0" />
    </div>

    Platform mở biểu mẫu onboarding có hướng dẫn với các phần bắt buộc về thông tin doanh nghiệp, ngân hàng và chủ sở hữu.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Biểu mẫu thông tin doanh nghiệp của merchant trong Tapaya Platform" src="__img1" />
    </div>
  </TabsContent>

  <TabsContent value="api">
    ### Giao diện riêng [#your-own-ui]

    Thu thập thông tin của merchant trong sản phẩm của riêng bạn và gửi đến Tapaya. Cách này giúp bạn kiểm soát hoàn toàn trải nghiệm và cho phép kết hợp onboarding với quy trình đăng ký hoặc quản lý tài khoản hiện có.

    Tùy chọn này yêu cầu bạn giữ biểu mẫu và quy tắc kiểm tra dữ liệu luôn phù hợp với các yêu cầu onboarding hiện hành. Tapaya Platform UI vẫn sẵn có để xem xét merchant và hoàn tất các bước tiếp theo.

    **Cách bắt đầu:** Sử dụng [quy trình onboarding qua API và các ví dụ](/platform-api/merchant_onboarding) chi tiết.

    Trước khi gửi thông tin của merchant qua API, bạn phải có được sự đồng ý của họ đối với [Điều khoản và Điều kiện dành cho bên tích hợp của Tapaya](https://tapaya.com/terms) và [Chính sách quyền riêng tư của Tapaya](https://tapaya.com/privacy). Bạn có thể thêm một ô đánh dấu vào biểu mẫu onboarding có liên kết đến cả hai tài liệu, hoặc liên kết đến các tài liệu của Tapaya từ phần nội dung điều khoản mà merchant đồng ý. Bạn cũng phải liệt kê Tapaya là bên xử lý dữ liệu trong chính sách quyền riêng tư của riêng bạn.

    Giao diện của bạn có thể dùng bất kỳ thiết kế trực quan nào phù hợp với sản phẩm. Một quy trình điển hình chia thông tin bắt buộc thành các phần dễ quản lý và hiển thị tiến độ trước khi gửi.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Wireframe của một biểu mẫu onboarding merchant tùy chỉnh" src="__img2" />
    </div>
  </TabsContent>

  <TabsContent value="email">
    ### Lời mời qua email [#email-invite]

    Bạn có thể onboarding một merchant bằng cách mời họ trực tiếp từ Tapaya Platform. Nhập địa chỉ email của merchant và
    Tapaya sẽ tạo một lời mời dùng một lần kèm liên kết onboarding bảo mật do Tapaya lưu trữ; phía merchant không cần tích hợp
    SDK.

    Merchant mở liên kết, hoàn tất cùng quy trình KYB có hướng dẫn, rồi quay lại sản phẩm của bạn sau khi được xác minh. Cách này hữu ích để onboarding merchant trước khi họ bắt đầu sử dụng tích hợp của bạn, hoặc khi bạn muốn một quy trình hoàn toàn do Tapaya lưu trữ.

    Dùng cách này cho các lời mời riêng lẻ, đặc biệt khi bạn biết merchant là ai nhưng muốn họ tự cung cấp và xác nhận
    thông tin của mình. Mỗi lời mời chỉ dành cho một người nhận và sẽ hết hạn nếu không được sử dụng.

    Nếu bạn đã tạo merchant trong hệ thống của riêng mình và cần quy trình onboarding do Tapaya lưu trữ gắn với chính
    bản ghi đó, hãy tạo bản ghi merchant cơ bản trước rồi gửi lời mời với cùng `merchantToken`. Đây là quy trình API
    được khuyến nghị cho bên tích hợp:

    1. `POST /merchant/auth/register` hoặc `POST /integrator/merchant`
    2. `POST /integrator/merchant/send-registration-invite` với `email` và cùng `merchantToken`
    3. Merchant mở `registrationUrl` được trả về và hoàn tất biểu mẫu KYB do Tapaya lưu trữ

    Nếu không có `merchantToken`, việc hoàn tất lời mời sẽ tạo một bản ghi merchant mới.

    Dù merchant onboarding qua quy trình nào, tài khoản của họ đều đi theo cùng vòng đời xác minh như minh họa ở trên.

    **Cách bắt đầu:** Gửi và quản lý lời mời từ Tapaya Platform UI, hoặc tự động hóa lời mời qua
    [API](/platform-api/merchant_onboarding#invite-a-merchant-to-complete-hosted-onboarding).

    Trong thanh bên, mở rộng **Payments** và mở **Merchants**. Đi tới mục **Add a merchant**. Trên thẻ **Invite via e-mail**, chọn **Send invite link**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Tùy chọn lời mời qua email trong Tapaya Platform" src="__img3" />
    </div>

    Nhập địa chỉ email của merchant trong hộp thoại mời và chọn mức hoa hồng áp dụng.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Hộp thoại gửi lời mời đăng ký cho merchant" src="__img4" />
    </div>
  </TabsContent>

  <TabsContent value="campaign">
    ### Liên kết chiến dịch [#campaign-link]

    Tạo một liên kết đăng ký có thể dùng lại và chia sẻ qua website, cổng thông tin đối tác, bản tin hoặc kênh khác. Nhiều merchant có thể dùng liên kết này để đăng ký và hoàn tất onboarding trong giao diện do Tapaya lưu trữ.

    Dùng cách này khi bạn không biết trước người nhận hoặc khi bạn muốn một quy trình thu hút merchant tự phục vụ có khả năng mở rộng. Bạn kiểm soát thời điểm liên kết hết hạn và có thể thu hồi liên kết khi chiến dịch kết thúc.

    **Cách bắt đầu:** Tạo và quản lý liên kết chiến dịch từ Tapaya Platform UI, hoặc tự động hóa qua [API](/platform-api/merchant_onboarding).

    Trong thanh bên, mở rộng **Payments** và mở **Merchants**. Đi tới mục **Campaign onboarding links**, sau đó chọn **Manage links**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Tùy chọn liên kết onboarding theo chiến dịch trong Tapaya Platform" src="__img5" />
    </div>

    Đặt tên cho chiến dịch, đặt ngày hết hạn và chọn mức hoa hồng trước khi chia sẻ liên kết được tạo.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Hộp thoại quản lý liên kết onboarding theo chiến dịch" src="__img6" />
    </div>
  </TabsContent>
</Tabs>

## Tổng quan ai phụ trách việc gì [#who-owns-what-overall]

Xét trên cả bốn quy trình, mỗi bước onboarding thuộc về một hoặc nhiều trong ba bên. Một bước được đánh dấu hai lần là bước mà bên phụ trách phụ thuộc vào quy trình bạn đã chọn ở trên.

<ResponsibilityMatrix
  rowHeader="Bước onboarding"
  parties="[&#x22;tapaya&#x22;, &#x22;you&#x22;, &#x22;merchant&#x22;]"
  rows="[
  { label: &#x22;Chọn quy trình onboarding&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Cung cấp biểu mẫu và quy tắc kiểm tra dữ liệu&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Nhập thông tin doanh nghiệp, ngân hàng và chủ sở hữu&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
  { label: &#x22;Phân phối lời mời và liên kết chiến dịch&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Đồng ý với điều khoản và Chính sách quyền riêng tư của Tapaya&#x22;, owners: [&#x22;merchant&#x22;] },
  { label: &#x22;Gửi hồ sơ đến đơn vị xử lý thanh toán&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Xác minh hồ sơ (KYB)&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Cập nhật yêu cầu theo quy định&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Theo dõi trạng thái xác minh&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Sửa thông tin bị từ chối hoặc còn thiếu&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
]"
/>

## Những phần trách nhiệm được chia sẻ [#where-responsibility-is-shared]

* **Cung cấp biểu mẫu và quy tắc kiểm tra dữ liệu:** Tapaya cung cấp và duy trì biểu mẫu cho Platform UI, lời mời qua email và liên kết chiến dịch. Nếu bạn xây dựng giao diện riêng, biểu mẫu thuộc về bạn và bạn tự giữ các trường cùng quy tắc kiểm tra dữ liệu luôn phù hợp với yêu cầu hiện hành.
* **Đồng ý với điều khoản và Chính sách quyền riêng tư của Tapaya:** Tapaya hiển thị các tài liệu này trong các quy trình do Tapaya lưu trữ. Với giao diện riêng, bạn phải cung cấp liên kết đến cả hai tài liệu và có được sự đồng ý của merchant trước khi gửi thông tin onboarding của họ qua API. Bạn cũng phải liệt kê Tapaya là bên xử lý dữ liệu trong chính sách quyền riêng tư của riêng bạn.
* **Nhập thông tin:** Đội ngũ của bạn nhập thông tin trong quá trình onboarding có hỗ trợ trên Platform UI. Trong mọi quy trình do Tapaya lưu trữ hoặc tự phục vụ, merchant tự nhập thông tin của mình.
* **Cập nhật yêu cầu theo quy định:** Tapaya tự động cập nhật các quy trình do Tapaya lưu trữ. Với giao diện riêng, bạn theo dõi các thay đổi trong [yêu cầu onboarding qua API](/platform-api/merchant_onboarding) và cập nhật biểu mẫu của mình.
* **Theo dõi trạng thái xác minh:** Tapaya cung cấp trạng thái trong Platform UI, qua `Accept.merchant.onboardingStatus()` trong Accept SDK và qua API. Việc xử lý theo trạng thái đó là của bạn: hãy nhắc merchant khi có thông tin còn thiếu hoặc bị từ chối.
* **Sửa thông tin bị từ chối hoặc còn thiếu:** Ai đã nhập thông tin thì người đó sửa. Với các quy trình do Tapaya lưu trữ, điều đó có nghĩa là nhắc merchant gửi lại.

Để biết về trách nhiệm trong toàn bộ vòng đời của merchant chứ không chỉ riêng onboarding, xem [Trách nhiệm](./responsibilities).

## Trạng thái xác minh [#verification-status]

Sau khi merchant gửi biểu mẫu, tài khoản của họ chuyển sang trạng thái xem xét. Đơn vị xử lý thanh toán xem xét hồ sơ; việc này thường hoàn tất trong vài phút nhưng có thể lâu hơn trong một số trường hợp.

Merchant sẽ không thể xử lý giao dịch cho đến khi tài khoản được xác minh. Bạn có thể kiểm tra trạng thái của họ bất cứ lúc nào trong Tapaya Platform UI. Các tích hợp cũng có thể kiểm tra trạng thái bằng `Accept.merchant.onboardingStatus()` trong Accept SDK hoặc qua API, và nhắc merchant gửi lại nếu thông tin còn thiếu hoặc bị từ chối.