As part of our pricing update, we will be expanding authentication-international rates to seven new markets on February 1, 2025.
Specific countries have an authentication-international rate in our rate cards. If you open an authentication conversation with a WhatsApp user whose country calling code is for a country that has an authentication-international rate, you will be billed that country's authentication–international rate if:
Webhooks that include pricing details will indicate if a conversation was billed at the authentication-international rate, and these conversations will be reflected in conversation analytics.
For example, if your business is based in Indonesia and you open an authentication conversation with a WhatsApp user who has a +62 (Indonesia) country calling code, you will not be billed the authentication-international rate, since you are based in the same country as the user. If your business is based in India, however, you will be billed the authentication-international rate, if you meet all of the criteria above.
See Examples for additional example scenarios.
If your business opens more than 750K conversations in a moving 30-day period across all of your WhatsApp Business Accounts with WhatsApp users whose country calling codes are for a country that has an authentication-international rate, it will be deemed eligible for authentication-international rates.
Once deemed eligible, we will set your start times 30 days out for each country that has an authentication-international rate. In addition, we will attempt to determine your primary business location using publicly-available information.
We will then send you an eligibility email that includes these start times and the country that we set as your primary business location (if we were able to determine the country). This provides you with 30 days notice before authentication-international rates apply. Webhooks will also be triggered that include your start times and your primary business location (if we set it).
Note that eligibility is permanent. Once your business is deemed eligible, all authentication conversations opened on or after your start time will be charged the authentication-international rate in markets where authorization-international rates apply.
Start times are business- and country-specific timestamps. They indicate when newly-opened authentication conversations are subject to authentication-international rates. Authentication conversations opened by your business with WhatsApp users in these countries on or after these dates only will be charged authentication-international rates.
Start times are set when your business is first deemed eligible for authentication-international rates, and are 30 days from your eligibility date, so you will always have 30-days notice before the authentication-international rate applies.
Start times are included in your eligibility email and webhooks. You can also get these times by requesting the auth_international_rate_eligibility
field on any of your business's WhatsApp Business Accounts:
GET /<WABA_ID>?fields=auth_international_rate_eligibility
{ "id": "<WABA_ID>", "auth_international_rate_eligibility": { "start_time": <START_TIME_INDIA>, "exception_countries": [ { "country_code": "ID", "start_time": <START_TIME_INDONESIA> } ] } }
<WABA_ID>
— WhatsApp Business Account ID.<START_TIME_INDIA>
— Unix timestamp indicating India start time.<START_TIME_INDONESIA>
— Unix timestamp indicating Indonesia start time.Your primary business location is the country where your business is based. It will appear in the Business Manager under the Primary Business Location field starting May 1, 2024, if we are able to determine where your business is based using publicly-available information.
Examples of publicly-available information include:
We will attempt to determine where your business is based when:
This process can take up to 3 business days. The outcome of this determination can be:
You will be notified of the outcome in your initial eligibility email, or in a separate email if you used the Business Manager to edit your location.
If rejected or if we need more information, or if you disagree with the country we determined to be the primary business location, you can use the Business Manager to edit your location.
Note that if your primary business location status is not verified but you are past your start time for a given country, any authentication conversation that you open with a WhatsApp user in that country will be billed the authentication-international rate.
Set your primary business location by following these steps:
Note: You won’t be able to make any changes while your verification is under review.
The Primary Business Location field in the Business Manager will also display a status:
You can use the API to see if your business's primary business location is set by requesting the primary_business_location
field on any your business's WhatsApp Business Accounts:
GET /<WABA_ID>?fields=primary_business_location
{ "id": "<WABA_ID>", "primary_business_location": "<COUNTRY_CODE>" }
<WABA_ID>
— WhatsApp Business Account ID.<COUNTRY_CODE>
— Two-digit country code indicating the country where we have determined the business to be based.By sending authentication messages over WhatsApp, you acknowledge and agree that when your business is deemed eligible for authentication-international rates, an email will be sent to all of the email addresses associated with the admins of your accounts, and all third parties that your WhatsApp Business Accounts have been shared with (e.g. admins of Solution Partners that have access to your WhatsApp Business Accounts), to alert them that the threshold of eligibility has been reached.
The email will include:
An account_update
webhook will be triggered if your business is deemed eligible for international rates. The webhook will include start times for each country that has an authentication-international rate.
{ "object": "whatsapp_business_account", "entry": [ { "id": "<WABA_ID>", "time": <TIMESTAMP>, "changes": [ { "field": "account_update", "value": { "auth_international_rate_eligibility": { "exception_countries": [ { "country_code": "ID", "start_time": <START_TIME_INDONESIA> } ], "start_time": <START_TIME_INDIA> }, "event": "AUTH_INTL_PRICE_ELIGIBILITY_UPDATE" } } ] } ] }
<WABA_ID>
— WhatsApp Business Account ID.<TIMESTAMP>
— Unix timestamp indicating when the webhook was sent.<START_TIME_INDONESIA>
— Unix timestamp indicating Indonesia start time.<START_TIME_INDIA>
— Unix timestamp indicating India start time.Subscribe to the account_update
webhook to be notified when the business's primary business location is set. If we are able to determine the country where your business is based, we will set your location to that country and trigger an account_update
webhook with the country's two-digit code assigned to the BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE
property.
{ "object": "whatsapp_business_account", "entry": [ { "id": "<WABA_ID>", "time": <TIMESTAMP>, "changes": [ { "field": "account_update", "value": { "country": "<COUNTRY_CODE>", "event": "BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE" } } ] } ] }
<WABA_ID>
— WhatsApp Business Account ID.<TIMESTAMP>
— Unix timestamp indicating when the webhook was sent.<COUNTRY_CODE>
— Two-digit country code indicating the country where we have determined the business to be based.If an authentication conversation is billed the authentication-international rate, the pricing
object in messages
webhooks will have its category
property (entry.statuses.pricing.category
) set to authentication_international
.
"pricing": { "billable": true, "pricing_model": "CBP", "category": "authentication_international" }
A business with an Indonesia primary business location opens an authentication conversation with a WhatsApp user:
User location | Is business eligible? | Is on/after start time? | Rate billed |
---|---|---|---|
Indonesia | - | - | Authentication |
India | No | - | Authentication |
India | Yes | No | Authentication |
India | Yes | Yes | Authentication-International |
A business with an India primary business location opens an authentication conversation with a WhatsApp user:
User location | Is business eligible? | Is on/after start time? | Rate billed |
---|---|---|---|
India | - | - | Authentication |
Indonesia | No | - | Authentication |
Indonesia | Yes | No | Authentication |
Indonesia | Yes | Yes | Authentication-International |
A business with a primary business location that does not have an authentication-international rate opens an authentication conversation with a WhatsApp user:
User location | Is business eligible? | Is on/after start time? | Rate billed |
---|---|---|---|
Indonesia | No | - | Authentication |
Indonesia | Yes | No | Authentication |
Indonesia | Yes | Yes | Authentication-International |
India | No | - | Authentication |
India | Yes | No | Authentication |
India | Yes | Yes | Authentication-International |