# Retrieve A2A and card payment instruction
source: https://developer.mastercard.com/mastercard-supplier-payment-agent/documentation/tutorials-and-guides/retrieve-payment-tutorial/index.md

## Overview {#overview}

This optional endpoint returns details associated with the payment instruction you previously created using Business Payment Service. The response includes a value for the `status` of the payment instruction.
>
> #### What you will learn {#what-you-will-learn}
>
> * How to retrieve the status and details of a payment instruction.

## Before you start {#before-you-start}

Before starting this tutorial, ensure that you have already completed the following:

* Registered with Mastercard Track Business Payment Service
* Buyer Payment Agent initiated a [card](https://developer.mastercard.com/mastercard-supplier-payment-agent/documentation/tutorials-and-guides/card-tutorial/index.md) or [account to account (A2A)](https://developer.mastercard.com/mastercard-supplier-payment-agent/documentation/tutorials-and-guides/a2a-tutorial/index.md) payment instruction with you

## What you will achieve {#what-you-will-achieve}

By completing this tutorial you will successfully retrieve a payment instruction.

## Next steps {#next-steps}

Click **Next** to get started.

## 1. Send the retrieve payment instruction request. {#1-send-the-retrieve-payment-instruction-request}

Alert:
> The Mastercard assigned ICA is used for agent identification in all service requests for core operations. A customer service provider can use their API credentials to transact on behalf of a customer by providing their customer's ICA number in the request. Direct payment agents can still transact by entering their own ICA when sending a transaction to Mastercard Track Business Payment Service.

API Reference: `GET /supplier-payment-agents/{ica}/payment-instructions/{transaction_id}`

## 2. Review the possible error codes associated with the request. {#2-review-the-possible-error-codes-associated-with-the-request}

The below table lists the status codes you will receive as the payment is processed.

|       Status       |                                            Description                                            |                                                                                Usage                                                                                |
|--------------------|---------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| RECEIVED           | Payment instruction is received by Mastercard Track Business Payment Service.                     | This status is sent by Mastercard Track Business Payment Service in receipt of the payment instruction.                                                             |
| SUBMITTED          | Payment instruction is submitted to Supplier Payment Agent.                                       | Mastercard Track Business Payment Service sends this status to the Buyer Payment Agent when the payment instruction is sent to the Supplier Payment Agent.          |
| ACCEPTED           | Payment instruction is accepted (Supplier Controls) by Mastercard Track Business Payment Service. | Mastercard Track Business Payment Service sends this status to the Supplier Payment Agent when the payment instruction complies with the Supplier Payment Controls. |
| REJECTED           | Payment instruction is rejected (Supplier Controls) by Mastercard Track Business Payment Service. | The Supplier Payment Agent can reject the payment instruction with one of the reason codes below if any data validation error or failure occurs.                    |
| PENDING            | Payment instruction is pending payment.                                                           | Mastercard Track Business Payment Service sends this status to the Supplier Payment Agent after the account details are added.                                      |
| FUNDS_RECEIVED     | Payment instruction marked funds received by Supplier Payment Agent.                              | This status is updated by the Supplier Payment Agent when the funds have been received and reconciled by the Supplier Payment Agent.                                |
| FUNDS_NOT_RECEIVED | Payment instruction marked funds not received by Supplier Payment Agent.                          | This status is updated by the Supplier Payment Agent when the funds have not been received by the Supplier Payment Agent.                                           |

