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

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