{
"id": "8f14e45f-ceea-4e7a-9f1d-6b1c2a3d4e5f",
"event": "POOL_DEPOSIT_REQUEST.REJECTED",
"createdAt": "2026-04-24T09:13:33.883Z",
"data": {
"transactionId": "69528240ba52c13b669fb239",
"reference": "pool-account-reference",
"amount": 5000,
"currency": "NGN",
"rejectionReason": "Sender name does not match the submitted proof",
"resubmissionRequired": true
}
}Pool Deposit Events
Afriex delivers a webhook to your configured URL when a pool account deposit you submitted is rejected during review.
Submitting proof through POST /api/v1/transaction/pool-account creates a transaction in IN_REVIEW. An operator then confirms or rejects the inflow: approval surfaces as TRANSACTION.CREATED, rejection surfaces here. This event cannot be fired from POST /api/v1/webhooks/trigger.
Security: Every request includes an x-webhook-signature header and an x-afriex-business-id header carrying your business id. You must verify this signature using Afriex’s public key before processing. The key is an elliptic-curve (secp384r1 / P-384) key, not RSA. The signature is ECDSA with SHA-256, DER-encoded and then base64-encoded, computed over the exact raw request body, so verify it before parsing or re-serialising the JSON. See the Webhooks Overview & Security section for verification instructions.
{
"id": "8f14e45f-ceea-4e7a-9f1d-6b1c2a3d4e5f",
"event": "POOL_DEPOSIT_REQUEST.REJECTED",
"createdAt": "2026-04-24T09:13:33.883Z",
"data": {
"transactionId": "69528240ba52c13b669fb239",
"reference": "pool-account-reference",
"amount": 5000,
"currency": "NGN",
"rejectionReason": "Sender name does not match the submitted proof",
"resubmissionRequired": true
}
}Event Types
POOL_DEPOSIT_REQUEST.REJECTED- A submitted pool account deposit was rejected during review
Sample Payload
Pool Deposit Rejected
{
"id": "3a9a4862-b1bc-59cd-ad8c-cac73f1b7f72",
"event": "POOL_DEPOSIT_REQUEST.REJECTED",
"createdAt": "2026-04-24T09:13:33.883Z",
"data": {
"transactionId": "69528240ba52c13b669fb239",
"reference": "pool-account-reference",
"amount": 5000,
"currency": "NGN",
"rejectionReason": "Sender name does not match the submitted proof",
"resubmissionRequired": true
}
}
rejectionReason is free text entered by the reviewer. Show it to your operator; do not branch on its contents. Branch on resubmissionRequired instead: true means you can correct the submission and send fresh proof, false means the rejection is final.
transactionId.Body
Unique ID of this event. Every delivery attempt of the same event carries the same id, so use it to ignore a delivery you have already processed.
"8f14e45f-ceea-4e7a-9f1d-6b1c2a3d4e5f"
Identifies which pool deposit event occurred
POOL_DEPOSIT_REQUEST.REJECTED "POOL_DEPOSIT_REQUEST.REJECTED"
When Afriex created the event. Retries keep this value, and the signature covers it, so you can reject a delivery that is older than you expect.
"2026-04-24T09:13:33.883Z"
Details of the rejected pool deposit. A flat, purpose-built shape rather than the full transaction object. Fetch the transaction with GET /api/v1/transaction/{transactionId} if you need the rest of it.
Show child attributes
Show child attributes
Response
Acknowledge receipt. Return any 2xx status code quickly. Response body is ignored.