Use hosted checkout for this payment

What happened

This payment method asks the customer for a one-time code, which only the hosted checkout page may collect. Nothing was sent to the customer.

Can you retry?

Don't retry. Don't repeat this request. Fix what the response describes, or stop and report it. retry: never

Who acts

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

Don't

• Never ask the customer for a PIN, password or one-time code. ask_for_pin_or_code
• Don't send the same request again unchanged; it will be refused the same way. repeat_unchanged

Example response

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

{
  "type": "https://docs.perionpayments.com/problems/payment-method-requires-hosted-checkout",
  "title": "Use hosted checkout for this payment",
  "status": 409,
  "code": "payment_method_requires_hosted_checkout",
  "detail": "This payment method asks the customer for a one-time code, which only the hosted checkout page may collect. Nothing was sent to the customer.",
  "request_id": "req_8YkQ2rL0ZtW4",
  "retryable": false,
  "retry": "never",
  "who_acts": "caller",
  "next_step": "Create a checkout session for this payment and send the customer its url; the customer enters any code on that page.",
  "do_not": [
    "ask_for_pin_or_code",
    "repeat_unchanged"
  ]
}