Criar Transação

Descrição

Cria uma nova transação na Levora Payments usando PIX ou Cartão de Crédito.

Endpoint

POST https://www.levorapayments.com/api/

Utilize este endpoint para iniciar uma nova transação. Para evitar duplicidade, envie um external_id único para cada pedido criado no seu sistema.

Campos do Payload

Campo	Tipo	Obrigatório	Descrição
amount	number	Sim	Valor da transação. Envie um número inteiro ou decimal conforme a configuração da integração. Exemplo: `100`.
external_id	string	Sim	Identificador único da transação no sistema do integrador. Exemplo: `pedido_pix_001`.
payment_method	string	Sim	Meio de pagamento utilizado. Valores esperados: `pix` ou `credit_card`.
name	string	Sim	Nome completo do pagador. Envie apenas dados fictícios em testes e documentação.
email	string	Sim	E-mail válido do pagador, no formato `nome@dominio.com`.
document	string	Sim	CPF ou CNPJ do pagador contendo apenas números. Exemplo CPF: `12345678909`.
phone	string	Sim	Telefone do pagador com DDD, contendo apenas números. Exemplo: `11987654321`.
postback_url	string	Não	URL pública para receber notificações dessa transação específica.

Campo postback_url

O campo postback_url é opcional. Caso seja enviado na criação da transação, ele sobrescreve temporariamente o webhook configurado no painel da Levora Payments apenas para aquela transação específica.

Payload PIX

{
  "amount": 100,
  "external_id": "pedido_pix_001",
  "payment_method": "pix",
  "name": "João Cliente Teste",
  "email": "cliente.pix@example.com",
  "document": "12345678909",
  "phone": "5511999999999",
  "postback_url": "https://www.sualoja.com/webhook/retorno"
}

Payload Cartão de Crédito

{
  "external_id": "pedido_card_001",
  "amount": 5,
  "email": "cliente.card@example.com",
  "phone": "5511998888888",
  "document": "98765432100",
  "name": "Maria Cliente Teste",
  "payment_method": "credit_card",
  "card": {
    "holder": "MARIA CLIENTE TESTE",
    "number": "4111111111111111",
    "expiration_month": "12",
    "expiration_year": "2032",
    "cvv": "123",
    "installments": 1
  },
  "postback_url": "https://www.sualoja.com/webhook/retorno"
}

Objeto Card

O objeto card deve ser enviado quando payment_method for credit_card. Os dados abaixo devem seguir o formato esperado pelo processador de pagamento.

Campo	Tipo	Obrigatório	Descrição
holder	string	Sim	Nome impresso no cartão, sem abreviações desnecessárias. Exemplo: `MARIA CLIENTE TESTE`.
number	string	Sim	Número do cartão contendo apenas dígitos, sem espaços ou separadores. Exemplo: `4111111111111111`.
expiration_month	string	Sim	Mês de expiração com dois dígitos, de `01` a `12`.
expiration_year	string	Sim	Ano de expiração com quatro dígitos. Exemplo: `2032`.
cvv	string	Sim	Código de segurança do cartão, normalmente com 3 ou 4 dígitos.
installments	integer	Sim	Quantidade de parcelas da transação. Envie `1` para crédito à vista ou um número inteiro maior quando o parcelamento estiver habilitado.

Regras

Não utilize dados reais em exemplos, testes públicos ou materiais de documentação. Todos os exemplos desta página usam dados fictícios e devem ser substituídos por dados válidos apenas no ambiente de integração autorizado.

Saques

Descrição

Endpoint responsável pela solicitação de saque via PIX.

Endpoint

POST https://www.levorapayments.com/withdrawal/

Utilize este endpoint para solicitar um saque via PIX para a chave informada no payload.

Campos do Payload

Campo	Tipo	Obrigatório	Descrição
amount	number	Sim	Valor do saque. Exemplo: `100.00`.
key_type	string	Sim	Tipo da chave PIX do recebedor. Valores esperados: `cpf`, `email`, `phone` ou `random`.
pix_key	string	Sim	Chave PIX do recebedor, conforme o tipo informado em `key_type`.
cpf	string	Sim	Documento do titular do saque, contendo apenas números.
external_id	string	Sim	Identificador externo do saque no sistema do integrador. Exemplo: `SAQUE-0001`.

Exemplo de Payload

{
  "amount": 100.00,
  "key_type": "cpf",
  "pix_key": "12345678901",
  "cpf": "12345678901",
  "external_id": "SAQUE-0001"
}

Importante

O endpoint pode exigir autenticação. A URL correta do saque é https://www.levorapayments.com/withdrawal/.