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
`externalId`	string	ID do seu sistema para referência
`expiresIn`	number	Tempo de expiração em minutos (padrão: 30)
`webhookUrl`	string	URL para receber notificação de pagamento

Exemplo de Request

curlbash

curl -X POST "https://api.vyepay.com/transactions/create" \
  -H "X-API-Key: vye_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 99.90,
    "description": "Assinatura Premium",
    "externalId": "pedido_12345",
    "webhookUrl": "https://seusite.com/webhook/pagamento"
  }'

Resposta de Sucesso

200 OKjson

{
  "success": true,
  "data": {
    "id": "pag_abc123xyz",
    "amount": 99.90,
    "status": "PENDING",
    "description": "Assinatura Premium",
    "externalId": "pedido_12345",
    "qrCode": "00020126...",
    "qrCodeBase64": "data:image/png;base64,...",
    "expiresAt": "2024-01-15T14:30:00.000Z",
    "createdAt": "2024-01-15T14:00:00.000Z"
  }
}

💡 Dica

Use o qrCodeBase64 para exibir o QR Code diretamente em uma tag <img> ou use o qrCode para gerar o código você mesmo.