Skip to content

Versioning

Everything is /v1. Additive changes (a new field, resource or error code) ship inside /v1, so build your integration to ignore fields it does not know. Removing or changing the meaning of anything needs /v2 and a deprecation period.

  • Bodies are JSON, sent with Content-Type: application/json. Responses are always JSON.
  • Paths are plural snake_case, with no trailing slash.
  • Amounts are integers in the currency's minor unit, with a three-letter ISO 4217 currency in lower case: 10000 in php is ₱100.00. Requests take the currency in either case.
  • Times are Unix timestamps: whole seconds since 1970-01-01 UTC, such as created.
  • Every response carries an X-Request-ID header. Quote it when you contact support.