> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apply for Payment Method (Acquiring)

> The application page under Payment > Payment Methods in the merchant dashboard — a full-screen form: choose a payment method on the left (Visa/Mastercard, Alipay, WeChat Pay, PayNow, crypto, and more), then on the right select online/in-person products, fill in common information and configuration, upload the required documents, and submit for review; you must configure your business category (MCC) before applying.

## What this is

This is the **Apply for Payment Method** page under the **Payment Methods** page in the **Payments** module of the merchant dashboard, reached by starting an application from the Payment Methods page. It is a full-screen form split into two columns: the **left column** lists the payment methods you can apply for (such as Visa / Mastercard, Alipay, Alipay HK, WeChat Pay, GrabPay, ShopeePay, Touch 'n Go, TrueMoney, Apple Pay, Google Pay, PayNow, and crypto), filterable by type (Card / E-Wallet / Bank / Crypto) or searchable; the **right column** is the application form for whichever method you select — choose the online/in-person products to enable, fill in common information and configuration, upload the required documents, add any additional notes, and finally submit for review. Use this page whenever you want to enable a new receiving method for your store (credit card, e-wallet, QR/scan-code, bank transfer, and so on).

> **Prerequisite**: you must complete your **Business Category (MCC)** setup first. If it isn't configured, entering this page pops up a **Business Category Required** dialog, and you need to set it up before you can continue applying. The **X** in the top right or **Cancel** at the bottom exits the page immediately back to Payment Methods; unsubmitted content is not saved.

> Whether a given payment method can actually be applied for depends on your business category and account configuration; the final terms are confirmed during UQPAY's review.

## Steps

1. Start an **Apply** action from the Payment Methods page to open the full-screen **Apply for Payment Method** page. If a **Business Category Required** prompt appears, it means your business category (MCC) is not yet configured — click **Setup Business Category Now** to complete it first, then come back to apply.
2. **Select a payment method in the left column**: filter using the type tabs at the top (**All / Card / E-Wallet / Bank / Crypto**), or use the search box in the top right to search by name or region. Clicking a payment method selects it and loads its application form on the right.
   * A method tagged **Applied** in green means you have already submitted an application for it and cannot apply again (clicking does nothing).
   * A method tagged **Not Available** in red means "this payment method is not available for your business category (MCC)"; clicking it opens a **Payment Method Not Available** dialog, and you need to contact the support team.
3. **Select payment products**: in the **Select Payment Products** section on the right, products are listed in two groups, **Online** and **In-Person**, each showing its product name, settlement flow, and supported currencies. Check the boxes for the products you want to enable, or use **Select All** / **Deselect All** in each group's top-right corner to bulk-select. At least one must be selected.
4. **Fill in common information**: a **Common Information** section appears (these fields are shared across all selected products — fill them once, and they'll be reused when applying for other payment methods). Depending on which products you selected, you may see the groups **Store Information** (Store Name, Country, State / Province, City, Postal Code, Street Address), **Business Contact** (Office Phone, Merchant Short Name), **Website Information** (Website URL, Warehouse Address), and **App Information** (App Name, App Download URL). Fields marked `*` are required. Fields that were already auto-filled show **Auto-filled · confirm or edit** — check them and adjust as needed.
5. **Fill in configuration**: if a selected product needs product-specific parameters, a **Configuration** section appears, grouped by product, with fields such as `H5 Payment URL`, `Allow Browser Payment` (Yes / No), `Official Account AppID` (WeChat), `Mini Program AppID`, and `App AppID`. Fill them in following the on-screen format examples.
6. **Upload required documents**: the **Required Documents** section lists the materials needed for your selected products (before any product is selected it shows "Select products above to see required documents."). Upload each item — every file supports **PDF, JPEG, or PNG, up to 10 MB**. Common documents include `Domain Certificate`, `Lease Contract`, `Logistics Partnership Agreement`, and `Store Photos`.
7. **Add additional notes** (optional): use the **Additional Notes** field for any extra information or special requirements.
8. Click **Submit Application** at the bottom. Missing items are blocked with a prompt: no product selected shows "Please select at least one payment product"; missing required fields or documents show "Please fill in all required fields". On success you see **Application Submitted** and are returned to Payment Methods; on failure a **Submission failed** message appears with the reason.

## Fields and statuses

**Status tags on payment methods (left column):**

| Tag                                            | Meaning (merchant view)                                                                                           |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Applied                                        | You have already submitted an application for this method; you cannot apply again                                 |
| Not Available                                  | Your business category (MCC) does not support this method; you cannot apply, and need to contact the support team |
| Region badge (e.g. Global / China / Singapore) | The main region this payment method covers                                                                        |
| Type badge (Card / E-Wallet / Bank / Crypto)   | The category this payment method belongs to                                                                       |

**Payment product groups:**

| Group     | Meaning                                                                         |
| --------- | ------------------------------------------------------------------------------- |
| Online    | Products for online receiving scenarios such as web / app / mini program        |
| In-Person | Products for face-to-face in-store receiving (QR/scan-code, payment code, etc.) |

> Each product shows its settlement flow (e.g. Redirect, 3D Secure, QR Code, Payment Code, Static QR, Mini Program, APP, H5/WAP) and supported currencies; the specific products and currencies vary by payment method.

**Common Information fields** (shared across selected products, fill once and reuse):

| Group               | Fields                                                                   |
| ------------------- | ------------------------------------------------------------------------ |
| Store Information   | Store Name, Country, State / Province, City, Postal Code, Street Address |
| Business Contact    | Office Phone, Merchant Short Name                                        |
| Website Information | Website URL, Warehouse Address                                           |
| App Information     | App Name, App Download URL                                               |

**Common configuration fields** (English labels + meaning, shown per selected product):

| Field                         | Meaning                               | Notes                                            |
| ----------------------------- | ------------------------------------- | ------------------------------------------------ |
| `H5 Payment URL`              | H5 payment page address               | Must start with http\:// or https\://            |
| `Allow Browser Payment`       | Whether in-browser payment is allowed | Choose Yes or No                                 |
| `Official Account AppID`      | WeChat Official Account AppID         | Starts with `wx` + 16 alphanumeric characters    |
| `Mini Program AppID` (WeChat) | WeChat Mini Program AppID             | Starts with `wx` + 16 alphanumeric characters    |
| `Mini Program AppID` (Alipay) | Alipay Mini Program AppID             | 16-18 digits                                     |
| `App AppID`                   | Application AppID                     | Starts with `wx` + 16 alphanumeric characters    |
| Office Phone                  | Contact phone number                  | Digits, spaces, and `+` only, e.g. +65 6123 4567 |

**Required Documents** (English labels + meaning, shown per selected product):

| Document                          | Meaning                         |
| --------------------------------- | ------------------------------- |
| `Domain Certificate`              | Domain certificate              |
| `Lease Contract`                  | Lease contract                  |
| `Logistics Partnership Agreement` | Logistics partnership agreement |
| `Store Photos`                    | Store photos                    |

> Each document supports PDF, JPEG, or PNG, up to 10 MB per file. The exact documents required depend on the selected products — online receiving products generally need a domain certificate, lease contract, and logistics partnership agreement; in-person store products generally need store photos and a lease contract.

**Prerequisite — Business Category (MCC):**

| Dialog                       | When it appears                                  | Meaning and what to do                                                                                                                            |
| ---------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Business Category Required   | Entering the apply page before MCC is configured | You must complete business category setup before applying; click **Setup Business Category Now** to configure it                                  |
| Payment Method Not Available | Clicking a method tagged Not Available           | Your current business category doesn't support this method; the dialog shows your business category code and asks you to contact the support team |

> Your Business Category (MCC) determines which payment methods you can apply for; it is a one-time configuration and generally cannot be changed through the system once confirmed.

## Edge cases and troubleshooting

* **Entering the apply page immediately shows "Business Category Required"**: your account hasn't configured a business category (MCC) yet — click **Setup Business Category Now** to complete setup, then come back to apply.
* **The payment method you want is greyed out / unclickable**: if tagged **Applied**, you've already applied and can't apply again; if tagged **Not Available**, your business category doesn't support it — contact the support team.
* **Clicking Submit Application does nothing / shows "Please select at least one payment product"**: you haven't checked any online/in-person products yet; check at least one, then submit.
* **"Please fill in all required fields"**: fill in the fields marked `*` in Common Information and Configuration, and upload any missing required documents, then submit again.
* **A field is filled in but shows a format error**: follow the format hints — Office Phone accepts only `+`, spaces, and digits; `H5 Payment URL` and other website-type addresses must start with http\:// or https\://; WeChat-type AppIDs must be "wx + 16 alphanumeric characters"; Alipay Mini Program AppID must be 16-18 digits.
* **A file won't upload**: only PDF, JPEG, and PNG are supported, up to 10 MB each — files that exceed the limit or use another format are rejected.
* **Common Information is still filled in after switching payment methods**: fields like Store Name and Office Phone are auto-carried over and reused across payment methods — just confirm they're correct; you don't need to re-enter them.
* **"Submission failed" after submitting**: handle it based on the reason shown in the dialog (e.g. business category not configured), then retry; contact the support team if it keeps failing.
* **After a successful submission**: you'll see **Application Submitted** and be returned to the Payment Methods page; the application moves into UQPAY's review process.

## Common questions (Q\&A)

* **Q: How do I apply for a new payment method / enable a receiving channel?** A: Start an application from the Payment Methods page. On the apply page, select a payment method on the left, check online/in-person products on the right, fill in common information and configuration, upload the required documents, and click **Submit Application**.
* **Q: Why does the apply page ask me to "set up a business category" first?** A: You must configure your business category (MCC) before applying for payment methods — it determines which methods you're eligible for. Click **Setup Business Category Now** to complete it first.
* **Q: The payment method I want is greyed out / shows "Not Available" — what do I do?** A: Your business category (MCC) doesn't support that method, so you can't apply for it; contact the support team.
* **Q: What does "Applied" mean?** A: You've already submitted an application for that payment method and can't apply again.
* **Q: Can I apply for multiple products at once?** A: Yes. In the **Select Payment Products** section, you can multi-select products under both Online and In-Person, or use **Select All** to bulk-check — at least one is required.
* **Q: What documents do I need to submit?** A: It depends on the products you selected — online receiving products typically need a domain certificate, lease contract, and logistics partnership agreement; in-person store products typically need store photos and a lease contract. Each file supports PDF/JPEG/PNG, up to 10 MB.
* **Q: Why is Common Information still auto-filled after I switch payment methods?** A: Common Information fields such as Store Name, Office Phone, and website details are shared across selected products — fill them once and they carry over automatically when applying for other methods; just confirm or edit as needed.
* **Q: How do I fill in the AppID and H5 payment page address in Configuration?** A: WeChat Official Account / Mini Program / App AppIDs are "wx + 16 alphanumeric characters"; Alipay Mini Program AppID is 16-18 digits; the H5 payment page address must start with http\:// or https\://.
* **Q: Clicking submit shows "Please fill in all required fields" — what now?** A: Fill in the Common Information and Configuration fields marked `*`, and upload any required documents that are still missing, then submit again.
* **Q: How long after submitting can I use it?** A: Submitting moves the application into UQPAY's review; this page doesn't show a review timeline — check the review outcome and activation status on the Payment Methods page.
* **Q: I filled in half the application and want to exit — how?** A: Click the **X** in the top right or **Cancel** at the bottom to return to Payment Methods; unsubmitted content is not saved.