Skip to main content
POST
https://api.econpay.com.br
/
payments
/
order
curl --request POST \
  --url https://api.econpay.com.br/payments/order \
  --header 'Authorization: Bearer SEU_TOKEN_JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "access_token": "SEU_ACCESS_TOKEN",
    "customer": {
      "name": "João da Silva",
      "email": "[email protected]",
      "document": "12345678900",
      "phone": {
        "country_code": "55",
        "area_code": "11",
        "number": "999999999"
      }
    },
    "items": [{
      "name": "Produto Teste",
      "quantity": 1,
      "price": 10000
    }],
    "payment": {
      "type": "pix",
      "installments": 1
    },
    "shipping": {
      "name": "Digital",
      "price": 0
    },
    "subtotal": 10000,
    "total": 10000
  }'

{
  "success": true,
  "transaction": {
    "id": 123,
    "order_number": "ORD-20240122-123456",
    "status": "PENDING",
    "amount": 10000,
    "payment_type": "pix",
    "pix_qr_code": "00020126580014br.gov.bcb.pix...",
    "pix_qr_code_url": "https://api.econpay.com.br/qrcode/123.png",
    "created_at": "2024-01-22T10:30:00Z"
  }
}

​
Descrição

Endpoint unificado para processar pagamentos. Suporta os seguintes métodos de pagamento:
  • PIX - Pagamento instantâneo com QR Code
  • Boleto - Boleto bancário registrado
Valor Mínimo: R$ 5,00 (500 centavos). Valores menores serão rejeitados.
Valores em Centavos: Todos os valores monetários devem ser enviados em centavos. R$ 100,00 = 10000 centavos.

​
Headers

​
Authorization
string
required
Bearer token JWT obtido no login

​
Request Body

​
access_token
string
required
Token de acesso do estabelecimento (obtido no dashboard)
​
payment_link_id
string
ID do link de pagamento (opcional)
​
customer
object
required
Dados do cliente
​
items
array
required
Lista de itens do pedido
​
payment
object
required
Dados do pagamento
​
shipping
object
required
Dados de envio
​
subtotal
number
required
Subtotal em centavos (soma dos itens)
​
total
number
required
Total em centavos (subtotal + frete)
​
splitParticipants
array
Participantes do split (opcional, para divisão de valores)

​
Response

​
success
boolean
Indica se a operação foi bem-sucedida
​
transaction
object
curl --request POST \
  --url https://api.econpay.com.br/payments/order \
  --header 'Authorization: Bearer SEU_TOKEN_JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "access_token": "SEU_ACCESS_TOKEN",
    "customer": {
      "name": "João da Silva",
      "email": "[email protected]",
      "document": "12345678900",
      "phone": {
        "country_code": "55",
        "area_code": "11",
        "number": "999999999"
      }
    },
    "items": [{
      "name": "Produto Teste",
      "quantity": 1,
      "price": 10000
    }],
    "payment": {
      "type": "pix",
      "installments": 1
    },
    "shipping": {
      "name": "Digital",
      "price": 0
    },
    "subtotal": 10000,
    "total": 10000
  }'

{
  "success": true,
  "transaction": {
    "id": 123,
    "order_number": "ORD-20240122-123456",
    "status": "PENDING",
    "amount": 10000,
    "payment_type": "pix",
    "pix_qr_code": "00020126580014br.gov.bcb.pix...",
    "pix_qr_code_url": "https://api.econpay.com.br/qrcode/123.png",
    "created_at": "2024-01-22T10:30:00Z"
  }
}

​
Métodos de Pagamento

​
Pagamento PIX

  • Aprovação instantânea (geralmente em segundos)
  • QR Code válido por 30 minutos
  • Disponível 24/7
  • Sem taxas para o cliente final
Resposta inclui:
  • pix_qr_code: String EMV do QR Code
  • pix_qr_code_url: URL da imagem do QR Code
Status:
  • PENDING: Aguardando pagamento
  • APPROVED: Pago (webhook enviado)

​
Próximos Passos

Reembolso

Processar estornos

Webhooks

Receber notificações

Listar Transações

Consultar pagamentos

Erros

Códigos de erro