Wallet Webhooks

The Webhooks API allows you to subscribe to be notified about events that happen in your Juice USDC wallet and its associated wallets. Rather than making an API call when an event happens in a connected wallet, Juice can send an HTTP request to an endpoint you configure.

📘

Soon to come: You'll be able to configure your webhooks from the Juice dashboard, where a user interface will be provided for you to register and test your webhook endpoints.

Webhooks Type

You'll be able to get updates on your wallet in these events:

• When an address on your wallet receives a credit transaction.
• When an address on your wallet sends out a transaction.

Setting Up Webhooks

During registration, Please enter a URL you would like to receive notifications on. See webhook_url in the code sample below.

curl --location --request POST 'sandbox.spendjuice.org/crypto-integrators/register-integrator' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJqdWljZSIsImV4cCI6MTY1MzA4NjMwNCwiaWF0IjoxNjM3NTM0MzA0LCJpc3MiOiJqdWljZSIsImp0aSI6ImI1M2VmZDVjLTdiMjgtNGMxNS04YWZiLTg3ZmNkOTAyOTBhYiIsIm5iZiI6MTYzNzUzNDMwMywic3ViIjoiY3J5cHRvLWludGVncmF0b3I6MDE4ZGM2YjAtMDgzOC00OTYzLWI3MDEtOTUwODllMGE2NjA1IiwidHlwIjoiYWNjZXNzIn0.enxQXtu4bVqR9PMNcrOTuONGHnRN2TNWM2E1JWwtSE-A4L0P1x46af4bTrnUDUVzjFcR8ydc7cCBCOiPZF19Ig' \
--header 'Content-Type: application/json' \
--data-raw '{
    "business_name": "Int Inc",
    "chain": "ETH",
    "contact_number": "+2348123456789",
    "country": "NGA",
    "domain": "https://intinc.com",
    "email": "[email protected]",
    "first_name": "Inte",
    "last_name": "Grator",
    "password": "P@ssw0rd!",
    "registration_number": "1289738",
    "webhook_url": "https://sandbox.intinc.com",
    "business_address": "Elegushi Lagos"
}'

As seen above, the webhook payload has an event property that identifies what the event is about, and the data attribute contains the event data.

The sample data above shows a sample JSON body for a card transaction event.