{
"webhook_type": "wallet_transaction.payment_failure",
"object_type": "payment_provider_wallet_transaction_payment_error",
"organization_id": "00000000-0000-4000-8000-000000000001",
"payment_provider_wallet_transaction_payment_error": {
"wallet_transaction_id": "00000000-0000-4000-8000-000000000002",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "vfy-rest-c1",
"provider_customer_id": "cus_example",
"payment_provider": null,
"payment_provider_code": null,
"provider_error": {
"message": "Your card was declined.",
"error_code": "card_declined"
}
}
}Wallets and Credits
A payment attempt for a wallet transaction has failed on a payment provider
The payment for a wallet top-up fails at the provider. provider_error says why.
WEBHOOK
wallet_transaction_payment_failure
{
"webhook_type": "wallet_transaction.payment_failure",
"object_type": "payment_provider_wallet_transaction_payment_error",
"organization_id": "00000000-0000-4000-8000-000000000001",
"payment_provider_wallet_transaction_payment_error": {
"wallet_transaction_id": "00000000-0000-4000-8000-000000000002",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "vfy-rest-c1",
"provider_customer_id": "cus_example",
"payment_provider": null,
"payment_provider_code": null,
"provider_error": {
"message": "Your card was declined.",
"error_code": "card_declined"
}
}
}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 and of the provider error
Available options:
wallet_transaction.payment_failure Available options:
payment_provider_wallet_transaction_payment_error 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.