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

# Decline payment Action

## What does this Action do?

The "Decline payment" Action can be used for overriding the status of a payment to DECLINED. It enables you to define rules where you wish to decline a payment before its authorization.

![Workflow example](https://mintcdn.com/primer-cc826789/xLgoTOSuc1hi-Q-M/images/workflows/decline-payment/test-route.png?fit=max\&auto=format\&n=xLgoTOSuc1hi-Q-M\&q=85\&s=8f95e8bf41eaefb881fd56b9082221fe)

Workflow example

> [!WARNING]
>
> If the payment is not in the PENDING state, you will **not** be able to perform a decline.

## How to use the Action

* Assign a `payment ID` - this will usually be the "Payment ID" from the ["Payment created" Trigger](https://primer.io/docs/workflows/apps/native-apps/primer-payments-app/payment-created-trigger.md) output or ["Payment status updated" Trigger](https://primer.io/docs/workflows/apps/native-apps/primer-payments-app/payment-status-updated-trigger.md) output
* \[Optional] Set `reason`, which can be used for your own records

## Use cases

Based on your needs, you can utilize this Action in a few ways. Below are some examples for inspiration:

> [!TIP]
>
> Block payments for a specific BIN range by declining all payments for this set of cards

![Use Case 1](https://mintcdn.com/primer-cc826789/xLgoTOSuc1hi-Q-M/images/workflows/decline-payment/bin_block.png?fit=max\&auto=format\&n=xLgoTOSuc1hi-Q-M\&q=85\&s=f68091e2c095f55b01a70ddae19fddc3)

Use Case 1


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.