The merchant must implement an HTTP POST endpoint to receive asynchronous notifications related to the final status of a subscription process (whether successful or failed).
Once the subscription process is completed by the processor, Monnet will send a POST request to the webhook url provided by the merchant in the subscription creation request.
The merchant must be prepared to receive the following payload:
📦 Request Payload (JSON)
{
"subscriptionId": 6,
"chargeType": "ON_DEMAND",
"customerId": "006123061",
"originType": "MOBILE",
"statusDescription": "Subscription processing failed",
"statusCode": "9051",
"statusMessage": "Not sufficient funds"
}
Request
| Field | Description |
|---|---|
| subscriptionId | Integer Unique subscription identifier |
| chargeType | String Charge type (ON_DEMAND, RECURRING, etc.) |
| customerId | String Customer identifier associated with the subscription |
| originType | String Subscription source channel (WEB, MOBILE, etc.) |
| statusDescription | String Human-readable description of the processing result |
| statusCode | String Processing status code (e.g., 0000 = success, other = error) Ver Error Code |
| statusMessage | String Additional message complementary to the result |
✅ Expected Webhook Response
The webhook should return HTTP 200 OK to confirm successful receipt of the notification.
🔐 Recommended Security
It is recommended to implement authentication (e.g., token or IP whitelisting) to ensure the notification's legitimacy.
Errors Code
| Error Code | Error Message |
|---|---|
| 9003 | Invalid merchant |
| 9025 | Unable to locate record on file |
| 9034 | Suspected fraud |
| 9035 | Transaction not found |
| 9040 | Requested function not supported |
| 9051 | Not sufficient funds |
| 9052 | Non-existing current account |
| 9054 | Expired card |
| 9057 | Transaction not permitted to cardholder |
| 9061 | Effective advance is exceeded |
| 9062 | Restricted card |
| 9064 | Exceeds Withdrawal Limit |
| 9065 | Merchant has exceeded the number of daily transactions |
| 9097 | Operation Timeout |
| 9099 | Error |
| 9000 | Succeeded |