Para iniciar uma transação em um terminal integrado, você deve utilizar o endpoint de criação de pedido. Este comando enviará as informações da venda para a POS.

Requisitos Obrigatórios

Para que um pedido seja visível e processável pelo POS, ele deve conter obrigatoriamente:

• closed: false: O pedido deve ser criado como "aberto".
• poi_payment_settings: Este objeto deve estar preenchido para habilitar o fluxo no terminal.
• ServiceRefererName: Identificador da integração.

📘

ServiceRefererName

O campo ServiceRefererName é essencial para a rastreabilidade e identificação da origem da requisição dentro do ecossistema Stone/Pagar.me.

Onde extrair o valor: Este valor é o identificador único do parceiro definido durante o processo de homologação/cadastro no Partner Hub.

Importância: Sem este campo preenchido corretamente, a requisição pode ser rejeitada ou não ser roteada adequadamente para os terminais vinculados ao seu Stone Code.

📘

Tipo de parcelamento (installment_type)

merchant: o custo do parcelamento fica sob responsabilidade do estabelecimento. É o tipo mais comum de parcelamento.

issuer: o custo do parcelamento é definido pelo emissor do cartão do portador. Para mais informações, sobre juros emissor.

Para utilizar o juros parcelado pelo emissor é preciso primeiro ativar a opção nos ajustes da maquininha.

🚧

Limitação de pagamentos no POS

É importante ressaltar que não há limite de pagamentos para pedidos no fluxo de pagamento Listagem de Pedidos. Isso significa que o sistema do POS não restringe o operador em relação a quantidade de transações e em relação ao valor das transações por pedido.

Por exemplo, foi criado um pedido em aberto de R$ 5,00. Para esse pedido o operador do POS pode realizar 2 pagamentos de R$ 4,00, totalizando R$ 8,00 pagos.

O valor da transação por default no POS é sempre o valor total do pedido, mas o operador pode sobrescrever o valor default caso o comprador queira pagar de forma diferente. Isso garante uma maior flexibilidade no momento do pagamento.

No fluxo de Pagamento direto de pedidos, o valor pago é sempre o valor total do pedido. O sistema não permite pagamentos de outros valores.

📘

Pagamento Direto

Neste modelo de integração é obrigatório enviar os parâmetros no objeto de payment_setup. Veja exemplo Aqui!

❗️

Cartão Banricompras

Sugerimos restringir a aceitação da bandeira Banricompras.