Skip to main content

payment_configuration_update webhook reference | Developer Documentation

payment_configuration_update webhook reference

Updated: Oct 22, 2025
This reference describes trigger events and payload contents for the WhatsApp Business Account payment_configuration_update webhook.
The payment_configuration_update webhook notifies you of changes to payment configurations for Payments API India and Payments API Brazil.

Triggers

    The payment configuration associated with a WhatsApp Business Account has been connected to a payment gateway account.The payment configuration associated with a WhatsApp Business Account has been disconnected from a payment gateway account.The payment configuration associated with a WhatsApp Business Account is now active.

    Parameters

    Placeholder Description Example value
    <PAYMENT_CONFIGURATION_CREATION_TIMESTAMP>
    Integer
    UNIX timestamp indicated when the payment configuration was created.
    1748827100
    <PAYMENT_CONFIGURATION_NAME>
    String
    Payment configuration name to be used in the Order Details messages.
    razorpay-prod
    <PAYMENT_CONFIGURATION_STATUS>
    String
    Payment configuration status.
    Values can be:
    Active - Indicates the payment configuration has been tested in WhatsApp manager and can now be used with Payments API.
    Needs Connecting - Indicates the payment configuration has been disconnected from the payment gateway and needs to be connected again.
    Needs Testing - Indicates the payment configuration has been connected to the payment gateway but still needs testing in WhatsApp Manager.
    Needs Connecting
    <PAYMENT_CONFIGURATION_UPDATE_TIMESTAMP>
    Integer
    UNIX timestamp indicated when the payment configuration was updated.
    1749320300
    <PAYMENT_GATEWAY_MERCHANT_ACCOUNT_ID>
    String
    Payment gateway merchant account ID.
    acc_GP4lfNA0iIMn5B
    <PAYMENT_GATEWAY_PROVIDER_NAME>
    String
    Name of the payment gateway provider associated with the payment configuration. Values can be:
      billdeskpayurazorpayzaakpay
      razorpay
      <WEBHOOK_TRIGGER_TIMESTAMP>
      Integer
      Unix timestamp indicating when the webhook was triggered.
      1739321024
      <WHATSAPP_BUSINESS_ACCOUNT_ID>
      String
      WhatsApp Business Account ID.
      102290129340398

      Example payload

      

      
    
              
      
    
      

            
      
        
      
    
      

    
      

    
    
      
        
      
             Back to top