China · Overview

Merchant APIs for China: payin, payout, wallet, and webhooks.

Environment

Env	API base (example)
Production	https://api.soranopro.com
Sandbox	https://sandbox-api.soranopro.com

Example: POST {API_BASE}/api/v1/merchant/payin/create

See Environment.

Credentials

Item	Notes
merchantNo	Header X-Merchant-No
Merchant RSA key pair	You sign requests; submit public key PEM
Platform public key	Verify webhooks
Country / currency	CN / CNY must match onboarding

Auth: Signature.

Endpoints

Action	Method	Path
Create payin	POST	/api/v1/merchant/payin/create
Query payin	GET	/api/v1/merchant/payin/query
Create payout	POST	/api/v1/merchant/payout/create
Query payout	GET	/api/v1/merchant/payout/query
Wallet	GET	/api/v1/merchant/wallet
Wallet txs	GET	/api/v1/merchant/wallet/transactions

Flow

Payin: create → created → ops confirms → completed → wallet credit + webhook.

Payout: create → freeze netAmount → task completes → completed → webhook.

Ensure CNY wallet balance >= netAmount before payout.

China notes

• Currency CNY
• Payout: bank transfer (BANK_TRANSFER) with bank name, account, CNAPS/bank code
• receiverName must match bank account holder name

Fees

Type	Net amount
Payin	netAmount = amount - fee
Payout	netAmount = amount + fee (frozen on create)

Docs

• Environment · Signature
• Payout · Payin · Common
• Appendix · Errors