Table View (All APIs)
Quick lookup for methods and paths across common areas. Use the environment base URL from Environments and Base URLs, then append the paths below.
Authentication and Health
POST
/realms/<realm>/protocol/openid-connect/token
Obtain an OAuth access token
GET
/health
Basic service health check
Onboarding
POST
/merchant-onboarding/application
Create application; signer email is sent automatically
GET
/merchant-onboarding/application/{applicationId}
Get application status
GET
/merchant-onboarding/application/{applicationId}/resume-signing
Get a fresh signing URL
PUT
/merchant-onboarding/{partnerId}/webhook
Register onboarding webhook
GET
/merchant-onboarding/callback
Signing callback (informational)
POST
/merchant-onboarding/{applicationId}/feedback
Submit manual review decision
Locations
POST
/Merchants/{id}/locations
Create a new location under a merchant
GET
/Merchants/{id}/locations
List locations for a merchant
GET
/Locations/{id}
Get a single location
PUT
/Locations/{id}
Update a location with a full replacement body
DELETE
/Locations/{id}
Delete a location that has no terminals
GET
/Locations/{id}/terminals
List terminals for a location
Terminals and Webhooks
GET
/Terminals/{id}
Get a single terminal
POST
/Locations/{id}/terminals
Create a terminal under a location
PUT
/Terminals/{id}/webhook
Set or update the terminal webhook using webhookUrl
in the body
GET
/Terminals/{id}/webhook
Retrieve the current webhook configuration for a terminal
DELETE
/Terminals/{id}/webhook
Remove the webhook configuration for a terminal
DELETE
/Terminals/{id}
Delete a terminal
Terminal webhook body
webhookUrl
string
Yes
HTTPS endpoint that receives payment events
Payments and Reporting
GET
/Reporting/partners/{id}/payments
Partner level payment history with pagination and filters
GET
/Reporting/merchants/{id}/payments
Merchant level payment history with pagination and filters
Standard query parameters for payment history
from
string (ISO 8601)
No
Inclusive start timestamp in UTC
to
string (ISO 8601)
No
Exclusive end timestamp in UTC
status
string
No
Payment status filter. Use the status enums shown in Payment Webhooks and Event Reference
tenderType
string
No
One of the tender strings listed on the Tender Types pages
locationId
string
No
Filter by a specific location when using merchant history
page
integer
No
One based page number. Defaults to 1
pageSize
integer
No
Items per page. Defaults to a sensible limit for reporting
Response envelope for payment history
data
array
Array of payments that match the filters
total
integer
Total count across all pages
page
integer
Current page number
Partners and Merchants
GET
/Partners/{id}
Get a single partner
POST
/Partners/{parentId}/partners
Create a child partner under a parent partner
GET
/Merchants/{id}
Get a single merchant
POST
/Partners/{id}/merchants
Create a merchant under a partner
Error handling and headers
Authorization header
Send Authorization: Bearer <access_token>
on every call
Accept and Content Type
Use Accept: application/json
and Content-Type: application/json
for JSON bodies
Error model
Client code should handle 400
, 401
, 403
, 404
. Some flows can return 409
for duplicates and 422
for business rule failures
Notes
Pagination convention
Payment history uses page
and pageSize
with a data
envelope and a total
field
Tender inheritance
A location can inherit merchant defaults when tenderTypes
is omitted. A terminal inherits from its parent location unless you override it
Immutable fields
Identifiers and timestamp fields are read only on read calls and must not be included in write bodies except where shown in examples
Last updated