# Retrieve A2A and card payment instruction source: https://developer.mastercard.com/mastercard-buyer-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 * Initiated a [card](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/tutorials-and-guides/card-tutorial/index.md) or [account to account (A2A)](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/tutorials-and-guides/a2a-tutorial/index.md) payment instruction ## 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 /buyer-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} You may receive the following statuses from Business Payment Service throughout the A2A payment instruction flow. | Status | Description | Usage | |--------------------|----------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------| | RECEIVED | Payment instruction is received by Track Business Payment Service. | This status is sent by Business Payment Service in receipt of the payment instruction. | | SUBMITTED | Payment instruction is submitted to Supplier Payment Agent. | 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 Track Business Payment Service. | 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 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. | 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. | If you receive the status update `FUNDS_NOT_RECEIVED`, you will also receive the following status reason code: | Status | Description | |------------------------------|-------------------------------------------------------| | SUPPLIER_NO_RECEIPT_OF_FUNDS | Contact the Supplier directly to obtain more details. |