Onboarding business customers as a Solution Partner | Developer Documentation

Onboarding business customers as a Solution Partner 
 Updated: Nov 14, 2025 
 This document describes the steps Solution Partners must perform to onboard new business customers who have completed the Embedded Signup flow. 
 If you are a Solution Partner, any business customer who completes your implementation of the Embedded Signup flow will not be able to use your app to access their WhatsApp assets or send and receive messages until you complete these steps. 
 
 
 
 What you will need the business customer’s WABA ID (returned via session logging or API request ) the business customer’s business phone number ID (returned via session logging or API request ) your app ID (displayed at the top of the App Dashboard ) your app secret (displayed in the App Dashboard > App settings > Basic panel) your credit line ID (displayed in Business Manager > Business Settings > Business Info or returned via API request ) your system user access token (“system token”) 
 Also, if you wish to test messaging capabilities using the customer’s business phone number, you will need a WhatsApp phone number that can already send and receive messages from other WhatsApp numbers. 
 
 Perform all of the requests described below using server-to-server requests. Do not use client-side requests. 
 
 
 
 Step 1: Exchange the token code for a business token 
 
 
 
 Request parameters 
 
 
 
 
 Placeholder 
 Description 
 Example value 
 
 
 
 
 <APP_ID> 
 
 
 Required. 
 Your app ID. This is displayed at the top of the App Dashboard . 
 
 
 236484624622562 
 
 
 
 <APP_SECRET> 
 
 
 Required. 
 Your app secret. You can get this from the App Dashboard > App Secret > Basic panel. 
 
 
 614fc2afde15eee07a26b2fe3eaee9b9 
 
 
 
 <CODE> 
 
 
 Required. 
 The code returned by Embedded Signup when the customer successfully completed the flow. 
 
 
 AQBhlXsctMxJYbwbrpybxlo9tLPGy-QAmjBJA03jxLos43wxlBlrYozY5C33BXJULd133cOJf_5y6EkJZYMrAmW-EMj3Wdap9-NUM2nS4s8tC-ES7slBhh6QpCFM7-SzpI-iqsjqTGyxbUUW3AeaEyLkeZFIkBgcQ_SOxo9HShm20SDR5_n7AT9ZJ5dcgpqBQykNT-pQ8V7Ne9-sr6RLAWtJMF7-Zx6ABudRcWIN53tUTtquDVNuq3lrco4BlVQAv-54tR83Ae0ODN9Uet6j-BVLuetXhQCM3sz9RdgedlbxkidMbkztvYX1j7baOrJxyLyYGWYgbnUrKRQKCtWTsO5ekIGFgtbpS8UPJNqV6j8E5XKPJ8QA7ZFqzkB0s2O__J5FrjHzc_rDo1EuRbw98ihHDzQnvuXeHapEyfhLDJct0A 
 
 
 
 Response parameters 
 
 
 
 
 Placeholder 
 Description 
 Example value 
 
 
 
 
 <BUSINESS_TOKEN> 
 
 
 The customer’s business token . 
 
 
 EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn 
 
 
 
 Step 2: Subscribe to webhooks on the customer’s WABA 
 
 
 
 Request parameters 
 
 
 
 
 Placeholder 
 Description 
 Example value 
 
 
 
 
 <BUSINESS_TOKEN> 
 
 
 Required. 
 The customer’s business token . 
 
 
 EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn 
 
 
 
 <WABA_ID> 
 
 
 Required. 
 The customer’s WABA ID. 
 
 
 102290129340398 
 
 
 
 Step 3: Share your credit line with the customer 
 
 We are currently testing new steps for sharing your credit line with onboarded business customers. These steps will eventually replace this step, so if you wish to implement these steps now, see Alternate method for sharing your credit line . 
 Note : If you are using the below API i.e. whatsapp_credit_sharing_and_attach , you would need to add your System User to the shared WhatsApp Business Accounts as a pre-requisite. Please refer to this doc for steps . 
 
 
 
 Request parameters 
 
 
 
 
 Placeholder 
 Description 
 Example value 
 
 
 
 
 <CUSTOMER_BUSINESS_CURRENCY> 
 
 
 Required. 
 The business’s currency, as a three-letter currency code. Support values are: AUD EUR GBP IDR INR USD 
 This currency is used for invoicing and corresponds to pricing rates. 
 
 
 USD 
 
 
 
 <CUSTOMER_WABA_ID> 
 
 
 Required. 
 The customer’s WABA ID. 
 
 
 102290129340398 
 
 
 
 <EXTENDED_CREDIT_LINE_ID> 
 
 
 Required. 
 Your extended credit line ID. 
 
 
 1972385232742146 
 
 
 
 <SYSTEM_TOKEN> 
 
 
 Required. 
 Your system token. 
 
 
 EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD 
 
 
 
 Response parameters 
 
 
 
 
 Placeholder 
 Description 
 Example value 
 
 
 
 
 <ALLOCATION_CONFIGURATION_ID> 
 
 
 The extended credit line’s allocation configuration ID. 
 Save this ID if you want to verify that your credit line has been shared with the customer. 
 
 
 58501441721238 
 
 
 
 <CUSTOMER_WABA_ID> 
 
 
 The customer’s WABA ID. 
 
 
 102290129340398