Webhook

The notification address is the callbackUrl configured in the unified merchant platform. If YUNMO is not specified, no notifications will be sent. For asynchronous notification interfaces, merchants must verify the signature to ensure transaction security.

1.Interface Specification

Merchants must respond with “OK” when receiving YUNMO result notifications. If a merchant fails to return “OK” YUNMO will continue sending notifications, up to a total of 10 times.

Note: To avoid ambiguity in parameter verification, all fields in the notification parameters are of type String. For example, the amount should be specified as “20.00”. When verifying the signature, use “20.00” for verification, not 20.

Request Method：POST

Request Type：application/json

2.Notification Parameters

param	required	type	description
merchantNo	Y	String	Assigned merchant ID
requestTime	Y	Long	Response Timestamp
version	Y	String	Interface Version
nonce	Y	String	16-character random string
sign	Y	String	Signature
eventType	Y	String	Event Type
eventName	Y	String	Event Name
data	Y	Object	Callback parameter details. For specific details, refer to the corresponding callback documentation.

通知示例

{
	"sign": "6bf642b5fc7b10a6eae3b8ab5e7bbea2",
	"nonce": "TW4P54uVulwRoc2y",
	"merchantNo": "BU078255558",
	"requestTime": 1770712296681,
	"eventType": "KYC",
	"eventName": "kyc_status",
	"version": "v1.0",
	"data": {
		"customerId": "test001",
		"auditState": 2,
		"auditRemark": "Biometric verification failed"
	}
}

6.1 Notification Specification

Webhook#

1.Interface Specification#

2.Notification Parameters#

Webhook

1.Interface Specification

2.Notification Parameters