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.

    Syntax

    {
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
      "changes": [
        {
          "field": "payment_configuration_update",
          "value": {
            "configuration_name": "<PAYMENT_CONFIGURATION_NAME>",
            "provider_name": "<PAYMENT_GATEWAY_PROVIDER_NAME>",
            "provider_mid": "<PAYMENT_GATEWAY_MERCHANT_ACCOUNT_ID>",
            "status": "<PAYMENT_CONFIGURATION_STATUS>",
            "created_timestamp": <PAYMENT_CONFIGURATION_CREATION_TIMESTAMP>,
            "updated_timestamp": <PAYMENT_CONFIGURATION_UPDATE_TIMESTAMP>
          }
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}
    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
      {
  "entry": [
    {
      "id": "102290129340398",
      "time": 1739321024,
      "changes": [
        {
          "field": "payment_configuration_update",
          "value": {
            "configuration_name": "razorpay-prod",
            "provider_name": "razorpay",
            "provider_mid": "acc_GP4lfNA0iIMn5B",
            "status": "Needs Testing",
            "created_timestamp": 1748827100,
            "updated_timestamp": 1749320300
          }
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}
      
    
              
      
        
      
    
      
        
      
            
      
                
                
      
                    
                    
                
      
            
      
            
            
      
                                            
      
        
      
    
      

    

      
    
      

    
            
      
            
      

    
      
        
      
            
            
        
      
            
      

    
      
        
      
                    
      

        
      No comments to display
      

            
      

    

    

                  
      
        
      
                
      
        
      
    
      

    
      

    
    
      
        
      
             Back to top