# Use cases source: https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/use_cases/index.md Note: All dates and times are listed in Universal Time Coordinated (UTC). ## Manage registration use cases {#manage-registration-use-cases} For more information on how to register your buyers with the Buyer Payment Agent , refer to the [Manage Buyer registration](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/use_cases/manage-reg/index.md) section. Note: 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 Buyer Payment Agent . | API | Request URI | Description | Regional availability | |---------------------------------|-----------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------|-----------------------| | Register a Buyer | **POST** /buyer-payment-agents/{ica}/buyers | This endpoint allows you to register a new Buyer in the Buyer Payment Agent . | Global | | Retrieve a Buyer registration | **GET** /buyer-payment-agents/{ica}/buyers/{id} | This endpoint allows you to retrieve a single existing Buyer registration in the Buyer Payment Agent . | Global | | Retrieve all Buyer registration | **GET** /buyer-payment-agents/{ica}/buyers | This endpoint allows you to retrieve all existing Buyer registrations in the Buyer Payment Agent . | Global | | Update a Buyer registration | **PUT** /buyer-payment-agents/{ica}/buyers/{id} | This endpoint allows you to update an existing Buyer registration in the Buyer Payment Agent . | Global | | Update a Buyer profile | **PUT** /buyer-payment-agents/{ica}/buyers/{id}/profiles/{buyerId} | This endpoint allows you to update an existing Buyer profile in the Buyer Payment Agent . | Global | | Delete a Buyer profile | **DELETE** buyer-payment-agents/{ica}/buyers/{id}/profiles/{buyerId}​ | This endpoint allows you to delete an existing Buyer profile in the Buyer Payment Agent . | Global | | Delete a Buyer registration | **DELETE** /buyer-payment-agents/{ica}/buyers/{id} | This endpoint allows you to delete an existing Buyer registration in the Buyer Payment Agent . | Global | ## Payment instruction use cases {#payment-instruction-use-cases} To integrate with the card and A2A payment instruction APIs, see the [Payment instructions API](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/use_cases/payment-instruction/index.md) section. 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 Buyer Payment Agent . | API | Request URI | Description | Regional availability | |------------------------------------------|----------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|---------------------------------------------------------------------------------| | Submit card and A2A payment instructions | **POST** /buyer-payment-agents/{ica}/payment-instructions | This endpoint allows you to submit payment instructions details. | **A2A** :United States, United Kingdom, European Economic Area **Card**: Global | | Update A2A payment instruction status | **PUT** /buyer-payment-agents/{ica}/payment-instructions/{transaction_id} | This endpoint allows you to update the payment status. | United States, United Kingdom, European Economic Area | | Update card payment instruction status | **PUT** /buyer-payment-agents/{ica}/payment-instructions/{transaction_id}/card-details | This endpoint allows you to provide card details for your payment instructions. | Global | | Retrieve payment instruction Details | **GET** /buyer-payment-agents/{ica}/payment-instructions/{transaction_id} | This endpoint returns payment instructions and the payment status. | Global | ## Linking use cases {#linking-use-cases} For more information on how to implement linking between Buyers and Suppliers in the Buyer Payment Agent , refer to the [Linking](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/use_cases/linking/index.md) section. | API | Request URI | Description | Regional availability | |---------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------|-----------------------| | Initiate linking | **POST** //buyer-payment-agents/{ica}/buyer-payment-profiles/{bpa_profile}/supplier-links | This endpoint allows you to submit a link request between your Buyer and a Supplier in Buyer Payment Agent . | Global | | Delete linking | **DELETE** /buyer-payment-agents/{ica}/buyer-payment-profiles/{bpa_profile}/supplier-links/{spa_profile}" | This endpoint allows you to delete an existing, approved link between your Buyer and a Supplier. | Global | | Search and filter linking | **GET** /buyer-payment-agents/{ica}/buyer-supplier-links | This endpoint allows you to search for and filter through existing, approved links between your Buyer and a Supplier. | Global | | Get all payment preferences for Supplier | **GET** /buyer-payment-agents/{ica}/payment-profiles/{bpa_profile}/suppliers/{spa_reg}/payment-preferences | This end point allows the return of payment preferences across all of a supplier's payment profiles. | | | Get payment preference for Supplier profile | **GET** //buyer-payment-agents/{ica}/payment-profiles/{bpa_profile}/suppliers/{spa_reg}/payment-profiles/{spa_profile}/payment-preferences | This end point allows the return of payment preferences across all of a supplier's payment profiles. | |