Em breve · Pagar Pix

Consultar pagamento de Pix copia-e-cola

GET/v1/pix-code-payments/{pixCodePaymentId}pix_code_payments:readEM BREVE

Situação e comprovante do pagamento.

Este recurso ainda não está disponível. O contrato abaixo mostra como ele vai funcionar, para você planejar a integração. Hoje a chamada é recusada e nada é criado; os campos podem mudar até a liberação, que sai no changelog.

Cabeçalhos

Authorizationstringobrigatório

Bearer seguido da sua chave: gw_test_ em teste, gw_live_ em produção.

Parâmetros de caminho

pixCodePaymentIduuidobrigatório

Resposta 200

Sucesso.

iduuid

external_idstring

statusstring

PROCESSINGCOMPLETEDFAILEDUNKNOWN

amount_centsinteger

exemplo 4990 = R$ 49,90

fee_centsinteger

exemplo 149 = R$ 1,49

total_debit_centsinteger

exemplo 5139 = R$ 51,39

recipientobject | null

2 campos

namestring | null

bankstring | null

end_to_end_idstring | null

metadataobject · até 20 chaves

Pares chave-valor seus, até 2 KB.

created_atdatetime

Códigos de resposta

HTTP	Quando acontece
200	Sucesso.

Outras operações de Pagar Pix

POST/v1/pix-code-payments/decodeLer Pix copia-e-cola POST/v1/pix-code-paymentsPagar Pix copia-e-cola

Prévia da requisição

curl -X GET "https://api.mainumpay.com/v1/pix-code-payments/{pixCodePaymentId}" \
  -H "Authorization: Bearer $MAINUM_API_KEY"

Prévia da resposta

{
  "id": "0192a7c4-5b1e-7d3a-9f10-6c2e8b4d1a77",
  "external_id": "pedido-48213",
  "status": "PROCESSING",
  "amount_cents": 4990,
  "fee_cents": 149,
  "total_debit_cents": 5139,
  "recipient": {
    "name": "Ana Souza",
    "bank": "bank"
  },
  "end_to_end_id": "0192a7c4-5b1e-7d3a-9f10-6c2e8b4d1a77",
  "metadata": {
    "pedido": "48213"
  },
  "created_at": "2026-09-24T14:32:11.000Z"
}

Sucesso.