Skip to main content

API Reference

MED module temporarily offline

Starting May/2026, while we migrate from Finaya to MT Bank as the settlement provider, the MED module is temporarily unavailable. The endpoints below return HTTP 503 with errorCode: "service_temporarily_unavailable":

  • GET /v1/accounts/{id}/pix/med
  • POST /v1/accounts/{id}/pix/med/{medId}/answer
  • POST /v1/accounts/{id}/pix/med/{medId}/decide
  • POST /v1/accounts/{id}/pix/med/{medId}/evidence/*

Open disputes follow BACEN's natural lifecycle — only the API integration is paused. No specific ETA; a new changelog entry will be published when it returns.

Complete interactive documentation of the CorpX API with all endpoints, schemas, and examples.

Specification Download​

Interactive Swagger UI​

Required Headers​

All requests (except OAuth) require:

X-Tenant-Id: {tenant-uuid}
Authorization: Bearer {access-token}

Idempotent requests also require:

Idempotency-Key: {client-generated-uuid}

For details on authentication, webhooks, and error handling, see the guides in the sidebar.