Skip to content

Merchant Onboarding

Overview

This document describes how to integrate the merchant onboarding feature. Before you begin, please review the following:

Business Process

Onboarding Status Flow

Description of image

Onboarding Application

  • Merchant Onboarding Application: This API submits a merchant onboarding application
  • The system returns a merchant ID merch_id and an account authorization link authorize_link
  • The request_id in the request parameters is used for tracking the business process

Account Confirmation

The merchant must confirm the account opening on the authorization interface opened via the authorize_link

Description of image

Information Update

  • Merchant Information Update: This API updates rejected onboarding applications
  • The request_id in the request parameters must match the request_id from the onboarding application
  • Only applications with status REJECTED can be updated
  • After updating information, the merchant must re-confirm through the Account Confirmation step

Query Onboarding Result

  • Query Merchant Onboarding Result: This API queries the review status of an onboarding application
  • The request_id in the request parameters must match the request_id from the onboarding application
  • Periodically call the query API to obtain the review status

Listen for Onboarding Result Notifications

  • Merchant Onboarding Result (Notification): webhook for receiving asynchronous notifications
  • Listen for callback notifications of type MERCH
  • The request_id in the notification content is the request_id from the onboarding application

Next Steps

After the merchant is successfully onboarded (status is NORMAL), you can use the merchant ID (merch_id) to open a collection account. See Collection Account for details.