Gateway#

The GroupVAN Gateway provides transactional services for ordering, catalog launch, invoicing and statement retrieval. These services connect buyer systems to seller systems through the GroupVAN network.

Base URL#

Environment

URL

Production

https://gateway.groupvan.com

Staging

https://api.staging.groupvan.com

Authentication#

All Gateway endpoints require a valid JWT Bearer token in the request header.

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

See Authentication for details on generating a self-signed JWT.

Available Services#

Service

Method

Endpoint

Description

Item Inquiry

POST

/json/federated/v3_1/item_inquiry

Check pricing and availability

Place Order

POST

/json/federated/v3_1/place_order

Submit purchase orders

Catalog Launch

POST

/auth/get_catalog_token

Generate catalog session token

Get Cart

GET

/v2_1/catalog/cart/{cart_id}

Retrieve cart from catalog session

Postman Collection#

A Postman collection and environment file are available for testing and exploring the Gateway.

Download Collection | Download Environment |

Import both files into Postman to get pre-configured requests for all endpoints.

Import Instructions

  1. Open Postman and click Import in the top left.

  2. Import both the collection and environment files.

  3. Select the GroupVAN Gateway environment from the environment dropdown.

  4. Set your ACCESS_TOKEN value in the environment variables.

  5. The BASE_URL defaults to staging. Change it to https://gateway.groupvan.com for production.

  6. Send requests. The collection uses ACCESS_TOKEN for Bearer authentication across all requests.