Overview of Payments
Payments can be classified according to the source of funds:
Trade Collection
Payments made by your customers (buyers) to your VA account to pay for goods or service fees, which have a genuine trade background.
Platform Collection
Payments made by the platform or institution to your VA account, such as settlement payments from e-commerce platforms, advertising traffic platforms, app developer platforms, website building platforms, or acquiring agencies.
Same-Name Deposit
Transferring funds to your VA account using the same account name (matching the opening name of the VA account).
Trade & Platform Collection Flow
Steps marked with * in trade collection/platform collection scenarios are triggered based on different business situations.
Trade Collection
Platform Collection
Prerequisite: Merchants must first complete a payment account application. See Create Virtual Account for details.
Step 1* — Supplement Payer Information
The merchant receives a "No Payer Incoming Payment Notification" and supplements it through the Supplement Payer Information interface.
Some small currency payments lack payer information, so the provider cannot automatically match and post the payment for customers, requiring merchants to complete the process after supplementing payer information. The provider will notify customers via Collection Webhook to provide additional information and posting results.
Step 2 — Incoming Payment Notification
The merchant receives an incoming payment. The provider sends an incoming payment notification to the merchant via the Collection Webhook.
After merchants receive the incoming payment notification, if they want to check the incoming status, they can call the Get Detail Collection Order interface to confirm.
Step 3* — Supplement Information Based on Notification
Merchants supplement information according to the incoming payment notification:
(1) Trade Collection scenario: Merchants call the Create Trade Order interface to create or update contract orders.
(2) Platform Collection scenario: Merchants call the Supplement Recharge Information interface to supplement the required information for platform payment and account entry.
Webhook code reference:
If the Collection Webhook returns
code=15, the merchant calls Create Trade Order to create or update the contract order.If the Collection Webhook returns
code=13, the merchant calls Supplement Recharge Information to supplement the required information for platform payment posting.
In the trade collection scenario, merchants can call the Get Detail Trade Order interface to check contract orders. If incorrect contract order information is found during the query process, they can call Create Trade Order to update the contract order information.
Step 4* — Match Collection to Contract Order
Occurs only in trade collection scenarios. Merchants call the Match Collection and Trade Order interface to establish an association between incoming payments and maintained contract orders.
Step 5* — Review Result & Posting Notification
After the provider completes the document review, they send the verification result or account posting notification to the merchant via the Collection Webhook.
Webhook code reference:
code=20— Posting successful.code=17— Review not approved. The merchant needs to modify and resubmit. Follow these rules for resubmission:Platform Collection: Resubmit updated documents through Supplement Recharge Information. Update the original order using the original request number.
Trade Collection: Resubmit updated information through Create Trade Order. Update the original order using the original request number.
Trade Collection — changing matched contract order: If you need to replace the matching contract order, re-establish the matching relationship through Match Collection and Trade Order using a new request number.
Refund Instructions
For recharge, platform collection, and trade collection records, merchants can call the Create Refund Request interface to return funds to the original route under the following circumstances:
Pending related contract orders / Additional documents to be supplemented
Risk control review rejected
Pending matching orders
Within 14 days of successful posting
After the provider accepts the refund, the result will be returned via the Collection Webhook.
Some payments are temporarily unsupported for online refunds due to incomplete payer information and other reasons. If the refund reports an error, contact the provider for offline manual processing. Refund procedures may incur fees or financial losses — consult your account manager or customer service for details.
Contract Orders & Collection Records
What is a Contract Order?
Only applicable in trade collection business, contract orders are used to demonstrate the authenticity of the trade collection business background. Merchants need to link corresponding contract orders, and the provider will review this information accordingly. Only after approval will the funds be credited.
What is a Collection Record?
A record of the actual receipt of funds received by the merchant's account.
When to Create a Contract Order?
Merchants can create or update contract orders through the Create Trade Order interface, usually before payment is received or after receiving payment notifications.
What are the Requirements for Creating a Contract Order?
When creating a contract order, you need to fill in the contract amount and related business information, and you can also choose whether to settle foreign exchange. The labeling of non-settlement and settlement does not affect customer receipt and entry, but only contract orders marked "settlement" can increase the "settlement limit". Contract orders marked as "foreign exchange settlement" must simultaneously meet the review requirements for settlement business. Once approved, the corresponding settlement quota will be increased.
When Can Contract Orders Be Modified?
Whether modification is possible depends on canModifyType in the Collection Webhook:
SUPPLY_MATERIAL
Only otherFiles and contractFiles can be added through Create Trade Order.
ALL_MODIFY
All contract order information can be modified through Create Trade Order.
Matching Collection Records with Contract Orders
How Do Collection Records Match Contract Orders?
Merchants use the Match Collection and Trade Order interface to establish the association between collection records and contract orders. After completing the relationship review, the provider records the transaction.
What is the Relationship Between Collection Records and Contract Orders?
The two have a many-to-many relationship: a single collection record can match multiple contract orders, and a single contract order can match multiple collection records.
What Conditions Must Be Met for Matching to Be Credited?
The total amount of the associated contract order(s) must be ≥ the collection record amount.
Which Side Can Initiate the Match?
[Collection Record] → Initiate linked contract order: The matching amount of the contract order can be adjusted.
[Contract Order] → Initiate related collection records: The matching amount is based on the collection records and cannot be modified.
Does It Support Matching Different Currencies?
Only one mismatched currency is supported.
Related APIs
Apply for a payment account
Query collection records
Supplement missing payer information
Supplement platform collection information
Create or update contract orders
Query contract orders
Match collection records to contract orders
Initiate a refund
Incoming payment notifications and status updates
Last updated
Was this helpful?