PayIn Flow

This section describes the key steps, statuses, and notes for payment collection.

Flow overview

1. Merchant creates and pays the order
2. Platform returns a payment action (redirect/QR, etc.)
3. User completes payment
4. Platform notifies the merchant of the result
5. Merchant actively queries to confirm the final state if needed

Key statuses

Status	Meaning	Handling
USER_PAYING	User is paying	Show pending state and wait for callback
SUCCESS	Payment succeeded	Deliver goods or entitlements
FAIL	Payment failed	Show reason or guide retry

Callbacks and queries

• Callbacks trigger only on terminal success; verify signature and handle idempotency.
• If no callback arrives or status is unclear, query actively.

Common scenarios

• Redirect: Use action.url to redirect the user to complete payment.
• QR: Use action.qrContent to display QR content.