Em breve · Pagar Pix

Ler Pix copia-e-cola

POST/v1/pix-code-payments/decodepix_code_payments:writeEM BREVE

Mostra recebedor, valor e tarifa antes de pagar.

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.

Corpo da requisição

copy_pastestring · 20–4096obrigatório

Resposta 200

Sucesso.

validboolean

recipient_namestring | null

recipient_document_maskedstring | null

recipient_bankstring | null

amount_centsinteger | null

Valor fixo do código, quando existir.

exemplo 4990 = R$ 49,90

amount_lockedboolean

fee_centsinteger

Tarifa somada ao valor.

exemplo 149 = R$ 1,49

total_debit_centsinteger | null

exemplo 5139 = R$ 51,39

Códigos de resposta

HTTP	Quando acontece
200	Sucesso.

Outras operações de Pagar Pix

POST/v1/pix-code-paymentsPagar Pix copia-e-cola GET/v1/pix-code-payments/{pixCodePaymentId}Consultar pagamento de Pix copia-e-cola

Prévia da requisição

curl -X POST "https://api.mainumpay.com/v1/pix-code-payments/decode" \
  -H "Authorization: Bearer $MAINUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "copy_paste": "00020101021226870014br.gov.bcb.pix…"
}'

Prévia da resposta

{
  "valid": true,
  "recipient_name": "recipient-name",
  "recipient_document_masked": "recipient-document-masked",
  "recipient_bank": "recipient-bank",
  "amount_cents": 4990,
  "amount_locked": true,
  "fee_cents": 149,
  "total_debit_cents": 5139
}

Sucesso.