{
"webhook_type": "wallet_transaction.created",
"object_type": "wallet_transaction",
"organization_id": "00000000-0000-4000-8000-000000000001",
"wallet_transaction": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"wallet_id": "00000000-0000-4000-8000-000000000003",
"invoice_id": null,
"credit_note_id": null,
"voided_invoice_id": null,
"status": "settled",
"source": "manual",
"transaction_status": "granted",
"transaction_type": "inbound",
"amount": "10.0",
"credit_amount": "10.0",
"remaining_amount_cents": 1000,
"remaining_credit_amount": "10.0",
"priority": 50,
"settled_at": "2026-10-13T00:18:38Z",
"failed_at": null,
"created_at": "2026-10-13T00:18:38Z",
"invoice_requires_successful_payment": false,
"metadata": [],
"name": null,
"wallet": {
"nozle_id": "00000000-0000-4000-8000-000000000003",
"customer_id": "00000000-0000-4000-8000-000000000004",
"external_customer_id": "vfy-rest-c1",
"status": "terminated",
"currency": "USD",
"name": "x4",
"code": "vfy-rest-wallet",
"rate_amount": "1.0",
"credits_balance": "13.0",
"credits_ongoing_balance": "13.0",
"credits_ongoing_usage_balance": "0.0",
"balance_cents": 1300,
"ongoing_balance_cents": 1300,
"ongoing_usage_balance_cents": 0,
"consumed_credits": "0.0",
"created_at": "2026-10-13T00:18:38Z",
"expiration_at": null,
"last_balance_sync_at": "2026-10-13T00:18:39Z",
"last_consumed_credit_at": null,
"terminated_at": "2026-10-13T00:23:07.431Z",
"invoice_requires_successful_payment": false,
"paid_top_up_min_amount_cents": null,
"paid_top_up_max_amount_cents": null,
"priority": 50,
"payment_method": {
"payment_method_id": null,
"payment_method_type": "provider"
}
},
"payment_method": {
"payment_method_id": null,
"payment_method_type": "provider"
}
}
}Wallets and Credits
A new wallet transaction has been created
A wallet transaction (a top-up, a grant or a void) is created.
WEBHOOK
wallet_transaction_created
{
"webhook_type": "wallet_transaction.created",
"object_type": "wallet_transaction",
"organization_id": "00000000-0000-4000-8000-000000000001",
"wallet_transaction": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"wallet_id": "00000000-0000-4000-8000-000000000003",
"invoice_id": null,
"credit_note_id": null,
"voided_invoice_id": null,
"status": "settled",
"source": "manual",
"transaction_status": "granted",
"transaction_type": "inbound",
"amount": "10.0",
"credit_amount": "10.0",
"remaining_amount_cents": 1000,
"remaining_credit_amount": "10.0",
"priority": 50,
"settled_at": "2026-10-13T00:18:38Z",
"failed_at": null,
"created_at": "2026-10-13T00:18:38Z",
"invoice_requires_successful_payment": false,
"metadata": [],
"name": null,
"wallet": {
"nozle_id": "00000000-0000-4000-8000-000000000003",
"customer_id": "00000000-0000-4000-8000-000000000004",
"external_customer_id": "vfy-rest-c1",
"status": "terminated",
"currency": "USD",
"name": "x4",
"code": "vfy-rest-wallet",
"rate_amount": "1.0",
"credits_balance": "13.0",
"credits_ongoing_balance": "13.0",
"credits_ongoing_usage_balance": "0.0",
"balance_cents": 1300,
"ongoing_balance_cents": 1300,
"ongoing_usage_balance_cents": 0,
"consumed_credits": "0.0",
"created_at": "2026-10-13T00:18:38Z",
"expiration_at": null,
"last_balance_sync_at": "2026-10-13T00:18:39Z",
"last_consumed_credit_at": null,
"terminated_at": "2026-10-13T00:23:07.431Z",
"invoice_requires_successful_payment": false,
"paid_top_up_min_amount_cents": null,
"paid_top_up_max_amount_cents": null,
"priority": 50,
"payment_method": {
"payment_method_id": null,
"payment_method_type": "provider"
}
},
"payment_method": {
"payment_method_id": null,
"payment_method_type": "provider"
}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Signature of the webhook payload
Example:
"Ap¶5ɿΣ6ÐfV£Ä\u0015\u0015ºõÔõÔ[DæAâÿüÚ"
Algorithm used to generate the signature
Available options:
jwt, hmac Example:
"hmac"
Unique id of the webhook. It can be used for idempotency
Example:
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Body
application/json
Details of the wallet transaction
Available options:
wallet_transaction.created Available options:
wallet_transaction Unique identifier of the organization, created by Nozle.
Example:
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Show child attributes
Show child attributes
Response
200
Return a 2xx status within 30 seconds to acknowledge the delivery. Any other status, a timeout or a connection error is a failed attempt; Nozle makes up to 3 attempts.