# 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. |