Pedidos Físicos (Maquininhas)

Nesta página, você encontrará informações sobre os Webhooks de pedidos físicos/maquininhas (PHYSICAL_ORDER).

Formato v1 em descontinuação. A partir de 10/08/2026, o formato v1 será descontinuado. Todos os sellers deverão estar integrados ao Webhook v2. Sellers que ainda não possuem integração ativa devem integrar diretamente pelo novo modelo.

---

O domínio PHYSICAL_ORDER representa transações realizadas via maquininha (POS). Ele segue exatamente a mesma estrutura de payload de ORDER, incluindo campos, formato e comportamento — diferindo apenas por trazer informações adicionais do terminal físico.

---

Diferenças principais

Campo	ORDER	PHYSICAL_ORDER
domain	ORDER	PHYSICAL_ORDER
origem	Cobrança online	Venda física via maquininha
status possíveis	SENT, ABANDONED, PAID, CANCELED, LATE, PARTIALLY_PAID, REFUND, CHARGEBACK, PRE_AUTHORIZED	SENT, ABANDONED, PAID, CANCELED, LATE, PARTIALLY_PAID, REFUND, CHARGEBACK, PRE_AUTHORIZED
campos extras	—	serial_number, pos_id, brand, holderName, first4_digits, last4_digits, rate, payment_type, installments

---

Status válidos

Physical Orders (PHYSICAL_ORDER)

• SENT
• PRE_AUTHORIZED
• PARTIALLY_PAID
• PAID
• CANCELED
• REFUND
• LATE
• CHARGEBACK
• ABANDONED

🔸 Pedidos com status LATE há mais de 90 dias são automaticamente marcados como ABANDONED.

---

Estrutura do Payload

Abaixo está um exemplo de payload enviando no Webhook de maquininhas.

{
  "uuid": "c21d64be-5bae-476e-b8d4-9dc373c5afaf",
  "dateTime": "2025-10-21T16:40:55.000Z",
  "status": "PAID",
  "domain": "PHYSICAL_ORDER",
  "amount": "1397.20",
  "installments": "12",
  "first4_digits": "6550",
  "last4_digits": "2921",
  "holderName": "AGUIAR/HILDA B",
  "brand": "ELO CREDITO",
  "authorization_code": "107734",
  "authorization_nsu": "311000210",
  "pos_id": "00000393",
  "cnpj": "31228966000104",
  "company_name": "Carla Marieli Delmiro Capeli Ltda",
  "idSeller": 14161,
  "serial_number": "PB1S24C176607",
  "payment_type": "credit",
  "rate": 9.9
}

---

Campos específicos de POS

Campo	Descrição
serial_number	Número de série da maquininha utilizada na transação.
pos_id	Identificador do terminal POS.
brand	Bandeira e modalidade (ex.: ELO CREDITO).
holderName	Nome impresso no cartão do portador.
first4_digits / last4_digits	Dígitos iniciais e finais do cartão utilizado.
installments	Número de parcelas da compra.
payment_type	Tipo de pagamento (credit, debit, etc.).
rate	Percentual de taxa aplicada na operação.

Em caso de dúvidas, entre em contato com o nosso time através do suporte disponibilizado.