Requesting a New Seller

When utilizing the SellerDetailedSearch call, if no matching seller is identified, Verdata provides the ability to initiate a request to locate the business you are seeking. This enhancement aims to streamline your search experience and improve efficiency. This feature is known as On Demand Merchant (ODM).

This endpoint allows the user to request the addition of a new business. This will trigger a request to our data acquisition pipeline in an attempt to find the business. A callback URL is required to hit this call. The callback URL must correspond to a live, accessible REST endpoint that accepts POSTs containing the generated Seller Report payload.

If a business was found, a full Seller Report will be sent to the provided callback URL. If no results were found, the callback URL will receive a notification of the unsuccessful attempt.

Request Syntax

{

    "business_name":     "string",    // required
    "business_address":  "string",    // required
    "business_city":     "string",    // required
    "business_state":    "string",    // required
    "business_phone":    "string",    // optional
    "business_zip5":     "string",    // optional
    "created_by":        "string",    // optional
    "callback":          "string"     // required

}

Response

If successful, the API will return a 200 Status along with a request_id that can be used to track the status of the request.

{

    "status":     "string",
    "request_id": "uuid"

}

For more detailed API Specifications, please see our API Reference Guide > On Demand Merchant