Skip to content
Search documentation/

Too many customers prompted

api_client_policy_prompt_reach_exceededHTTP 429Retry after a wait

What happened

This API client has sent payment prompts to as many different customers as its terms allow this hour. Nothing was sent to the customer's phone.

What to do next

Wait for Retry-After before prompting another customer, and send a payment link to customers who haven't asked to pay yet.

Can you retry?

Retry after a wait. Repeat the identical request after the Retry-After delay, or after a short wait when none is given, with the same Idempotency-Key and body. retry: after_delay

Who acts

You: the software that sent the request. who_acts: caller

Don't

  • Don't send the customer another payment prompt. send_another_prompt

Example response

Sent as application/problem+json. The detail describes the particular request; keep request_id for support.

{
  "type": "https://docs.perionpayments.com/problems/api-client-policy-prompt-reach-exceeded",
  "title": "Too many customers prompted",
  "status": 429,
  "code": "api_client_policy_prompt_reach_exceeded",
  "detail": "This API client has sent payment prompts to as many different customers as its terms allow this hour. Nothing was sent to the customer's phone.",
  "request_id": "req_8YkQ2rL0ZtW4",
  "retryable": true,
  "retry": "after_delay",
  "who_acts": "caller",
  "next_step": "Wait for Retry-After before prompting another customer, and send a payment link to customers who haven't asked to pay yet.",
  "do_not": [
    "send_another_prompt"
  ]
}

All problem codes · Reading problem responses