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
CodeDescription
MP00Success
MP01Timeout
MP02Canceled
MP03Refunded
🚧

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