API

Premiação dentro do seu sistema

Crie pedidos e acompanhe cada entrega a partir do seu sistema. Webhooks avisam quando o status muda, e ninguém precisa conferir planilha.

Painel da plataforma LinkPrêmio: Palco aurora

Requisição

Resposta

Webhook

api.linkpremio.com.br

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Painel da plataforma LinkPrêmio: Palco aurora

Requisição

Resposta

Webhook

api.linkpremio.com.br

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

  • Logos de clientes do LinkPrêmio: Coca-Cola, Nestlé, Mondelez, Tele Sena, Ypê, Bombril, LUX, Hershey's, Philips e Tang

Recursos

Da criação do pedido ao status de cada entrega

Requisição

Resposta

Webhook

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Requisição

Resposta

Webhook

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Criar pedidos

Envie premiados, valores e canal a partir do seu sistema. O pedido passa pelas mesmas validações de CPF, valor e canal.

Premiados e valores por chamada

Validação de CPF, valor e canal

Envio em lote por API

Requisição

Resposta

Webhook

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Requisição

Resposta

Webhook

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Acompanhar entregas

Consulte o status de cada premiado e de cada lote sem sair do seu sistema.

Status por premiado

Status por lote

Mesmos dados dos relatórios

Requisição

Resposta

Webhook

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Requisição

Resposta

Webhook

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Webhooks

O seu sistema recebe um aviso quando uma entrega muda de status e segue para a próxima etapa da operação.

Aviso a cada mudança de status

Menos consulta manual

Conectado ao seu fluxo

Para desenvolvedores

Um pedido de premiação em poucas linhas

Crie o pedido com uma chamada e receba o status da entrega por webhook. A documentação traz os detalhes de cada campo.

POST /pedidos

{

“campanha”: “Ativação Verão · Aurora PDV”,

“canal”: “whatsapp”,

“premiados”: [

{ “nome”: “Marina Alves”, “cpf”: “000.000.000-00”,

“valor”: 150.00, “forma”: “cartao” }

]

}

webhook · entrega.status_alterado

{ “premiado”: “Marina Alves”, “status”: “entregue” }

POST /pedidos

{

“campanha”: “Ativação Verão · Aurora PDV”,

“canal”: “whatsapp”,

“premiados”: [

{ “nome”: “Marina Alves”, “cpf”: “000.000.000-00”,

“valor”: 150.00, “forma”: “cartao” }

]

}

webhook · entrega.status_alterado

{ “premiado”: “Marina Alves”, “status”: “entregue” }

Requisição

Resposta

Webhook

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Requisição

Resposta

Webhook

1

POST /webhooks/linkpremio

2

Host: grupoaurora.com.br

3

X-LinkPremio-Event: order.delivered

4

X-LinkPremio-Signature: sha256=8f1c••••

5

6

{

7

"event": "order.delivered",

8

"order_id": "ord_9f2k7d",

9

"recipient": { "cpf": "***.482.917-**" },

10

"delivery": "pix",

11

"amount": 350.00,

12

"delivered_at": "2026-09-22T14:03:11Z",

13

"receipt": "linkpremio.com.br/r/8f1c"

14

}

order.delivered

entregue em 13 s

Como funciona

Do seu sistema ao premiado em três passos

Conecte o seu sistema

01

Use a API para enviar os pedidos direto da sua operação.

Crie o pedido

02

Receba o status por webhook

03

Perguntas frequentes

Ficou alguma dúvida? A gente responde.

Ainda tem perguntas?

Fale com o nosso time comercial.

O que dá para fazer pela API?

Criar pedidos de premiação e acompanhar a entrega de cada premiado pelo seu sistema. Webhooks avisam quando o status de uma entrega muda.

A API passa pelas mesmas validações do painel?

Como recebo o status das entregas?

Posso enviar pedidos em lote pela API?

Onde encontro a documentação?

Preciso da API para usar a LinkPrêmio?

Pronto para premiar a sua próxima campanha?

Pronto para premiar a sua próxima campanha?

Agências e empresas usam a LinkPrêmio para entregar prêmio em escala, com nota fiscal e acompanhamento de cada premiado.

LinkPrêmio

Plataforma de premiação para campanhas de incentivo e promoção.

© 2026 LinkPrêmio, uma solução Hub4Pay

LinkPrêmio