Quickstart

Este guia mostra o caminho mínimo para criar um pagamento e acompanhar o resultado.

1. Configure os headers

Authorization: Bearer <token-da-loja>
ocp-apim-subscription-key: <gateway-token>
Content-Type: application/json

Use token de loja para operações de pagamento. Token de integrador é reservado para gestão de lojas vinculadas.

2. Crie um pagamento

POST /smarttef/commands/erp/order/create

Envie os dados da cobrança e, quando necessário, direcione a ordem para um usuário ou terminal específico. Consulte os campos em Card de pagamento.

3. Guarde o identificador

Armazene o identificador retornado pela API, como payment_identifier, para consultas futuras, conciliação e suporte.

4. Consulte o status

POST /smarttef/pooling/erp/order/get

Consulte a ordem até que ela chegue a um status final, como CNC, CAN_ERP, REJ_PAG, EST ou REJ_EST.

5. Configure webhook quando necessário

Para reduzir polling, configure o webhook da loja e receba callbacks automáticos de mudança de status.

Veja Webhook para payloads, reprocessamento e boas práticas.

Próximos passos

• Revise Autenticação para entender tokens e escopos.
• Consulte Referência para status, tipos de pagamento e convenções.
• Use API Reference para ver endpoints e contratos detalhados.