WhatsApp Payments Integration Guide

payments api enables businesses to accept payments from their customers through all upi apps installed on their device via whatsapp businesses can send invoice(order details) messages to their customers, and then get notified about payment status updates via webhook notifications from payment gateway prerequisites you should have a whatsapp business account with the registered whatsapp phone number you should have a registered payment gateway account with payu or razorpay you should have a system integrated with the whatsapp payment apis you should have the system to generate the order detail messages with a unique order id for each payment how it works initiating payment to kick off the payment process, the business sends an 'order details' message to the consumer this special message contains four main components header, body, footer, and action inside the action component, the business includes all the necessary information for the customer to complete their payment unique reference id each 'order details' message carries a unique reference id provided by the business this unique number is nothing but the order id or order number which is crucial throughout the entire process, acting as a tracking id for the order the reference id is obtained from the upi intent link generated for a business order through the payment gateway tracking order status after sending the 'order details' message, the business patiently awaits payment or transaction status updates directly from the payment gateway once a payment signal for an order is received, the business should promptly relay this information to the consumer through an interactive 'order status' message importance of payment signal update (optional) updating the user about the payment signal is vital this update modifies the 'order details' message and the consumer's order details view, confirming the order from the merchant we illustrate this process with an example in the subsequent sections steps to be followed request access the payment apis needs to be enabled for the customer whatsapp business account to get this enabled please raise a support ticket with the required information to exotel support team to enable the payment api for the business (if you are already allowlisted for an older number, you may skip this step) please follow the below steps to raise the ticket subject request access for the whatsapp payment apis for the \<whatsapp business name> to hello\@exotel in (and add your respective customer success managers in the ticket in the cc) body hi team, i am writing to request access to enable the payment apis for our business account below are the details required for processing the request business name \[your business name] whatsapp business account id (waba id) \[your waba id] whatsapp business phone number \[your whatsapp business phone number] preferred payment gateway name \[razorpay or payu] use case explain the use you plan to build using the whatsapp payment apis in a few lines best regards link payment gateway account to be done by the customer connect your whatsapp business account with the payment gateway for seller owned waba login to the whatsapp business manager account and your payment gateway account navigate to the payment methods section from the lhs navigation bar https //business facebook com/wa/manage/direct pay/ navigate to the relevant waba and start the account linking process by “adding a direct pay method” put in the waba id and select the correct waba id put in a name, and note the payment configuration name in this step set the mcc to 000 to the relevant code set the purpose code to the relevant code follow the steps and select payment gateway in the dropdown where you are asked for the payment gateway please see the screenshot below for your reference enter your password and you will be redirected to the payment gateway website login using the credentials in step (1) and authorize “whatsapp payments india” to access the payment gateway account you will need a whatsapp enabled phone number your payment gateway should now be linked to your waba for bsp owned waba (obo) bsp logs into the whatsapp manager initiates creating a “direct pay method” follow the same steps as the seller owned waba method above from step 5 to step 9 share the link generated on submission of the above form to the seller the seller logs in to the fb business manager account the seller is redirected to pg website, where the seller will need to log in and approve allowing meta to request payments on behalf of the seller initiate checkout to be done by the customer please follow the steps below to send the order details message, and send the order status order details construct order details message using the example in the postman collection shared postman collection set the action parameters payment configuration to the name of the payment configuration you created above note “action parameters payment type” → “payment gateway \<razorpay,payu>” set “action parameters reference id” → “some id” here’s the pictorial representation of how the order message renders in the whatsapp screen post it to https //\<your api key> \<your api token>\<subdomain>/v2/accounts/\<your sid>/messages you can get the api key, token, subdomain and sid from your exotel messaging account under the number management section configure webhook go to the webhooks section on the exotel messaging console and search for your phone number click on the edit icon, paste and save your callback url here order status (optional) order status information will already be available in the webhooks but there is an alternate way to fetch the order status by calling the order status api the order status will be “pending” by default and needs to be changed to the right status to avoid confusing the buyer once you receive the payment status for your order update order status to the user and set it to “processing” initiate order fulfillment once you receive a status from your order management system, update the user about the order’s status (if order fulfillment fails, let the user know what they can do) “action parameters reference id” must match the corresponding order id we show supported statuses, what they mean and a finite state machine test and launch to be done by the customer please follow the steps below to test and launch the payment solution! you can now construct the send message api with the details as this is a session message, this should deliver the order details message, remember the phone needs to have interacted with this bot in the last 24 hours, for this to work as expected just send a “hi” from the number to not fail this check on the phone click on “review and pay” and hit “continue” pay using any of the upi apps, you have check your callback to look for a call from whatsapp with payment status details for “some id” or “reference id” you provided now update the order status to “complete” by using the “order status” example in the postman collection note action parameters reference id → “some id” note action parameters order status → “completed” the user should now see an order status message, verify if it looks correct this should align with payment ids from the pg merchant website log into pg’s merchant account and match these payment ids for reference