Webhooks allow you to receive real-time HTTP notifications when events occur in your OppiPayment account. Instead of polling the API for updates, OppiPayment will send a POST request to your configured URL.

Security

IP Whitelisting

To ensure that the webhook requests are coming from OppiPayment, you should only accept requests from the following IP address:
108.61.188.118

Webhook Events

OppiPayment sends notifications for the following events:

Request Created

Sent when a new deposit or withdrawal request is initialized. Payload Example:
{
  "type": "CREATED",
  "payload": {
    "transactionId": "7s8s0f7d-aus8-8724-8jk0-80as80a8s0a9"
  }
}

Deposit Completed

Sent when a deposit request is successfully completed. Payload Example:
{
  "type": "COMPLETED",
  "method": "Deposit",
  "payload": {
    "transactionId": "7s8s0f7d-aus8-8724-8jk0-80as80a8s0a9",
    "amount": "112",
    "sender": "TQ5D1S...fake_sender_address",
    "txId": "0x71c7656ec7ab88b098defb751b7401b5f6d8976f",
    "currency": "USDT",
    "orderId": "bf1610fa033a1ca607e8a23ac7378539"
  }
}

Withdrawal Success

Sent when a withdrawal request is successfully processed. Payload Example:
{
  "type": "SUCCESS",
  "method": "Withdraw",
  "payload": {
    "transactionId": "7s8s0f7d-aus8-8724-8jk0-80as80a8s0a9",
    "amount": "49",
    "receiver": "0xAb58...fake_receiver_address",
    "txId": "0x4a9b...fake_txid",
    "currency": "USDT",
    "orderId": "d9d32a970e4ae91b58314b4e71b92d801"
  }
}