Skip to main content

API Reference

MED endpoints temporarily offline

Since May/2026, during a settlement provider migration (CorpX), the MED contestation endpoints are temporarily unavailable and 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/*

The pix.med.opened / pix.med.updated webhooks are being emitted again — you keep getting notified about new disputes and status changes (see Webhooks). Only disputing via API remains paused. Open disputes follow BACEN's natural lifecycle. No specific ETA; a changelog entry will be published when the endpoints return.

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

Specification Download​

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}

Interactive Swagger UI​

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