Apply Collection Account Result Notification
Notifies the partner when a collection account application is reviewed and provides the latest application status and created account identifiers.
Delivery overview
Submit an application through Apply Collection Account.
Pagsmile reviews the application and sends an HTTP
POSTrequest to your configured webhook URL.Process the notification idempotently and return an HTTP
2xxstatus code to acknowledge successful receipt.If reconciliation is required, retrieve the latest result through Query Apply Collection Account Result.
Request
Method: POST
Content-Type: application/json
URL: Your configured webhook endpoint
The request uses the standard Webhook Common envelope.
Webhook envelope
partner_id
string
No
Pagsmile-assigned unique identifier of the partner.
timestamp
string
Yes
Date and time when the notification was generated.
Format: yyyy-MM-dd HH:mm:ss.
version
string
Yes
Remittance API webhook protocol version.
Fixed value: 1.0.
random_key
string
No
Reserved field.
sign_type
string
No
Reserved field. When empty, no encryption is required.
request_id
string
Yes
Globally unique identifier used to trace the notification and support idempotent processing.
notify_type
integer
Yes
Notification type. Fixed value: 100 for an apply-VA result notification.
biz_data
object
Yes
Collection account application result. See the schema below.
biz_data schema
merchant_id
long
Yes
Pagsmile-assigned unique identifier of the merchant associated with the notification.
apply_no
string
Yes
Merchant-defined application number used to identify and reconcile the collection account application.
account_label
string
No
Partner-defined label used to identify the collection account.
business_type
integer
Yes
Business category that determines the applicable compliance and processing rules.
Supported values:
10 — Goods trade
11 — Service trade
20 — Platform
21 — Independent platform
collection_account_ids
array<long>
No
List of Pagsmile-assigned unique identifiers of collection accounts created for the application.
currency
string
Yes
Three-letter ISO 4217 code of the currency in which the collection account values are denominated.
created_at
string
Yes
Date and time when the collection account application was created.
Format: yyyy-MM-dd HH:mm:ss.
comments
string
No
Review comments or reason for rejection or failure, when provided.
Status values
11
VA Reviewing
The virtual account application is still under review.
12
VA Rejected
The virtual account application was rejected. Check comments for additional context when available.
13
VA Success
The virtual account application succeeded. collection_account_ids may contain the created account IDs.
14
VA Blocked
The virtual account application is blocked.
Request example
Acknowledgement
Return any HTTP status code from 200 through 299 after the notification has been accepted and recorded successfully. The webhook contract does not require a response body.
Return a 2xx response only after the notification is safely recorded. Any other status code is treated as a failed delivery and triggers the retry schedule below.
Retry policy
When delivery does not receive a 2xx response, Pagsmile retries the notification up to seven times using the following delays:
1
10 seconds
2
1 minute
3
5 minutes
4
30 minutes
5
2 hours
6
6 hours
7
24 hours
Implementation recommendations
Deduplicate notifications by
request_id. A retried notification must not create duplicate business actions.Use
merchant_idandapply_noto locate the original application.Record the payload before starting downstream processing, then return
2xxas soon as it is safely persisted.Return
2xxfor a notification that has already been processed successfully.Reconcile uncertain or missed results through Query Apply Collection Account Result.
Follow Webhook Common for the shared envelope and security-related fields.
Related references
Last updated
Was this helpful?