DESENVOLVEDORES

PIX simples de integrar.

Esta é a visão simplificada do produto PagarPIX. O contrato canônico, a autenticação e a execução financeira pertencem ao XPayments Core.

QUICKSTART

Crie uma cobrança PIX no servidor.

O endpoint canônico pertence ao XPayments Core. O PagarPIX organiza a experiência de produto, mas não replica o processamento financeiro.

POST/api/v1/payments/charge
{
  "amount": 1000,
  "currency": "BRL",
  "payment_method_types": ["pix"],
  "metadata": { "order_id": "ORDER-001" }
}
Unidade de valor

Confirme a unidade monetária aplicável no contrato canônico antes da integração. Não inferimos conversões no frontend.

Regras de segurança

  • Faça chamadas server-to-server.
  • Nunca coloque API keys no browser.
  • Valide a assinatura dos webhooks.
  • Use idempotência quando prevista no contrato do Core.

Contrato canônico

Autenticação, respostas, webhooks e comportamento financeiro devem ser validados na documentação oficial do XPayments.

Abrir docs.xpayments.digital ↗