Skip to main content

​
Event Overview

Event Type: PAYMENT_DETAILS_MISSING
Category: Payment
Description: Payment was recorded but one or more order fields required for payment verification are missing. This webhook notifies you which fields that are missing for payment verification so you can supply them via the Partner API (order update or upload-verification-details) or dashboard. It is used for any payment with missing verification details, including VBA transfer and regular payment success flows.

​
When the webhook is sent

The webhook is sent only when all of the following are true:
  1. Merchant has webhook URL – Your merchant account (or parent, for sub-merchants) has an active API credential with a non-empty webhook URL.
  2. At least one detail is missing – The payment’s order is missing one or more verification fields (see details_missing below). If all six fields are present on the order, the webhook is not sent.

​
Delivery Details

​
Headers

Signature verification (recommended):
Compute HMAC-SHA256(encryption_key, raw_body) where raw_body is the exact UTF-8 request body as received. Compare the hex result with the X-Webhook-Signature header to ensure the webhook is from the platform and unchanged.

​
Payload Schema

​
Field Specifications

​
string
required
Always "PAYMENT_DETAILS_MISSING" for this webhook event
​
string
required
ISO 8601 datetime when the webhook event was createdExample: "2025-02-12T10:30:00.123456Z"
​
string
required
Envelope version (e.g. “3.0.0”)
​
string
required
Unique identifier for this webhook event (UUID), useful for idempotencyExample: "550e8400-e29b-41d4-a716-446655440000"
​
object
required
Event payload: order_uid, payment_id, message, details_missing

​
details_missing field names

Each element in details_missing is a field name that may be missing on the order. Supply the missing fields by updating the order (Partner API or dashboard) or by calling the upload-verification-details endpoint for that payment. The following field names may appear: The webhook is sent only when at least one of these fields is missing (empty or not set) on the order.

​
What to Do When You Receive This Webhook

  1. Respond with HTTP 2xx (e.g. 200 OK) as soon as you have accepted the payload, so the platform marks the delivery as successful and does not retry.
  2. Verify the signature using your API key and the raw request body (HMAC-SHA256, hex) to ensure authenticity.
  3. Use order_uid and payment_id to fetch full order/payment details from the Partner API if needed (e.g. amount, status).
  4. Supply missing verification details by updating the order with the missing fields (via the Partner API or dashboard) or by calling the Upload Payment Verification Details endpoint for that payment. The details_missing array lists the field names that are missing (e.g. buyer_name, product_description, invoice_number, buyer_address, buyer_postal_code, hs_code).