Customer Events

Customer Events are webhook notifications from GETTRX One that provide real-time updates about customer accounts. These events help you track the creation, modification, and removal of customer records, ensuring your system remains up-to-date and synchronized with customer activities.

By subscribing to these events, you can automate customer management workflows, maintain accurate records, and provide timely updates to merchants or stakeholders.

Key Customer Webhook Events

Customer Created (customer.created)

Occurs when a new customer account is created. Use this event to initialize customer profiles in your system, send welcome notifications, or trigger onboarding workflows.

{  
    account: "acm_65f48b068b8d6912fe07f555",  
    attemptId: "wha_674f912cf7f75d7de084aa0c",  
    created: "1733267345",  
    "data": {  
        "object": {  
            id: "cus_674f8ebeb6d07a3f7b6cf555",  
            "address": {  
                city: "West Eladiofurt",  
                country: "SA",  
                line1: "57556 Paxton Keys Suite 337",  
                line2: "50820 Mill Road Suite 583",  
                postalCode: "12782",  
                state: "Michigan"  
            },  
            created: 1733267134,  
            description: "patriot",  
            email: "[[email protected]](mailto:[email protected])",  
            invoicePrefix: "D817FED4",  
            "invoiceSettings": {  
                "customFields": \[],  
                defaultPaymentMethod: "",  
                footer: ""  
            },  
            name: "Alejandra",  
            phone: "GW 1663954111",  
            "shipping": {  
                "address": {  
                    city: "Eliasville",  
                    country: "US",  
                    line1: "8892 Gutmann Gateway Apt. 488",  
                    line2: "3988 Lauren Creek Suite 138",  
                    postalCode: "11857",  
                    state: "US-IN"  
                },  
                name: "Hannah Shanahan",  
                phone: "GL 1587872490"  
            },  
            object: "customer"  
        }  
    },  
    id: "evt_674f8f91778c0c7274a6636c",  
    object: "event",  
    "request": {},  
    type: "customer.created"  
}

Customer Updated (customer.updated)

Occurs when a customer's details are modified, such as changes to their contact information or preferences. This event ensures your system reflects the most current customer data.

{
    account: "acm_65f48b068b8d6912fe07f000",
    attemptId: "wha_66ad5974d6f90cfdce71e27e",
    created: "1722636646",
    "data": {
        "object": {
            id: "cus_66ad2efc93cccf50d08ac5ac",
            _object: "customer",
            "address": {
                city: "Torrance",
                country: "MX",
                line1: "",
                line2: "",
                postalCode: "",
                state: "MX"
            },
            created: 1722625788,
            description: "description",
            email: "[email protected]",
            invoicePrefix: "D817FED4",
            "invoiceSettings": {
                defaultPaymentMethod: "pm_66ad2f8e60f2a24375837619"
            },
            name: "Test",
            phone: "8336971128",
            "shipping": {
                "address": {
                    city: "Torrance",
                    country: "MX",
                    line1: "",
                    line2: "",
                    postalCode: "",
                    state: "MX"
                },
                name: "Ryan",
                phone: "7248978912 "
            }
        },
        "previousAttributes": {}
    },
    id: "evt_66ad596722627a3dd0f30795",
    object: "event",
    "request": {
        idempotencyKey: "118d7cf6-bdf0-402f-abfa-3fc43bf02f43"
    },
    type: "customer.updated"
}
type: "refund.pending"
}

Customer Deleted (customer.deleted)

Occurs when a customer account is removed. Use this event to clean up records, adjust reporting, or notify relevant stakeholders of the deletion.

{
    account: "acm_65f48b068b8d6912fe07f000",
    attemptId: "wha_6793def01283ad382541041b",
    created: "1737744111",
    "data": {
        "object": {
            id: "cus_6793deef08af0b41b6d3b612",
            _object: "customer",
            "address": {
                city: "Schowaltercester",
                country: "MP",
                line1: "85527 Vicarage Lane Apt. 181",
                line2: "582 Rippin Estates Apt. 625",
                postalCode: "09852",
                state: "Indiana"
            },
            created: 1737744111,
            description: "engineer, author, creator 🇨🇨",
            email: "[email protected]",
            invoicePrefix: "D817FED4",
            "invoiceSettings": {
                "customFields": [
                    {
                        name: "demulceo",
                        value: "aegrotatio"
                    }
                ],
                defaultPaymentMethod: "",
                footer: "withdrawal transaction at Boyer, Konopelski and Abbott using card ending with ***(...7445) for MGA 93.29 in account ***09835275"
            },
            name: "Owen",
            phone: "NE 2365095768",
            "shipping": {
                "address": {
                    city: "North Landen",
                    country: "US",
                    line1: "3692 River Road Apt. 252",
                    line2: "5791 Mill Street Suite 814",
                    postalCode: "35789",
                    state: "US-CO"
                },
                name: "Joe Pacocha",
                phone: "GM 7570490471"
            }
        }
    },
    id: "evt_6793deef08af0b41b6d3b617",
    object: "event",
    "request": {},
    type: "customer.deleted"
}

Best Practices for Customer Events

Automate Onboarding:

Use customer.created to initiate onboarding processes, such as sending welcome emails or assigning account managers. Automatically populate customer records in your system when new accounts are created.

Keep Data Current:

Update customer records promptly when receiving a customer.updated event. Use this event to trigger notifications about profile changes, such as updated contact details.

Maintain Accurate Records:

Use customer.deleted to ensure obsolete or inactive customer accounts are removed from your system. Archive data or trigger compliance-related workflows when a customer is deleted.

Enhance Merchant Support:

Provide merchants with visibility into customer lifecycle events, such as account creation or updates. Notify merchants of changes that may impact their business, like deleted accounts.

By integrating Customer Events into your workflows, you can ensure a seamless customer experience, enhance data accuracy, and maintain synchronization between GETTRX One and your platform.