Webhook

MISpay Webhook is a secure, real-time notification mechanism that allows MISpay to automatically send transaction updates, payment statuses, and other event information to external systems or applications. This enables seamless integration and instant data synchronization between MISpay and third-party platforms.

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

{ 
 "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"
}