# Transfer Status
source: https://developer.mastercard.com/mastercard-send-person-to-person/documentation/response-error-codes/status/index.md

Processed payment transfer requests will have a `transfer.status` response value that indicates whether the Payment Transaction was successful. This table shows the possible values for POST and GET calls.

|  Status   | POST response | GET response |                                                                                                                                                                   Meaning                                                                                                                                                                    |
|-----------|---------------|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| APPROVED  | Yes           | Yes          | The transaction was successful and has been approved.                                                                                                                                                                                                                                                                                        |
| DECLINED  | Yes\*         | Yes          | The transaction has been declined, either by the Receiving Institution or Mastercard.                                                                                                                                                                                                                                                        |
| UNKNOWN   | Yes           | Yes          | The request has been accepted but processing has not completed within the allotted timeframe, possibly due to timeouts or network communication issues. See ['UNKNOWN' or 'PENDING' Status](https://developer.mastercard.com/mastercard-send-person-to-person/documentation/response-error-codes/status/index.md#unknown-or-pending-status). |
| ERROR     | ---           | Yes          | Can be returned when a network or system error prevented processing of the transaction. This status is rarely seen in production.                                                                                                                                                                                                            |
| REVERSED  | ---           | Yes          | The transaction has been reversed. This is unlikely to occur. Mastercard Send Payment Transactions are generally irrevocable and can only be reversed in exceptional circumstances.                                                                                                                                                          |
| PENDING   | Yes           | Yes          | The transaction is still in progress. See ['UNKNOWN' or 'PENDING' Status](https://developer.mastercard.com/mastercard-send-person-to-person/documentation/response-error-codes/status/index.md#unknown-or-pending-status).                                                                                                                   |
| CANCELLED | Yes\*\*       | Yes\*\*      | The non-card transaction has been cancelled.                                                                                                                                                                                                                                                                                                 |

*\* Possible if the API request `decline_details` query parameter was set to 'true'. Otherwise, a decline is returned as a 402 error response.
\*\* Possible for non-card transactions only, such as payment transfers to bank accounts.*

Payment transfer requests that fail API validation are unlikely to create a transaction record in Mastercard Send, will not have a status, and cannot be found using a GET request.

The status fields in the `transaction_history` object relate to values passed back from the Receiving Institution and network, and those values can provide additional detail. However, to determine whether a Payment Transaction is successful, use the main `status` response field (`transfer.status`).

## 'UNKNOWN' or 'PENDING' Status {#unknown-or-pending-status}

Most valid API transaction requests are processed and approved or declined within two seconds. As Mastercard Send connects to downstream networks, occasional network issues or timeouts may delay API responses or delay Mastercard Send getting the final status of a transaction, causing it to have an 'UNKNOWN' or 'PENDING' status. In such situations, Mastercard Send continually attempts to determine the final status with the network and Receiving Institution (RI). The latest status will be reflected in subsequent [Payment Transfer API](https://developer.mastercard.com/mastercard-send-person-to-person/documentation/api-reference/payment-transfer/index.md) GET responses.

Follow the guidance in [Procedure When Transaction Status 'UNKNOWN' or 'PENDING'](https://developer.mastercard.com/mastercard-send-person-to-person/documentation/tutorials-and-guides/exception-management/index.md#procedure-when-transaction-status-unknown-or-pending). Do not resubmit a transaction request that has an 'UNKNOWN' or 'PENDING' status, because the original transaction may have been processed successfully.

When making API calls, you are likely to see:

* Within 1 minute of the original POST response = Most transactions will be approved or declined.

* 1 -- 30 minutes = Diminishing number of transactions in 'UNKNOWN' or 'PENDING' status.

* After 30 minutes = It is possible some transactions may remain in an 'UNKNOWN' or 'PENDING' status. For example, it can take up to 24 hours to retrieve the status from other networks for payments to non-Mastercard accounts. Make a GET call 2 hours after the original POST request. If the status hasn't changed:

  * Use the Transaction Research tool and/or the Mastercard Send daily reconciliation reports (after 24 hours) to check for the final status, see [Tools and Resources](https://developer.mastercard.com/mastercard-send-person-to-person/documentation/tutorials-and-guides/exception-management/index.md#tools-and-resources).
  * Transactions in UNKNOWN/PENDING status can be considered "potentially approved" and communicated to consumers as such. However, there is still a chance the transaction might be declined or reversed.

**NOTE:** These timings are approximate.