# Managing Buyer Registration
source: https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/tutorials-and-guides/registration-tutorial/index.md
## Overview {#overview}
Buyer Payment Agents can manage their Buyers and payment profiles in Business Payment Service.
>
> #### What you will learn {#what-you-will-learn}
>
> * How to register a Buyer in Business Payment Service
> * How to update a Buyer's registration
> * How to update a Buyer's payment profile
> * How to delete a Buyer's payment profile
> * How to delete a Buyer
> * How to optionally retrieve a Buyer's registration
## What you will achieve {#what-you-will-achieve}
By completing this tutorial you will successfully register a Buyer in Business Payment Service and manage a Buyer's registration.
## Next steps {#next-steps}
Click **Next** to get started.
## Register a Buyer {#register-a-buyer}
As a Buyer Payment Agent you can register your Buyers through the Business Payment Service registration endpoint. You can leverage this endpoint to register a Buyer and create their payment profile at the same time. A Buyer payment profile details the billing and payment method information for a Buyer.
Complete these steps to register a Buyer and create their payment profile in Business Payment Service.
### 1. Create the Buyer registration request using the POST registration endpoint. {#1-create-the-buyer-registration-request-using-the-post-registration-endpoint}
API Reference: `POST /buyer-payment-agents/{ica}/buyers`
Note: With the February 2022 release, agents can reuse previously deleted Buyer IDs.
You will need the Buyer ID you created for the Buyer to complete other registration activities.
### 2. Review the possible error codes associated with this request. {#2-review-the-possible-error-codes-associated-with-this-request}
If a Buyer registration request is incorrect or invalid, the registration is not created. If the failure is due to invalid or missing information, you may receive one of the following error reason codes.
| Reason Code | Description |
|---------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| BUYER_ID_EXISTS | Enter a different Buyer ID, already exists. |
| INVALID_BUYER_ID_FORMAT | Enter Buyer ID in the format \[Buyer\].pay@track or \[Buyer\].\[branch\].pay@track |
| NO_BUYER_ID | Enter Buyer ID in the format \[Buyer\].pay@track or \[Buyer\].\[branch\].pay@track |
| INVALID_LEGAL_BUSINESS_NAME INVALID_DBA_NAME NO_LEGAL_BUSINESS_NAME | Enter a Name with 240 characters or less. |
| INVALID_LEGAL_ADDRESS_LINE_1 INVALID_BILL_TO_ADDRESS_LINE_1 | Enter Address Line1 with 70 characters or less. |
| INVALID_LEGAL_ADDRESS_LINE_2 INVALID_BILL_TO_ADDRESS_LINE_2 | Enter Address Line2 with 70 characters or less. |
| INVALID_LEGAL_ADDRESS_LINE_3 INVALID_BILL_TO_ADDRESS_LINE_3 | Enter Address Line3 with 70 characters or less. |
| INVALID_LEGAL_ADDRESS_TOWN_NAME INVALID_BILL_TO_ADDRESS_TOWN_NAME | Enter a Town Name with 70 characters or less. |
| INVALID_LEGAL_ADDRESS_COUNTRY_SUBDIVISION INVALID_BILL_TO_ADDRESS_COUNTRY_SUBDIVISION | Enter a Country SubDivision with 35 characters or less. |
| INVALID_LEGAL_ADDRESS_POSTCODE INVALID_BILL_TO_ADDRESS_POSTCODE | **NAM** US: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. Canada: Enter a valid Post Code with 5 to 8 characters. Spaces or hyphens are allowed. **EUR** UK: Enter a valid Post Code with 6 to 8 characters . Spaces or hyphens are allowed. **LAC** Curacao(optional): Enter a valid Post Code up with 10 characters or less. Spaces or hyphens are allowed. Colombia: Enter a valid Post Code with 7 digits. Spaces or hyphens are allowed. Brazil: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. **Other** All other countries: (optional): Enter a valid Post Code with 10 characters or less. Spaces or hyphens are allowed. |
| INVALID_LEGAL_ADDRESS_COUNTRY INVALID_BILL_TO_ADDRESS_COUNTRY | Enter country code in two-letter code format. |
| INVALID_ORGANISATION_ID_TYPE | Enter a valid Organisation Identification Type. |
| NO_TAX_ID | Enter a Tax ID for an Organisation. |
| PAYMENT_PROFILE_LIMIT_EXCEEDED | Remove one or more profiles. The total number of profiles associated with a Buyer cannot exceed 20. |
| NO_PAYMENT_METHOD | Enter one or more payment methods supported by the Buyer and agent. Valid values are CARD, ACH, RTP, and TRF. |
| NO_LOCAL_INSTRUMENT | Enter one or more local instrument for the payment method TRF. |
| BUSINESS_EXISTS | This business already exists for this agent. |
| INVALID_PAYMENT_METHOD | Enter one or more valid payment methods supported by the Buyer and agent. Valid values are CARD, ACH, RTP, and TRF. |
| INVALID_LOCAL_INSTRUMENT | Enter one or more valid local instruments for the payment method TRF. |
| UNSUPPORTED_PAYMENT_METHOD | Enter a payment method or local instrument supported by both agent and Buyer. |
| INVALID_INACTIVE_REASON | Enter a valid inactive reason. Valid values are PRE_REGISTERED and AGENT_HOLD. |
| NO_INACTIVE_REASON | Enter an inactive reason. Valid values are PRE_REGISTERED or AGENT_HOLD. |
| INVALID_TAX_ID | **NAM** US: Enter a valid Tax ID with 9 digits. Canada: Enter a valid Tax ID with 9 digits. **EUR** UK: Enter a valid Tax ID with 10 digits. **LAC** Curacao: Enter a valid Tax ID with 9 digits. Colombia: Enter a valid Tax ID with 9 or 10 digits. Brazil: Enter a valid Tax ID with 14 digits. **Other** All other countries: (optional): Enter a valid Tax ID with 15 digits. |
| NO_LEGAL_ADDRESS_LINE_1 NO_BILL_TO_ADDRESS_LINE_1 | Enter Address Line1 with 70 characters or less. |
| NO_LEGAL_ADDRESS_TOWN_NAME NO_BILL_TO_ADDRESS_TOWN_NAME | Enter a Town Name with 50 characters or less. |
| NO_LEGAL_ADDRESS_COUNTRY_SUBDIVISION NO_BILL_TO_ADDRESS_COUNTRY_SUBDIVISION | Enter a Country SubDivision with 35 characters or less. |
| NO_LEGAL_ADDRESS_POSTCODE NO_PAY_TO_ADDRESS_POSTCODE | **NAM** US: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. Canada: Enter a valid Post Code with 5 to 8 characters. Spaces or hyphens are allowed. **EUR** UK: Enter a valid Post Code with 6 to 8 characters . Spaces or hyphens are allowed. **LAC** Curacao(optional): Enter a valid Post Code up with 10 characters or less. Spaces or hyphens are allowed. Colombia: Enter a valid Post Code with 7 digits. Spaces or hyphens are allowed. Brazil: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. **Other** All other countries: (optional): Enter a valid Post Code with 10 characters or less. Spaces or hyphens are allowed. |
| NO_LEGAL_ADDRESS_COUNTRY NO_BILL_TO_ADDRESS_COUNTRY | Enter country code in two-letter code format. |
| LEGAL_ADDRESS_SANCTIONED_COUNTRY BILL_TO__ADDRESS_SANCTIONED_COUNTRY | Enter a different country. The country used in the request is sanctioned and cannot be used. |
| INVALID_PROFILE_STATE | Enter a valid value for is_active flag for payment profile. Payment profile cannot be active when Buyer is inactive. |
| LOCAL_INSTRUMENT_NOT_ALLOWED | Enter TRF payment method if using a local instrument. Local Instruments can only be used with TRF payment method. |
### 3. Verify the Buyer was successfully registered. {#3-verify-the-buyer-was-successfully-registered}
You should receive a 201 OK and the registration ID for the Buyer.
Tip: You will need the registration ID to perform other registration activities for the Buyer.
### 4. Click Next to proceed to updating the Buyer's registration. {#4-click-next-to-proceed-to-updating-the-buyers-registration}
## Update a Buyer registration {#update-a-buyer-registration}
You can make updates to the Buyer's registration after the Buyer has been successfully registered in Business Payment Service. For example, if a Buyer moves locations, you can update the information by leveraging this endpoint.
Note: Updating a Buyer's registration is separate from updating a Buyer's payment profile. To update billing and payment method details for a Buyer, click **Next**.
To update a Buyer's registration details, complete these steps:
### 1. Create the Buyer registration request using the PUT registration endpoint. {#1-create-the-buyer-registration-request-using-the-put-registration-endpoint}
Tip: You must include the ICA and registration ID for the Buyer in the request URI.
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.
The following Buyer details can be updated using the update a Buyer registration endpoint.
* Legal business address
* Organisation identification
These updates will be reflected immediately.
API Reference: `PUT /buyer-payment-agents/{ica}/buyers/{id}`
### 2. Review the possible error codes associated with this request. {#2-review-the-possible-error-codes-associated-with-this-request-1}
If an update Buyer registration request is incorrect or invalid, the registration is not updated. If the failure is due to invalid or missing information, you may receive one of the following error reason codes.
| Reason Code | Description |
|---------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| INVALID_LEGAL_BUSINESS_NAME INVALID_DBA_NAME NO_LEGAL_BUSINESS_NAME | Enter a Name with 240 characters or less. |
| INVALID_REGISTRATION_ID | Enter a valid Buyer registration ID. `` is either not valid or is not associated to your profile. |
| INVALID_LEGAL_ADDRESS_LINE_1 | Enter Address Line1 with 70 characters or less. |
| INVALID_LEGAL_ADDRESS_LINE_2 | Enter Address Line2 with 70 characters or less. |
| INVALID_LEGAL_ADDRESS_LINE_3 | Enter Address Line3 with 70 characters or less. |
| INVALID_LEGAL_ADDRESS_TOWN_NAME | Enter a Town Name with 50 characters or less. |
| INVALID_LEGAL_ADDRESS_COUNTRY_SUBDIVISION | Enter a Country SubDivision with 35 characters or less. |
| INVALID_LEGAL_ADDRESS__POSTCODE | **NAM** US: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. Canada: Enter a valid Post Code with 5 to 8 characters. Spaces or hyphens are allowed. **EUR** UK: Enter a valid Post Code with 6 to 8 characters. Spaces or hyphens are allowed. **LAC** Curacao (optional): Enter a valid Post Code up with 10 characters or less. Spaces or hyphens are allowed. Colombia: Enter a valid Post Code with 7 digits. Spaces or hyphens are allowed. Brazil: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. **Other** All other countries (optional): Enter a valid Post Code with 10 characters or less. Spaces or hyphens are allowed. |
| INVALID_TAX_ID_UPDATE | A Tax ID already exists for this Buyer. The Tax ID cannot be updated. |
| INVALID_ORGANISATION_ID_TYPE | Enter a valid Organisation Identification Type. |
| NO_TAX_ID | Enter a Tax ID for an Organisation. |
| INVALID_INACTIVE_REASON | Enter a valid inactive reason. Valid values are PRE_REGISTERED and AGENT_HOLD. |
| NO_INACTIVE_REASON | Enter an inactive reason. Valid values are PRE_REGISTERED or AGENT_HOLD. |
| INVALID_TAX_ID | **NAM** US: Enter a valid Tax ID with 9 digits. Canada: Enter a valid Tax ID with 9 digits. **EUR** UK: Enter a valid Tax ID with 10 digits. **LAC** Curacao: Enter a valid Tax ID with 9 digits. Colombia: Enter a valid Tax ID with 9 or 10 digits. Brazil: Enter a valid Tax ID with 14 digits. **Other** All other countries (optional): Enter a valid Tax ID with 15 digits. |
| NO_LEGAL_ADDRESS_LINE_1 | Enter Address Line1 with 70 characters or less. |
| NO_LEGAL_ADDRESS_TOWN_NAME | Enter a Town Name with 50 characters or less. |
| NO_LEGAL_ADDRESS_COUNTRY_SUBDIVISION | Enter a Country SubDivision with 35 characters or less. |
| NO_LEGAL_ADDRESS_POSTCODE | **NAM** US: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. Canada: Enter a valid Post Code with 5 to 8 characters. Spaces or hyphens are allowed. **EUR** UK: Enter a valid Post Code with 6 to 8 characters. Spaces or hyphens are allowed. **LAC** Curacao (optional): Enter a valid Post Code up with 10 characters or less. Spaces or hyphens are allowed. Colombia: Enter a valid Post Code with 7 digits. Spaces or hyphens are allowed. Brazil: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. **Other** All other countries (optional): Enter a valid Post Code with 10 characters or less. Spaces or hyphens are allowed. |
| NO_LEGAL_ADDRESS_COUNTRY | Enter country code in two-letter code format. |
| LEGAL_ADDRESS_SANCTIONED_COUNTRY | Enter a different country. The country used in the request is sanctioned and cannot be used. |
| INVALID_PROFILE_STATE_UPDATE | Enter a valid value for is_active flag. Buyer cannot be inactive when payment profile is active. |
| INVALID_COUNTRY_UPDATE | A Legal Address Country exists for this Buyer. The Legal Address Country cannot be updated. |
### 3. Verify the Buyer's details were successfully updated. {#3-verify-the-buyers-details-were-successfully-updated}
You should receive a 204 OK response.
### 4. Click Next to proceed to updating the Buyer's payment profile. {#4-click-next-to-proceed-to-updating-the-buyers-payment-profile}
## Update a Buyer payment profile {#update-a-buyer-payment-profile}
You can make updates to the Buyer's payment profile after the Buyer has been successfully registered in Business Payment Service. For example, if a Buyer changes its billing location or payment method details, you can update the information by leveraging this endpoint.
Note: Updating a Buyer's registration is separate from updating a Buyer's payment profile. To update a Buyer's registration, click **Back**.
To update a Buyer's payment profile details, complete these steps:
### 1. Create the Buyer profile update request using the PUT Buyer payment profile endpoint. {#1-create-the-buyer-profile-update-request-using-the-put-buyer-payment-profile-endpoint}
You must include the ICA, registration ID, and Buyer ID for the Buyer in the request URI.
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.
The following Buyer profile details can be updated using the update Buyer payment profile endpoint.
* Buyer profile email
* Local instruments
* Pay to address
* Payment methods
These updates will be reflected immediately.
API Reference: `PUT /buyer-payment-agents/{ica}/buyers/{id}/payment-profiles/{buyer_id}`
### 2. Review the possible error codes associated with this request. {#2-review-the-possible-error-codes-associated-with-this-request-2}
If a Buyer payment profile request is incorrect or invalid, the profile is not updated. If the failure is due to invalid or missing information, you may receive one of the following error reason codes.
| Reason Code | Description |
|---------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| BUYER_ID_EXISTS | Enter a different Buyer ID, `` already exists. |
| INVALID_BUYER_ID_FORMAT NO_BUYER_ID | Enter Buyer ID in the format \[Buyer\]@track or \[Buyer\].\[branch\]@track |
| BUYER_ID_NOT_FOUND | Enter a valid Buyer ID. `` was not found. |
| INVALID_REGISTRATION_ID | Enter a valid Buyer registration ID. is either not valid or is not associated to your profile. |
| INVALID_BILL_TO_ADDRESS_LINE_1 | Enter Address Line1 with 70 characters or less. |
| INVALID_BILL_TO_ADDRESS_LINE_2 | Enter Address Line2 with 70 characters or less. |
| INVALID_BILL_TO_ADDRESS_LINE_3 | Enter Address Line3 with 70 characters or less. |
| INVALID_BILL_TO_ADDRESS_TOWN_NAME | Enter a Town Name with 50 characters or less. |
| INVALID_BILL_TO_ADDRESS_COUNTRY_SUBDIVISION | Enter a Country SubDivision with 35 characters or less. |
| INVALID_BILL_TO_ADDRESS_POSTCODE | Enter a Country SubDivision with 35 characters or less. |
| INVALID_BILL_TO_ADDRESS_POSTCODE | **NAM** US: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. Canada: Enter a valid Post Code with 5 to 8 characters. Spaces or hyphens are allowed. **EUR** UK: Enter a valid Post Code with 6 to 8 characters . Spaces or hyphens are allowed. **LAC** Curacao(optional): Enter a valid Post Code up with 10 characters or less. Spaces or hyphens are allowed. Colombia: Enter a valid Post Code with 7 digits. Spaces or hyphens are allowed. Brazil: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. **Other** All other countries: (optional): Enter a valid Post Code with 10 characters or less. Spaces or hyphens are allowed. |
| INVALID_BILL_TO_ADDRESS_COUNTRY | Enter country code in two-letter code format. |
| PAYMENT_PROFILE_LIMIT_EXCEEDED | Remove one or more profiles. The total number of profiles associated with a Buyer cannot exceed 20. |
| NO_PAYMENT_METHOD | Enter one or more payment methods supported by the Buyer/Supplier and agent. Valid values are CARD, ACH, RTP, and TRF. |
| NO_LOCAL_INSTRUMENT | Enter one or more local instrument for the payment method TRF. |
| INVALID_PAYMENT_METHOD | Enter one or more valid payment methods supported by the Buyer/Supplier and agent. Valid values are CARD, ACH, RTP, and TRF. |
| INVALID_LOCAL_INSTRUMENT | Enter one or more valid local instruments for the payment method TRF. |
| UNSUPPORTED_PAYMENT_METHOD | Enter a payment method or local instrument supported by both agent and Buyer/Supplier. |
| NO_BILL_TO_ADDRESS_LINE_1 | Enter Address Line1 with 70 characters or less. |
| NO_BILL_TO_ADDRESS_TOWN_NAME | Enter a Town Name with 50 characters or less. |
| NO_BILL_TO_ADDRESS_COUNTRY_SUBDIVISION | Enter a Country SubDivision with 35 characters or less. |
| NO_BILL_TO_ADDRESS_POSTCODE | **NAM** US: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. Canada: Enter a valid Post Code with 5 to 8 characters. Spaces or hyphens are allowed. **EUR** UK: Enter a valid Post Code with 6 to 8 characters . Spaces or hyphens are allowed. **LAC** Curacao(optional): Enter a valid Post Code up with 10 characters or less. Spaces or hyphens are allowed. Colombia: Enter a valid Post Code with 7 digits. Spaces or hyphens are allowed. Brazil: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. **Other** All other countries: (optional): Enter a valid Post Code with 10 characters or less. Spaces or hyphens are allowed. |
| NO_BILL_TO_ADDRESS_COUNTRY | Enter country code in two-letter code format. |
| BILL_TO_ADDRESS_SANCTIONED_COUNTRY | Enter a different country. The country used in the request is sanctioned and cannot be used. |
| INVALID_PROFILE_STATE_UPDATE | Enter a valid value for is_active flag. Buyer cannot be inactive when payment profile is active. |
| LOCAL_INSTRUMENT_NOT_ALLOWED | Enter TRF payment method if using a local instrument. Local Instruments can only be used with TRF payment method. |
### 3. Verify the Buyer's payment profile details were successfully updated. {#3-verify-the-buyers-payment-profile-details-were-successfully-updated}
You should receive a 204 OK response.
### 4. Click Next to proceed to deleting the Buyer's registration in Business Payment Service. {#4-click-next-to-proceed-to-deleting-the-buyers-registration-in-business-payment-service}
## Delete a Buyer's payment profile {#delete-a-buyers-payment-profile}
You can delete a Buyer's payment profile in Business Payment Service.
Note: If there is any transaction activity, the Buyer Payment Agent must deactivate the Buyer registration and its associated Buyer payment profile instead of deleting. Contact your Mastercard representative to deactivate.
Deleting a Buyer's registration is separate from deleting a Buyer's payment profile. To delete a Buyer's registration, click **Next**.
To delete the Buyer's payment profile in Business Payment Service, complete these steps:
### 1. Create the Buyer registration deletion request using the DELETE Buyer payment profile endpoint. {#1-create-the-buyer-registration-deletion-request-using-the-delete-buyer-payment-profile-endpoint}
You must include the ICA, registration ID, and Buyer ID for the Buyer in the request URI.
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: `DELETE /buyer-payment-agents/{ica}/buyers/{id}/payment-profiles/{buyer_id}`
### 2. Review the possible error codes associated with this request. {#2-review-the-possible-error-codes-associated-with-this-request-3}
If a delete Buyer payment profile request is invalid, the payment profile is not deleted and you may receive the following error reason code.
| Reason Code | Description |
|-------------------------|-------------------------------------------------------------------------------------------------------|
| INVALID_REGISTRATION_ID | Enter a valid Buyer registration ID. `` is either not valid or is not associated to your profile. |
### 3. Verify that the Buyer's payment profile details were successfully deleted. {#3-verify-that-the-buyers-payment-profile-details-were-successfully-deleted}
You should receive a 204 OK response.
Note: The Buyer profile is marked in "INACTIVE" state once this endpoint is triggered. The buyer profile data is deleted after 90 days.
### 4. Click Next to proceed to retrieve the Buyer's registration in Business Payment Service. {#4-click-next-to-proceed-to-retrieve-the-buyers-registration-in-business-payment-service}
## Delete a Buyer {#delete-a-buyer}
You can delete a Buyer's registration in Business Payment Service.
Note: If there is any transaction activity, the Buyer Payment Agent must deactivate the Buyer registration and its associated Buyer payment profile instead of deleting. Contact your Mastercard representative to deactivate.
Deleting a Buyer's registration is separate from deleting a Buyer's payment profile. To delete a Buyer's payment profile, click **Back**.
To delete a Buyer's registration in Business Payment Service, complete these steps:
### 1. Create the Buyer registration deletion request using the DELETE registration endpoint. {#1-create-the-buyer-registration-deletion-request-using-the-delete-registration-endpoint}
You must include the ICA and registration Id for the Buyer in the request URI.
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: `DELETE /buyer-payment-agents/{ica}/buyers/{id}`
### 2. Review the possible error codes associated with this request. {#2-review-the-possible-error-codes-associated-with-this-request-4}
If a delete Buyer registration request is invalid, the registration is not deleted and you may receive the following error reason code.
| Reason Code | Description |
|-------------------------|-------------------------------------------------------------------------------------------------------|
| INVALID_REGISTRATION_ID | Enter a valid Buyer registration ID. `` is either not valid or is not associated to your profile. |
### 3. Verify the Buyer's registration was successfully deleted. {#3-verify-the-buyers-registration-was-successfully-deleted}
You should receive a 204 OK response.
Note: The Buyer is marked in "INACTIVE" state once this endpoint is triggered. The buyer data is deleted after 90 days.
### 4. Click Next to proceed to deleting the Buyer's registration in Business Payment Service. {#4-click-next-to-proceed-to-deleting-the-buyers-registration-in-business-payment-service-1}
## Retrieve Buyer details {#retrieve-buyer-details}
These optional endpoints allow Buyer Payment Agents to retrieve Buyer registration. You can leverage these endpoints to either lookup a single Buyer or all Buyers associated with the agent in Business Payment Service.
To retrieve Buyer(s) in Business Payment Service, complete these steps:
### 1. Create the single Buyer registration retrieval request using the GET registration endpoint to retrieve all Buyer registrations. {#1-create-the-single-buyer-registration-retrieval-request-using-the-get-registration-endpoint-to-retrieve-all-buyer-registrations}
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.
#### Retrieve a single Buyer registration {#retrieve-a-single-buyer-registration}
API Reference: `GET /buyer-payment-agents/{ica}/buyers/{id}`
#### Retrieve all Buyer registrations {#retrieve-all-buyer-registrations}
API Reference: `GET /buyer-payment-agents/{ica}/buyers`
### 2. Review the possible error codes associated with this request. {#2-review-the-possible-error-codes-associated-with-this-request-5}
If a retrieve a single Buyer registration request is invalid, the registration is not retrieved and you may receive the following error reason code.
| Reason Code | Description |
|-------------------------|-------------------------------------------------------------------------------------------------------|
| INVALID_REGISTRATION_ID | Enter a valid Buyer registration id. `` is either not valid or is not associated to your profile. |
If a retrieve all Buyer registrations request is invalid, the registration is not retrieved, and you may receive the following error reason code.
| Reason Code | Description |
|---------------|-----------------------------------------------------------------------------------------------------|
| INVALID_LIMIT | Set the limit to 100 records or less for this request. You can only retrieve 100 records at a time. |
### 3. Verify the Buyer's registration details were successfully retrieved. {#3-verify-the-buyers-registration-details-were-successfully-retrieved}
You should receive a 200 OK response.
### 4. Continue to the linking trading partners tutorial. {#4-continue-to-the-linking-trading-partners-tutorial}
Once your Buyers are registered with Business Payment Service, consider linking your trading partners to ensure the right entities are transacting with Business Payment Service. Review the tutorial [here](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/tutorials-and-guides/linking-tutorial/index.md).