Webhook
Webhook Flow for MISPay
Please ensure compliance with the below steps for seamless integration.
Step 1: Webhook URL Submission
The merchant must provide the webhook URL to MISPay. Upon receiving the URL, MISPay will
configure it on our end.
Step 2: Transaction Response
MISPay will send a transaction response with a decrypted payload. Below is a sample JSON
response:
{
"checkoutId": "67d14251f0c7455f05ea92",
"orderId": "abc-123",
"code": “MP00",
"appId": "23e12f7a2c311ad6484eb34f65b53f017e687e"
}Step 3: Merchant Acknowledgment
Upon receiving the response, the merchant must respond with a status code of 200 to confirm
successful reception.
Step 4: Security Measures
- The merchant must whitelist MISPay's IP address: 34.166.80.250
- For security reasons, the response will be sent to the web-hook only once. No multipletriggers will occur in case of failure.
Step 5: Status Codes
| Code | Description |
|---|---|
| MP00 | Success |
| MP01 | Timeout |
| MP02 | Canceled |
| MP03 | Refunded |
In case it partial refund a flag will return as false{ "checkoutId": "67d14251f0c7455f05ea92", "orderId": "abc-123", "code": “MP03”, isFullyRefunded: false "appId": "23e12f7a2c311ad6484eb34f65b53f017e687e" }
In case it fully refund a flag will return as true{ "checkoutId": "67d14251f0c7455f05ea92", "orderId": "abc-123", "code": “MP03”, isFullyRefunded: true "appId": "23e12f7a2c311ad6484eb34f65b53f017e687e" }
Updated 11 months ago
