Core Reference/MED
GET

Ver MED

Ver MED. See the request, response and integration notes.

GET/v1/med/{id}
https://integrate.api.kyvopay.com.br
cURL
curl -X GET "https://api.kyvopay.com.br/v1/med/ID_DO_MED" \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "X-Business-Id: UUID_DA_EMPRESA"
Resposta200 OK
{
  "data": {
    "id": "med_...",
    "payment_id": "pay_...",
    "provider_med_id": "...",
    "amount_centavos": "10000",
    "status": "open",
    "reason": null,
    "end_to_end_id": "E...",
    "opened_at": "2026-09-24T12:00:00.000Z",
    "resolved_at": null,
    "created_at": "2026-09-24T12:00:00.000Z",
    "protocol": null,
    "counterparty": null,
    "defense": null
  },
  "error": null,
  "request_id": "req_..."
}

Authentication

X-API-Keystring · headerrequired

Use the ky_... key created under Integrations → API Keys in the KyvoPay dashboard.

Use this endpoint to perform this operation.

Request

Note

Private endpoints require the X-API-Key header. Keep credentials on your backend and log the response request_id for diagnostics.

Response

Implementation notes

  • Validate required input before sending the request.
  • Store returned public identifiers without assuming their format.
  • Treat 4xx validation errors as non-retryable until the request is corrected.
  • Retry timeouts, 429 and temporary 5xx responses with exponential backoff.
Need help? Contact support
© 2026 KyvoPay