Submit the clarification

POST

https://tenant.api.corpx.com/v1/accounts/:accountId/pix/med/:id/submit

POST

/v1/accounts/:accountId/pix/med/:id/submit

curl -X POST https://tenant.api.corpx.com/v1/accounts/accountId/pix/med/id/submit \
     -H "X-Tenant-Id: X-Tenant-Id" \
     -H "Authorization: Bearer <token>"

{
  "medId": "204cc938-da3d-4f04-baf3-0b2e6a2f1283",
  "accountId": "2e6b725b-84a0-400d-8740-22a5ba0f23e6",
  "tenantId": "tn_7f3a9c",
  "endToEndId": "E303062942026021812490000005QLMv",
  "amount": 1000,
  "answered": true,
  "updatedAt": "2026-02-20T16:45:00Z",
  "reviewStatus": "pending_review",
  "canUpload": false,
  "canAnswer": false,
  "canMessage": false,
  "canSubmit": false,
  "events": [
    {
      "at": "2026-02-20T14:02:31Z",
      "kind": "info_requested",
      "reviewStatus": "info_requested",
      "message": "Esclarecimento solicitado",
      "round": null,
      "step": null
    },
    {
      "at": "2026-02-20T16:45:00Z",
      "kind": "submitted",
      "reviewStatus": "pending_review",
      "message": "Esclarecimento enviado",
      "round": null,
      "step": null
    }
  ],
  "messages": [
    {
      "messageId": "medmsg_01J9X",
      "authorKind": "staff",
      "body": "Envie o comprovante de entrega com o rastreio.",
      "createdAt": "2026-02-20T14:02:31Z",
      "evidenceIds": []
    },
    {
      "messageId": "medmsg_01J9Y",
      "authorKind": "holder",
      "body": "Segue o comprovante de entrega com rastreio BR123456789BR.",
      "createdAt": "2026-02-20T16:40:00Z",
      "evidenceIds": [
        "medev_9f1c"
      ]
    }
  ],
  "evidences": [
    {
      "evidenceId": "medev_9f1c",
      "filename": "comprovante-entrega.pdf",
      "contentType": "application/pdf",
      "sizeBytes": 184320,
      "uploadedAt": "2026-02-20T16:41:00Z",
      "scanStatus": "APPROVED",
      "downloadUrl": "https://storage.example.com/signed",
      "messageId": "medmsg_01J9Y"
    }
  ],
  "steps": [],
  "reasonCode": "unauthorized-transaction",
  "openedAt": "2026-02-18T19:34:14Z",
  "clientAnswerDeadline": "2026-02-20T19:34:14Z",
  "infoDueAt": null,
  "lockStatus": "locked",
  "lockedAmount": 1000,
  "refundedTotal": 0,
  "remaining": 1000,
  "refundPartial": false,
  "infoRequest": null
}

Closes the clarification: info_requested → pending_review, with a pix.med.review.updated webhook (reason: submitted). Requires at least one new message or attachment since the review’s request; otherwise 422 med_info_missing. No request body.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired

Account identifier.

idstringRequired

The medId.

Response

Clarification submitted; the detail is returned with reviewStatus: pending_review.

medIdstring

Infraction report id. Same value as data.medId in the webhooks.

accountIdstring

tenantIdstring

endToEndIdstring

E2E of the disputed PIX.

amountdouble

Disputed amount. Amount in BRL. Max 2 decimal places (e.g., 150.75 for R$150,75).

answeredboolean

Whether the holder's response was recorded for this dispute.

updatedAtdatetime

reviewStatusenum

Stage of CorpX's review. awaiting_defense → pending_review (→ info_requested → pending_review) → in_execution → refunded | awaiting_funds, or refused.

canUploadboolean

canAnswerboolean

canMessageboolean

canSubmitboolean

eventslist of objects

Timeline visible to the account holder; message texts are in Portuguese.

messageslist of objects

evidenceslist of objects

stepslist of objects

Return steps CorpX already executed, in text. Appears from in_execution on.

transactionIdstringOptional

Our statement entry for the disputed PIX, when it exists on the platform. Empty for credits that predate the account here.

reasonCodestringOptional

Reason reported by the scheme, passed through raw.

claimMessagestringOptional

Free-text details from the claimant, when present.

claimantBankstringOptional

Claimant's bank. The scheme does not disclose the claimant's name or tax id to the receiving party.

openedAtdatetimeOptional

clientAnswerDeadlinedatetimeOptional

openedAt + 48h. Nothing is auto-rejected on expiry: the dispute stays alive, the client just loses the chance to state their case.

answeredAtdatetimeOptional

answerResultenumOptional

Allowed values:

answerstringOptional

The justification sent with the response.

closedAtdatetimeOptional

Set when a webhook reported the dispute as closed.

infoDueAtdatetime or nullOptional

Deadline of the pending clarification, in info_requested.

lockStatusenumOptional

Balance hold for the dispute. Absent for disputes that predate the automatic hold.

Allowed values:

lockedAmountdoubleOptional

Amount currently held, in BRL. 0 when nothing is held.

refundedTotaldoubleOptional

Sum of completed returns, in BRL.

remainingdoubleOptional

Disputed amount minus refundedTotal.

refundPartialbooleanOptional

true when the dispute closed with a partial return.

infoRequestobject or nullOptional

The review's question, present in info_requested.

Errors

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error

Authentication

Path parameters

Headers

Response

Errors