Skip to main content

API changelog

2026-05-19 - Merchant API v1 balance and money precision​

Changed​

  • amount in POST /api/v1/payouts and POST /api/v1/payins must be sent as a JSON string with a positive decimal value, for example "1000.00" or "10.123456".
  • Merchant operation responses now return monetary amount values as decimal strings normalized by currency scale.
  • GET /api/v1/balance now returns a shop-scoped balance snapshot with available, pending, frozen, credit, total, buckets, pending_breakdown, and as_of.
  • Error responses include stable code and error fields while keeping the top-level message.

Not changed​

  • Existing /api/v1/payouts, /api/v1/payins, /api/v1/balance, and status paths remain unchanged.
  • external_id remains the merchant operation identifier in this version.