OPEN PLATFORM · COMPATIBILITY

Epay / Rainbow Pay compatible payment gateway in China

If your system already uses an Epay or Rainbow Pay compatible plugin, fill in three values and keep your code: the gateway URL, the merchant ID and the merchant key. Funds still settle through a licensed payment company into your own account.

Protocol compatibility · Licensed payment company settlement

Epay and Rainbow Pay are industry names for a protocol family: shared-key signing with fixed parameters. Xiaodou Open Platform provides protocol compatibility for that family. It is not a no-sign or fourth-party collection service: buyer payments are collected and settled by a licensed payment company into the merchant's own settlement account, and the money does not pass through an intermediary account.

What compatibility means

The compatibility layer accepts the requests your existing plugin sends and returns results in the same protocol shape. Your plugin keeps its behavior; only the three configuration values change. The supported endpoints are submit.php, mapi.php and api.php, using the same parameters and signature rules as the protocol family.

The three values

SettingWhat to enter
Gateway URLThe address shown on the "Epay configuration" page in the merchant portal. Dujiaoshuka requires the full address including /submit.php; V2Board uses the base URL.
Merchant IDThe merchant number generated in the portal.
Merchant keyThe shared key generated in the portal. Enter it only in your plugin configuration.

Supported endpoints

EndpointPurpose
submit.phpForm checkout with a page redirect.
mapi.phpProgrammatic checkout that returns payment information.
api.phpQuery: act=order for an order, act=query for transactions.

Keep using the same entry point your plugin already sends to.

Which systems can switch

SystemVerification statusNote
Dujiaoshuka (also called Dujiaoshou Faka)Source-level review completedEnter the full gateway address including /submit.php
V2BoardSource-level review completedEnter the base gateway URL
Other similar pluginsEcosystem registration only; no source-level reviewSame protocol family; verify with your actual version and one small real order

Every migration is accepted only after one small real order passes order creation, webhook delivery and order query. Then switch production traffic.

Migration steps

  1. Enable the "Epay configuration" page in the merchant portal.
  2. Copy the gateway URL, merchant ID and merchant key.
  3. Fill the three values into your plugin.
  4. Verify order creation, webhook delivery and order query with one small real order.
  5. After it passes, switch production traffic.

Supported scope

What is not covered

FAQ

Is this an official partnership with Epay or Rainbow Pay?

No. This is protocol compatibility only. We do not claim an official partnership or certification. Funds are still collected and settled by a licensed payment company into your own account.

Do I need to change my system's code?

No. The plugin only needs three values: the gateway URL, the merchant ID and the merchant key. The compatibility layer translates the request into the Xiaodou payment chain.

Which endpoints are supported?

submit.php for form checkout, mapi.php for programmatic checkout, and api.php for order and transaction queries with act=order or act=query.

Can I accept WeChat Pay through this compatibility layer?

Yes. WeChat JSAPI is available when the buyer opens the cashier inside the WeChat browser. Mobile browsers outside WeChat and native apps have no direct invocation form.

Does the compatibility layer support API refunds?

No. Refunds are initiated from the merchant portal's completed orders page or through the signed merchant API refund flow, not through the Epay compatibility endpoints.

How should I verify a migration?

Run one small real order and verify order creation, webhook delivery and order query. Only then switch production traffic.