See how it works: Notify your server with callbacks

Notify your system when someone finishes

Signed callbacks to integrate with your panel.

1 minute read

On this page

Send signed outcomes to the recruitment system.

Purpose

Confirm outcomes on the server in addition to the browser redirect.

When to use it

When the panel has an HTTPS endpoint for receiving events.

Before you start

  • An authorized HTTPS endpoint
  • Technical support to validate signatures and duplicates

Example

Record completion for the received token only once.

Step by step

  1. Enter endpoint. In the panel card under Share, enter the HTTPS callback URL supplied by your technical team. Your server endpoint.
  1. Generate secret. Generate the secret and store it securely at the receiver. Do not place it in a public link or participant code. Shown once.
  1. Validate receipt. The technical team validates X-UXTap-Signature over the received body using HMAC SHA-256 and processes each outcome idempotently. Valid signature · No duplicate processing.
  1. Review deliveries. Validate completion, disqualification and quota full. In the card history, check server responses and fix errors before broad collection. Retries need a working receiver.

How to read the result

  • Events sent with an HMAC signature
  • Recent delivery history in the card

Cautions and limitations

  • Store the secret when shown: it will not be displayed again.
  • The receiver must handle retries without duplicating rewards.

Continue with the interactive guide

Notify your server with callbacks

Was this helpful?

Is something missing? Write to contato@uxtap.app.