# 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). ## Enhanced card payment initiation use cases {#enhanced-card-payment-initiation-use-cases} For more information on how to implement linking between Buyers and Suppliers in the Buyer Payment Agent , see the [Enhanced card payment initiation](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/use_cases/commercial-direct-payments/enhanced-card-payment-initiation/index.md) section. | API | Request URI | Description | Regional availability | |----------------------|--------------------------------------------------------------------------------------|--------------------------------------------------------------------------------|-----------------------| | Create a new payment | **POST** //buyer-payment-agents/{ica}//payment-initiations | This endpoint allows submission of a Payment Initiation Request in ISO format. | Global | | Get payment details | **GET** /buyer-payment-agents/{ica}/payment-initiations/{instructionIndentification} | This endpoint allows enquiry of a submitted payment instruction. | Global | ## 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/business-payment-service/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/business-payment-service/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 **SCF** : United States **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/business-payment-service/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. | | ## Supply chain finance use case {#supply-chain-finance-use-case} To create a payment instruction for supply chain finance, see the [Supply chain finance](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/use_cases/business-payment-service/supply-chain-finance/index.md) section. | API | Request URI | Description | Regional availability | |------------------------------------------------------------|---------------------------------------------------------------------------|--------------------------------------------------------------------------------------|-----------------------| | Submit an A2A payment instruction for supply chain finance | **POST** /buyer-payment-agents/{ica}/payment-instructions | This endpoint allows you to submit a payment instruction for supply chain financing. | United States | | Update a supply chain finance payment instruction status | **PUT** /buyer-payment-agents/{ica}/payment-instructions/{transaction_id} | This endpoint allows you to update the supply chain finance payment status. | United States |