Upload a Proof of Payment for a referral
POST/referrals/:referralId/proof-of-payment
Agent-side upload. The client pays the insurer directly and shares the POP with the agent. Uploading a POP against a client_accepted referral automatically transitions the referral to premium_payment_pending. The POP itself lands as pending_zfa_review until ZFA staff verifies it.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 429
- 500
ProofOfPayment created with status pending_zfa_review.
Amount / reference / document invalid.
Missing or invalid access token.
Referral is not owned by the caller, or the document belongs to another user.
Referral or document not found.
Referral not in a state that accepts POPs.
Rate limit exceeded. Global default is 120 requests/minute per IP; auth-flow, OTP, self-registration, WebAuthn, IRA lookup, and public-lead endpoints carry tighter per-endpoint limits. Retry after the delay indicated by the Retry-After header.
Response Headers
Seconds to wait before retrying.
Unhandled server error. The response carries a meta.requestId correlator you can hand to platform operations to trace the failure through structured logs and the hash-chained audit trail. Retry with the same Idempotency-Key header if the endpoint accepts idempotency.