Rede Credenciada

APIs do PDV

Conecte o caixa do seu estabelecimento ao cashback de coalizão OUROPREV®. Gere a chave no painel do credenciado e envie-a em todas as chamadas no cabeçalho Authorization: Bearer opk_…. Valores sempre em centavos.

Abrir painel do credenciado

Dados do credenciado e reserva

GET https://ouroprev.com/api/public/v1/pdv/credenciado

Resposta:

{ "partner_id": "…", "name": "Farmácia Modelo", "cashback_rate": 4, "commission_rate": 2.5, "accepts_cashback": true, "reserve_cents": 125000 }

Consultar beneficiário por CPF

GET https://ouroprev.com/api/public/v1/pdv/beneficiario?cpf=00000000000

Resposta:

{ "beneficiary_id": "…", "display_name": "Maria ***", "available_cents": 1840, "has_pin": true }

Registrar atendimento / compra

POST https://ouroprev.com/api/public/v1/pdv/vendas

Corpo (JSON):

{ "beneficiary_id": "…", "total_cents": 10000, "use_cashback_cents": 0, "payment_method": "pix", "pin": "4821", "description": "Consulta" }

Resposta:

{ "sale_id": "…", "cashback_cents": 400, "commission_cents": 250, "reserve_after_cents": 124350, "beneficiary_available_cents": 1840 }

Regras

• Para usar cashback como pagamento, envie o PIN de 4 dígitos do beneficiário. Após 5 erros o PIN é bloqueado por 15 minutos.

• O cashback e a comissão saem da reserva pré-paga; sem reserva suficiente o atendimento é recusado.

• A chave age em nome do operador que a criou; se ele for desvinculado ou a chave revogada, o acesso para.

• Estornos e saques PIX da reserva continuam feitos pelo painel do credenciado.

• Códigos: 401 chave/PIN inválido, 403 sem permissão, 404 não encontrado, 422 regra de negócio recusada.