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