{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"type": "identity.documents_denied",
"source": "com.paxos",
"time": "2025-01-07T14:30:02Z",
"object": "event",
"is_test": false
}Hooks
identity.documents_denied
Webhook triggered when an Enhanced Due Diligence review is denied
WEBHOOK
identity.documents_denied
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"type": "identity.documents_denied",
"source": "com.paxos",
"time": "2025-01-07T14:30:02Z",
"object": "event",
"is_test": false
}Triggered when an Enhanced Due Diligence (EDD) review reaches an outcome and the submitted documents are denied.
A review may instead be closed with no
identity.documents_accepted or identity.documents_denied event. Do not treat this event as a guaranteed terminator — if you do not receive one within the expected review window, reconcile by checking the identity’s status and outstanding requirements. A separate overall identity-status event also fires, but which one depends on the identity’s state: identity.denied if the denial occurs during onboarding (the identity was never approved), or identity.disabled if a previously approved identity is disabled as a result.Webhook payloads contain only event metadata. Use the Get Event API with the event ID to retrieve full details.
Paxos delivers webhooks with at-least-once semantics and retries failed deliveries with exponential backoff for up to 24 hours, so your consumer must be idempotent. See Retries and Limits for the full retry policy and rate limits.
Event Object Structure
The Get Event API returns anidentity_edd object for the concluded EDD review.Body
application/json
Webhook payload containing event metadata. Use the event ID with the Get Event API to retrieve full details.
The webhook payload structure sent to your endpoint
The event identifier used to query the Events API for full details
The type of event that occurred
Available options:
identity.documents_required, identity.documents_accepted, identity.documents_denied, identity.approved, identity.denied, identity.disabled, identity.kyc_refresh.started, identity.kyc_refresh.completed, identity.kyc_refresh.expired, identity.control.created, identity.control.deleted, orchestration.pending, orchestration.processing, orchestration.completed, orchestration.failed, orchestration.rejected, orchestration.status_details.pending_customer_approval, orchestration.status_details.conversion_in_progress, orchestration.status_details.destination_transfer_in_progress, orchestration.status_details.conversion_failed, orchestration.status_details.destination_transfer_failed, orchestration.status_details.policy_rejected, transfer.crypto_deposit.pending, transfer.crypto_deposit.completed, transfer.crypto_deposit.failed, transfer.crypto_withdrawal.pending, transfer.crypto_withdrawal.completed, transfer.crypto_withdrawal.failed, transfer.act_deposit.pending, transfer.act_deposit.completed, transfer.act_deposit.failed, transfer.act_withdrawal.pending, transfer.act_withdrawal.completed, transfer.act_withdrawal.failed, transfer.wire_deposit.pending, transfer.wire_deposit.completed, transfer.wire_deposit.failed, transfer.wire_withdrawal.pending, transfer.wire_withdrawal.completed, transfer.wire_withdrawal.failed, transfer.cubix_deposit.pending, transfer.cubix_deposit.completed, transfer.cubix_deposit.failed, transfer.cubix_withdrawal.pending, transfer.cubix_withdrawal.completed, transfer.cubix_withdrawal.failed, transfer.scb_intrabank_deposit.pending, transfer.scb_intrabank_deposit.completed, transfer.scb_intrabank_deposit.failed, transfer.scb_intrabank_withdrawal.pending, transfer.scb_intrabank_withdrawal.completed, transfer.scb_intrabank_withdrawal.failed, transfer.banking_circle_intrabank_deposit.pending, transfer.banking_circle_intrabank_deposit.completed, transfer.banking_circle_intrabank_deposit.failed, transfer.banking_circle_intrabank_withdrawal.pending, transfer.banking_circle_intrabank_withdrawal.completed, transfer.banking_circle_intrabank_withdrawal.failed, transfer.bny_intrabank_deposit.pending, transfer.bny_intrabank_deposit.completed, transfer.bny_intrabank_deposit.failed, transfer.bny_intrabank_withdrawal.pending, transfer.bny_intrabank_withdrawal.completed, transfer.bny_intrabank_withdrawal.failed, transfer.rtp_deposit.pending, transfer.rtp_deposit.completed, transfer.rtp_deposit.failed, transfer.internal_transfer_debit.completed, transfer.internal_transfer_credit.completed Always 'com.paxos'
Available options:
com.paxos When the event occurred, RFC3339 format
Always 'event'
Available options:
event Whether the event was a test event. Test events are only sent via the Test feature in Dashboard.
Response
200
Webhook successfully received
Was this page helpful?