Overview

DompetX sends webhook notifications to your configured URL when payment events occur. The webhook URL is provided by the client during transaction creation.

Payment Status Webhook

When a payment status changes, DompetX will send a POST request to your webhook URL with the following JSON payload:
{
  "data": {
    "id": "c2489739-0fbf-48aa-8255-44b6c5e13ace",
    "amount": 500,
    "status": "paid",
    "currency": "IDR",
    "reference": "order-100-2"
  },
  "eventType": "deposit",
  "paymentId": "c2489739-0fbf-48aa-8255-44b6c5e13ace"
}

Response Requirements

Your webhook endpoint should respond with HTTP 200 status code to acknowledge receipt. If DompetX does not receive a 200 response, it will retry the webhook delivery. Retry Policy:
  • Maximum retry attempts: 5
  • If all 5 retry attempts fail to receive a 200 response, DompetX will stop sending the webhook notification
  • It is recommended to implement proper error handling and logging on your webhook endpoint to avoid missing important payment notifications