Loading...

Payment Failed

Fired when a Credit Card or Direct Debit payment fails to process.

GET https://api.getAddress.io/webhook/payment-failed/{id}?api-key={admin-key} 
GET https://api.getAddress.io/webhook/payment-failed?api-key={admin-key} 
POST https://api.getAddress.io/webhook/payment-failed?api-key={admin-key} 
POST https://api.getAddress.io/webhook/payment-failed/test?api-key={admin-key} 
DELETE https://api.getAddress.io/webhook/payment-failed?api-key={admin-key}
Examples

Adds URL (endpoint) to be called

Request

POST https://api.getAddress.io/webhook/payment-failed?api-key={admin-key}

Request Body

{
    "url": "https://your-domain.com/action"
}

Response 200

{
    "message": "Webhook : 'https://your-domain.com/action' has been created.",
    "id": "1"
}
Test

Sends a webhook to each added endpoint.

Request

POST https://api.getAddress.io/webhook/payment-failed/test?api-key={admin-key}

Response 200

{
    "message": "Webhook has been sent"
}

Data sent to each added endpoint in the request body

{
    "version":"1.0.0.0",
    "action":"payment_failed",
    "created_at":10/31/2025 6:49:36 AM,
    "details":
    {
        "update_card_details_link":"https://getaddress.io/updatecarddetails?emailaddress=your-email-address@domain.com"
    },
    "type":"billing"
}
Top