post
https://ramp.wello.tech/bridger-api/eapi/ocbs/merchant/v1/merchant-webhook-endpoint
⚠️ THIS ENDPOINT IS IMPLEMENTED BY THE MERCHANT, NOT WELLO
This documents the webhook notifications that Wello sends to your configured webhook URL. You need to implement this endpoint on your server to receive order status and KYC status updates.
Overview
This API allows Wello to send webhook notifications to the merchant's system when a user's KYC (Know Your Customer) status or order status changes. The notification is sent via HTTP POST to the merchant's provided webhook URL.
Request Information
- HTTP Method: POST
- Request URL: Provided by the merchant (e.g., https://merchant.com/api/webhook)
- Content-Type: application/json
Purpose
Wello uses this webhook to notify you about:
- KYC Status Changes: KYC_INIT, KYC_PASS, KYC_FAILED
- Order Status Updates: ORDER_EXPIRED, PENDING_DEPOSIT, PENDING_WITHDRAW, SUCCESS
Security
Always validate the webhook signature before processing to ensure the request is from Wello.
Retry Policy
| Item | Description |
|---|---|
| Initial Send | Triggered immediately when status changes |
| Retry Interval | Every 1 minute if your endpoint returns non-200 status |
| Max Retries | Up to 10 attempts |
| After Max Retries | No further attempts; failure is logged by Wello |
Your Implementation Requirements
- Respond with HTTP 200 status code to acknowledge receipt
- Validate the signature (Version 1.1 HMAC or Version 1.0 RSA)
- Process webhooks idempotently (same notification may be sent multiple times)
- Handle all supported order and KYC statuses