POST/transactions/create

Criar Pagamento

Cria um novo pagamento PIX e retorna o QR Code para o cliente pagar.

Request Body

Parâmetro	Tipo	Descrição
`amount`*	number	Valor em reais (mínimo R$ 1,00)
`payerName`	string	Nome do pagador (opcional — usa dados da conta se omitido)
`payerDocument`	string	CPF ou CNPJ (opcional — usa dados da conta se omitido)
`description`	string	Descrição do pagamento
`feeToCustomer`	boolean	Se `true`, o cliente paga valor + taxa e você recebe o valor cheio. Padrão: `false`

Exemplo de Request

curlbash

curl -X POST "https://api.magnuspay.com.br/transactions/create" \
  -H "X-API-Key: magnus_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 99.90,
    "description": "Assinatura Premium",
    "feeToCustomer": true
  }'

Resposta de Sucesso

201 Createdjson

{
  "success": true,
  "message": "Transação criada com sucesso",
  "data": {
    "transactionId": "507f1f77bcf86cd799439011",
    "externalId": "txn_abc123",
    "amount": 99.90,
    "platformFee": 0.50,
    "netAmount": 99.40,
    "qrCodeBase64": "data:image/png;base64,...",
    "qrcodeUrl": "https://...",
    "copyPaste": "00020126580014br.gov.bcb.pix...",
    "paymentLink": "https://magnuspay.com.br/pay/507f1f77bcf86cd799439011"
  }
}

feeToCustomer

feeToCustomer: false (padrão) — O cliente paga apenas o valor do item. A taxa é descontada do que você recebe.

feeToCustomer: true — O cliente paga valor + taxa. Você recebe o valor cheio.

💡 Dica

Use o qrCodeBase64 para exibir o QR Code diretamente em uma tag <img>, o copyPaste para copiar o código PIX, ou compartilhe o paymentLink diretamente com o cliente. A transação expira automaticamente após 15 minutos.