GTRADEDocs
Help

Changelog

Changes to the GTRADE API, SDKs and documentation. Breaking changes are announced here and by email in advance.

#Versioning policy

The API version is part of the path (/v1). Within v1 we only make backwards-compatible changes, such as:

  • new endpoints, optional request fields or query parameters;
  • new fields in responses and webhook payloads;
  • new webhook event types and new error codes.

Write your integration to ignore unknown fields and event types. Breaking changes will come as a new version (/v2) with a migration period.

#2026-11-17: API v1 and SDKs 1.0.0

  • API v1 released: payments (create, retrieve, list with cursor pagination and status filter), idempotency keys, metadata, webhook endpoints (register, list, delete, test), signed webhook events with automatic retries, per-key rate limits.
  • SDKs 1.0.0 for Node.js, Python and PHP, with automatic retries, typed errors, auto-pagination and webhook verification.
  • Documentation published at https://docs.gtradegateway.io.