Triple API and Webhooks
Offer Providers
Create a Merchant
1min
POST
https://api.tripleup.dev/partner/merchants
triple Prod
BODY PARAMETERS
body
object
address
object
*A physical address in the world, with required fields.
triple uses address validation services to update and standardize
addresses on our platform. Address data sent to the API may be updated
as we process, validate, and normalize addresses.
assumed_name
string
*The (doing-business-as) name of the Merchant.
external_id
string
*Partner-provided, external ID for a Merchant.
External IDs should be **stable** and **never sensitive**.
External IDs do not need to be globally unique, but we encourage
the use of UUIDs. They must be unique for the Merchant within
the scope of its parent Content Provider.
To protect against accidental inclusion of sensitive personal
information, external IDs may not be 9-digit numbers or use the
US Tax ID format (###-##-####).
merchant_category_code
string
*Example: 7998
The 4-digit Merchant Category Code
logo_url
string<url>
A link to the merchant's logo
RESPONSES
201
Merchant
object
A Merchant (or brand) is a business or retailer with one or more
Merchant Locations (online or physical locations). Consumers who make
purchases at Merchants with valid Offers may receive Rewards.
address
object
*A physical address in the world, with required fields.
triple uses address validation services to update and standardize
addresses on our platform. Address data sent to the API may be updated
as we process, validate, and normalize addresses.
assumed_name
string
*The (doing-business-as) name of the Merchant.
merchant_category
object
*created_at
string<date-time>
*Example: 2021-12-01T01:59:59.000Z
RFC 3339 date time used for creation and mod times
external_id
string
Partner-provided, external ID for a Merchant.
External IDs should be **stable** and **never sensitive**.
External IDs do not need to be globally unique, but we encourage
the use of UUIDs. They must be unique for the Merchant within
the scope of its parent Content Provider.
To protect against accidental inclusion of sensitive personal
information, external IDs may not be 9-digit numbers or use the
US Tax ID format (###-##-####).
id
string
*Example: triple-abc-123
The triple-defined ID for the entity.
logo_url
string<url>
A link to the merchant's logo
updated_at
string<date-time>
*Example: 2021-12-01T01:59:59.000Z
RFC 3339 date time used for creation and mod times
400
TripleBadRequestError
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
403
TripleNotAuthenticatedError
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
404
TripleInvalidPathError
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
409
TripleIntegrityError
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
415
TripleUnsupportedMediaType
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
422
TripleUnprocessableEntity
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
500
TripleInternalServerError
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
501
TripleNotImplementedError
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
503
TripleServiceUnavailable
object
status_code
integer
*The 3-digit HTTP Response Status code
content
object
*The error response content.
Updated 24 Oct 2023
Did this page help you?