v1

latestOpenAPI 3.0.12026-07-243407211.3 MB
BillPay

Search Payee by Name

This endpoint allows you to search for a payee in the payee directory by name. <br/>• To search the payee directory, you must enter a minimum of 3 characters and a maximum of 32 characters from the payee’s name. <br/>• Once the search is completed, a list of payee names that match the searched payee name will be returned. <br/>• This endpoint applies to merchant payees only. To add a payee, you must first use the search payee API to locate the payee and their merchantId in the directory. <br/>• The payee name search is a full text search, so the payee’s full name must be provided. <br/>• This endpoint is not designed for rapid asynchronous calls, because it pulls not only the payee’s names, but also the payee’s complete profile information. Requests may be denied if too many are called in a short period of time. <br/>• Therefore, a two second wait is required between each search. <br/>• Partners should submit payee search requests after the customer stops typing or after the response to the initial payee search request is received.

post/programs/{programCode}/accounts/{accountIdentifier}/billpayPayees/search

Path parameters

programCodestring required

The program code associated with the partner implementation.

accountIdentifierstring required

The unique identifier of the account for which to search payees. Must be a valid GUID.

Headers

X-GD-RequestIdstring required

The unique request identifier for idempotency and tracking. Must be provided in the X-GD-RequestId header.

Request body

accountIdentifierstring nullable

The unique identifier of the account for which to search payees. Must be a valid GUID.

namestring nullable

The name or partial name of the payee to search for. Must be between 3 and 32 characters.

Response

OK