All callback types include the following basic parameters, which provide fundamental context information and identification capabilities for the request.
requestUUID
string
required
Globally unique request identifierFunction:
  • Serves as the unique identifier for the request
  • Used for request tracking and log recording
tenantUserId
string
required
Merchant User IDImportant Note: tenantUserId refers to the user ID in the merchant’s system, not the merchant’s ID in the WaaS system.
trackingId
string
required
Persistent identifier for business events, trackingId is a permanent identifier created by the WaaS system for each business event (such as a withdrawal request), remaining unchanged throughout the entire lifecycle of the business event.Core Characteristics
  1. Business Event Anchor Uniquely identifies a business event (such as a withdrawal order), with all callbacks from creation to completion sharing the same trackingId
  2. Retry Identifier When a callback fails and needs to be retried: ✅ trackingId remains unchanged ❌ requestUUID will be updated to a new value
  3. Response Correlation Key Merchant must return unchanged in response, used by WaaS to confirm the specific business event to which the callback belongs
type
integer
required
Callback type identifierEnumeration Values:
ValueEnumeration Name
1NOTIFY_DEPOSITED
2NOTIFY_REQUEST_WITHDRAW
3NOTIFY_WITHDRAW
4NOTIFY_ADDRESS
5NOTIFY_INVALID_ADDRESS
6NOTIFY_NOT_ENOUGH_MONEY
7NOTIFY_NOT_ENOUGH_HOT_MONEY
View detailed callback type explanation →
business
int
required
Tenant type identifierCurrent Version Description: This field is a reserved parameter with no business logic function in the current version. It is reserved to support possible future expansion needs.Intended Use:
  • Distinguish processing logic for different business lines
  • Identify special rates or rule applications
  • Tenant identification in multi-tenant systems
Best Practice: Although currently without business logic function, it should still be preserved and recorded in request processing to avoid compatibility issues in future expansions.Example Value: 0