For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Payment declined

The payment for this subscription charge was declined.

Example response
{
  "error": {
    "type": "request_error",
    "code": "subscription_payment_declined",
    "detail": "Payment declined.",
    "documentation_url": "https://developer.paddle.com/errors/subscriptions/subscription_payment_declined"
  },
  "meta": {
    "request_id": "00000000-0000-0000-0000-000000000000"
  }
}

Details

Status code
400
Error code
subscription_payment_declined
Error message
Payment declined.

Common causes

  • The customer's payment method declined the charge. This can be down to insufficient funds, an expired card, or the issuer blocking the payment.

Troubleshooting

  • Ask the customer to update their payment method, then retry.
  • Retry the payment later — declines are sometimes temporary.
See all errors

Was this page helpful?