---
name: explain-a-declined-charge
description: "Find a declined charge and get a plain-English reason plus what to do next."
title: "Why was my card declined?"
url: https://agents.ramp.com/playbooks/explain-a-declined-charge
runtimes: [Claude Desktop, ChatGPT, Claude Code, Codex, Perplexity]
---

# Why was my card declined?

When a card charge fails, you need the why and the fix — not a generic decline code. Hand your agent the merchant, amount, or timing and it finds the declined transaction, explains what happened, and spells out remediation steps.

## How to run

Identify which runtime you're operating in (Claude Desktop, ChatGPT, Claude Code, Codex, Perplexity). Use the matching section below; ignore the others.

## Claude Desktop

Copy and run this prompt:

```
## Before you run
- Ramp connector enabled in Claude Desktop ([connector directory](https://claude.ai/directory/61bac03c-3f98-4b3c-affb-1b99533fa82c))

A Ramp card charge was declined and I need to understand why.

Merchant: [REPLACE — merchant name or description]
Approximate amount: [REPLACE — amount, if known]
When: [REPLACE — date or "most recent"]

Find my declined transaction that matches, then explain in plain English:
- Why it was declined
- What I can do next (including anything that needs an admin)
- The notification I would have received

If more than one declined charge matches, list them and ask me which to explain.
```

## ChatGPT

Copy and run this prompt:

```
## Before you run
- Ramp connector enabled in ChatGPT ([app](https://chatgpt.com/apps/ramp/asdk_app_69250fb6281c819195b52a1556b0060c))

A Ramp card charge was declined and I need to understand why.

Merchant: [REPLACE — merchant name or description]
Approximate amount: [REPLACE — amount, if known]
When: [REPLACE — date or "most recent"]

Find my declined transaction that matches, then explain in plain English:
- Why it was declined
- What I can do next (including anything that needs an admin)
- The notification I would have received

If more than one declined charge matches, list them and ask me which to explain.
```

## Claude Code

Copy and run this prompt:

```
## Before you run
- Ramp CLI installed: `curl -fsSL https://agents.ramp.com/install.sh | bash`
- Logged in: `ramp auth login`

A Ramp card charge was declined and I need to understand why.

Merchant: [REPLACE — merchant name or description]
Approximate amount: [REPLACE — amount, if known]
When: [REPLACE — date or "most recent"]

Find my declined transaction that matches, then explain in plain English:
- Why it was declined
- What I can do next (including anything that needs an admin)
- The notification I would have received

If more than one declined charge matches, list them and ask me which to explain.
```

## Codex

Copy and run this prompt:

```
## Before you run
- Ramp CLI installed: `curl -fsSL https://agents.ramp.com/install.sh | bash`
- Logged in: `ramp auth login`

A Ramp card charge was declined and I need to understand why.

Merchant: [REPLACE — merchant name or description]
Approximate amount: [REPLACE — amount, if known]
When: [REPLACE — date or "most recent"]

Find my declined transaction that matches, then explain in plain English:
- Why it was declined
- What I can do next (including anything that needs an admin)
- The notification I would have received

If more than one declined charge matches, list them and ask me which to explain.
```

## Perplexity

Copy and run this prompt:

```
## Before you run
- Ramp connector enabled in Perplexity ([connector](https://www.perplexity.ai/computer/connectors?connector=ramp))

A Ramp card charge was declined and I need to understand why.

Merchant: [REPLACE — merchant name or description]
Approximate amount: [REPLACE — amount, if known]
When: [REPLACE — date or "most recent"]

Find my declined transaction that matches, then explain in plain English:
- Why it was declined
- What I can do next (including anything that needs an admin)
- The notification I would have received

If more than one declined charge matches, list them and ask me which to explain.
```