Phygrid Developers
Browse Topics
API Reference / Phygrid Developers

API Reference

This is the API reference for Grid Checkout API.

Request authentication

  • In Grid Console, you need to generate an Access Token under the "Developer" tab.
  • Add x-api-key in the request header, with the generated access token value.

Base API URL overview

The {baseUrl} for the Grid Checkout API is determined by the data residency of your tenant.

Regional Grid Checkout base API URLs:

RegionURL
EUhttps://api.omborigrid.com/regions/eu/phycheckout
UShttps://api.omborigrid.com/regions/us/phycheckout
UAEhttps://api.omborigrid.com/regions/uae/phycheckout
INhttps://api.omborigrid.com/regions/in/phycheckout
AUhttps://api.omborigrid.com/regions/au/phycheckout
  • The standard base URL for most API operations is structured as follows: https://api.omborigrid.com/regions/{dataResidency}/phycheckout/api/tenants/{tenantId}

  • The {tenantId} parameter should be substituted with your specific tenant ID, which can be found in your Grid console.

The following endpoints are available in the API:

MethodEndpointDescription
GET

transaction/{id}

Retrieves specific transaction by ID
GETtransactionsReturns list of transactions

GET Transaction by ID

Retrieves a specific transaction by ID

GET {baseUrl}/api/tenants/{tenantId}/transactions/{transactionId}

Response

{
    data: Transaction
}

Reference: Transaction

Query Parameters

ParameterTypeDescriptionExample
transactionIdstringThe ID of the Transaction100001

GET Transactions

Retrieves a list of transactions based on specified query parameters.

GET {baseUrl}/api/tenants/{tenantId}/transactions

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExample
limitnumber

Maximum number of item count to retrieve Default: 50

100
pagenumber

Current pagination result Default: 1

1

Response

{
    items: Array<Transaction>,
    page: number,
    totalPages: number,
    totalItems: number,
    limit: number,
}

Reference: Transaction

© 2024 · Phygrid. An Ombori company