Quando usar webhooks de reserva
Use isso para inventário COMPLEXO (unidade única) quando você gerar chaves ou contas em seu próprio sistema no momento da compra. Estoque local é sempre preferido; o webhook preenche apenas a falta.
- Funciona apenas com entrega automática INSTANTÂNEA quando cada unidade está realmente atribuída.
- Configure um padrão de nível de oferta ou substitua por opção de preço.
- Apenas HTTPS. A assinatura HMAC opcional corresponde aos webhooks de saída.
Falhas seguras para pagamento
Se seu endpoint expirar ou retornar dados inválidos, o pedido permanece PAGO. O comprador é cobrado; você verá um erro no pedido e pode tentar reservar novamente ou anexar chaves manualmente.
Solicitar contrato
Após o pagamento, a RMT POSTa uma chamada reserve.item por unidade faltante com pedido, oferta, opção, esquema de campo e quantidade 1. O JSON do modelo de solicitação opcional é mesclado com {{placeholders}}.
Corpo POST canônico (truncado)
{
"id": "rsv_…",
"type": "reserve.item",
"order": { "uid": "…", "reference": "…", "url": "…" },
"offer": { "url": "…", "title": "…", "pageUrl": "…" },
"option": { "id": 1, "name": "Padrão" },
"fields": [{ "id": 10, "name": "Licença", "type": "text", "required": true }],
"quantity": 1
}Resposta e mapeamento de campo
Retorne 2xx JSON. Mapeie caminhos como $.license para campos de Item, ou retorne { "entries": [{ "fieldId": 10, "value": "KEY-…" }] }.
Resposta de conveniência
{
"entries": [
{ "name": "Licença", "value": "AAAA-BBBB-CCCC" }
]
}- Apenas licença: mapeie um campo de texto de $.license ou $.key.
- Conta: mapeie campos de e-mail e senha de $.email e $.password.
- Campos obrigatórios ausentes após o mapeamento contam como falha.
Teste, tente novamente e segurança
Use Testar no editor de ofertas (envia dryRun: true). Na página do pedido, Tente reservar novamente após corrigir seu endpoint. Nunca registre segredos ou chaves completas em e-mails.
- 1Salve a URL HTTPS, o mapeamento de resposta e o segredo opcional na etapa Itens da oferta.
- 2Execute o Teste e confirme as prévias mapeadas.
- 3Em caso de falha, abra o pedido, tente reservar novamente ou crie/atribua uma chave manualmente.
Não chame a reserva antes do pagamento
A RMT só chama seu endpoint após o pagamento ser bem-sucedido, então checkouts abandonados não queimam licenças.