> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flynet.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel a Payment Intent

Cancels a `pending` intent. Re-canceling a canceled intent returns the
same intent without side effects. Paid or refunded intents cannot be
canceled.

Auth: OAuth access token.

## Example

```bash theme={null}
curl -X POST https://api.staging.blackbird.xyz/flynet/v1/payment_intents/{uuid}/cancel \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

## Response

```json theme={null}
{
  "id": "{uuid}",
  "object": "payment_intent",
  "status": "canceled",
  "canceled_at": "2026-05-11T20:02:00Z",
  "amount": { "value": "1000000000000000000", "currency": "FLY" }
}
```

## Errors

| Code                    | Meaning                                      |
| ----------------------- | -------------------------------------------- |
| 400 `paymentIntent0003` | Intent is not in a cancelable state.         |
| 401                     | Missing or invalid OAuth bearer. Empty body. |