Skip to content
Search documentation/

Too many prompts for this payer

payer_prompt_limit_reachedHTTP 429Retry after a wait

What happened

This phone number already has the most payment prompts allowed from this merchant, waiting or in the last hour. Nothing was sent to the phone.

What to do next

Wait for Retry-After and for the customer to answer the prompts already on their phone, then repeat the same request.

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

The customer who is paying. who_acts: payer

Don't

  • Don't send the customer another payment prompt. send_another_prompt
  • Don't start another payment for the same order. create_another_payment

Example response

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

{
  "type": "https://docs.perionpayments.com/problems/payer-prompt-limit-reached",
  "title": "Too many prompts for this payer",
  "status": 429,
  "code": "payer_prompt_limit_reached",
  "detail": "This phone number already has the most payment prompts allowed from this merchant, waiting or in the last hour. Nothing was sent to the phone.",
  "request_id": "req_8YkQ2rL0ZtW4",
  "retryable": true,
  "retry": "after_delay",
  "who_acts": "payer",
  "next_step": "Wait for Retry-After and for the customer to answer the prompts already on their phone, then repeat the same request.",
  "do_not": [
    "send_another_prompt",
    "create_another_payment"
  ]
}

All problem codes · Reading problem responses