Skip to main content

Onboarding API: looking up industry codes

How to look up the supported industry codes and where to use them in onboarding requests.

Each business line and each store needs an industryCode from ValPay’s list of 251 supported codes, for example 6212.

Request

GET /v1/industry-codes on the API host, with a JWT or an API key (see Onboarding API: authentication and environments). Both query parameters are required; leaving out limit returns an error.

Query parameter

Required

Description

limit

Yes

Records per page, 1 to 1000. Use 1000 to get every code in one call.

page

Yes

Page number, starting at 0

curl "https://api.valpay.dev/v1/industry-codes?limit=1000&page=0" \
-H "X-API-KEY: YOUR_API_KEY"

Response

The codes are in data, each with its description. Send the code as a string.

Where codes are used

Field

Notes

businessLine.industryCode

The merchant’s main business

stores[].businessLine.industryCode

Each store’s business, usually the same code

Some brands accept only a restricted set of codes (see Onboarding API: looking up brands). A code outside that set is rejected when you create the merchant.

Did this answer your question?