Skip to main content

Agreement Notifications

CBTIS posts agreement lifecycle changes to the notify_url provided during agreement creation. The notification is sent when an agreement becomes active, fails, or is canceled.

{
"notify_type": "auto_debit_agreement_updated",
"data": {
"merchant_agreement_id": "merchant-agreement-001",
"merchant_customer_id": "customer_001",
"channel": "aplus",
"status": "ACTIVE",
"reason": "",
"exchange_code": "aec_L5yZ8Jwdsx3m5xjJV2rbqJ8cL4xYv-xzjxYiSoYgnNQ",
"exchange_code_expires_at": "2026-08-21T19:32:11+08:00",
"occurred_time": "2026-08-21T10:32:11+08:00"
}
}
FieldDescription
merchant_agreement_idThe agreement ID supplied when the agreement was created.
merchant_customer_idThe shopper identifier supplied when the agreement was created.
channelAgreement channel: aplus (Alipay Plus).
statusNew agreement status: ACTIVE, FAILED, or CANCELED.
reasonFailure or cancellation reason. Empty for ACTIVE.
exchange_codePresent only for ACTIVE. Exchange it for the agreement_token.
exchange_code_expires_atExpiry time of exchange_code.
occurred_timeTime at which the status changed.

​