PAINEL PRIVADO
Produtos e estoque
Estoque do fornecedor
Um gift por pedido, com validade e rastreabilidade.
ABASTECIMENTO
Importar arquivo TXT
Faça a conferência antes de confirmar. Duplicados não voltam ao estoque.
NUMBER|CRIACAO|EXPIRACAO|CODIGO|NOME|IGNORAR|IGNORAR|IGNORAR|IDENTIFICADOR
Datas: DD/MM/AAAA, AAAA-MM-DD ou data e hora ISO. O identificador agrupa os gifts no produto.
Acesso das integrações
Um IP de produção por integração. Desenvolvimento aceita vários IPs exatos.
Credenciais emitidas
Tokens duram 7 dias. Emitir outro token revoga o anterior.
UMA OPERAÇÃO, DOIS AMBIENTES
Entregar um gift
Produção: exige o IP único cadastrado e consome exatamente um gift disponível. Desenvolvimento: exige um dos IPs de teste e retorna dados fictícios.
Repita o mesmo Idempotency-Key ao tentar novamente o mesmo pedido. Gere novos timestamp, nonce e assinatura a cada tentativa. Não use tokens no URL.
{
"number": "EXEMPLO-SEM-VALOR",
"name": "Gift demonstrativo",
"validate": "2099-12-31T23:59:59-03:00",
"code": "DEMO-NOT-VALID",
"identifier": "produto-x"
}validate é a expiração. A data de criação fica registrada no estoque. Gifts vencidos, futuros, já entregues ou de produtos desativados não são disponibilizados em produção.
Validação sem consumir estoque
python send_sdk.py selftest --credentials credentials.json
O teste força a URL de desenvolvimento e usa um produto fictício reservado. Não precisa cadastrar produtos para validar a integração.
Entregas recentes
Histórico separado por ambiente. Códigos não aparecem nos registros operacionais.