# Order details **POST** `/{phone_number_id}/messages` Product: [WhatsApp](https://devdocs.1spoc.com/docs/whatsapp.md) Version: [3.0](https://devdocs.1spoc.com/docs/whatsapp/3-0.md) Category: **Payments** Lifecycle: **active** Order details from the Partners API documentation. ## Request overview Full URL: `https://whatsapp.1spoc.com/v3/{phone_number_id}/messages` Method: `POST` Content type: `application/json` ## Authentication Send the credential in the request **header** using the field `apikey`. > Keep real credentials on the server. The examples below use placeholders and never contain stored secrets. ## Parameters ### Path parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `phone_number_id` | string | Yes | Resource identifier for phone number id. | ### Query parameters None. ### Request body fields None. ## Request schema ```json { "type": "object", "properties": { "raw_example": { "type": "string" } } } ``` ## Request example ```json { "raw_example": "{\n\"messaging_product\": \"whatsapp\",\n\n\"to\": \"{{Recipient phone number}}\",\n\"type\": \"interactive\",\n\"recipient_type\": \"individual\",\n\"interactive\": {\n\"type\": \"order_details\",\n\"body\": {\n\"text\": \"Test payment\"\n},\n\"header\": {\n\"type\": \"{{Media-type}}\",\n\"image\": {\n\"link\": \"{{Media-Url}}\"\n}\n},\n\"action\": {\n\"name\": \"review_and_pay\",\n\"parameters\": {\n\"reference_id\": \"EZV2023032712042512044720\",\n\"type\": \"digital-goods\",\n\"currency\": \"INR\",\n\"total_amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"payment_settings\": [\n{\n\"type\": \"payment_gateway\",\n\"payment_gateway\": {\n\n\"type\": \"razorpay / payu\",\n\"configuration_name\":\"payment-config-id\"\n}\n}\n]\n\"order\": {\n\"status\": \"pending\",\n\"items\": [\n{\n\"retailer_id\": \"R1\",\n\"product_id\": \"product-id\",\n\"name\": \"Test Payment Rs. 1\",\n\"amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"quantity\": 1\n}\n],\n\"subtotal\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"tax\": {\n\"value\": 0,\n\"offset\": 100\n}\n\n}\n}\n},\n\"footer\": {\n\"text\": \"{{text}}\"\n}\n}\n}" } ``` ## Response schema ```json { "type": "object", "properties": { "raw_example": { "type": "string" } } } ``` ## Response examples ```json { "200": { "raw_example": "{\n\"messaging_product\": \"whatsapp\",\n\"contacts\": [\n{\n\"input\": \"9175XXXXXXXX\",\n\"wa_id\": \"9175XXXXXXXX\"\n}\n],\n\"messages\": [\n{\n\"id\":\n\"wamid.HBgMOTE3OTcyODkyNzEyFQIAERgSQzAwRDEzNkQ1NDFFNkM3NkEzAA=\n=\"\n}\n]\n}\n" } } ``` ## Status codes ```json [ { "code": 200, "description": "The request was successful." }, { "code": 400, "description": "Bad request or invalid parameters." }, { "code": 401, "description": "API key is missing or invalid." }, { "code": 403, "description": "The request is not authorized for this resource." }, { "code": 404, "description": "The requested resource was not found." }, { "code": 500, "description": "The server encountered an error." } ] ``` ## Generated integration examples The following examples are generated from the published **POST /{phone_number_id}/messages** contract and use placeholder credentials. ### cURL ```curl curl --request POST 'https://whatsapp.1spoc.com/v3/{phone_number_id}/messages' \ --header 'apikey: ' \ --header 'Content-Type: application/json' \ --data '{ "raw_example": "{\n\"messaging_product\": \"whatsapp\",\n\n\"to\": \"{{Recipient phone number}}\",\n\"type\": \"interactive\",\n\"recipient_type\": \"individual\",\n\"interactive\": {\n\"type\": \"order_details\",\n\"body\": {\n\"text\": \"Test payment\"\n},\n\"header\": {\n\"type\": \"{{Media-type}}\",\n\"image\": {\n\"link\": \"{{Media-Url}}\"\n}\n},\n\"action\": {\n\"name\": \"review_and_pay\",\n\"parameters\": {\n\"reference_id\": \"EZV2023032712042512044720\",\n\"type\": \"digital-goods\",\n\"currency\": \"INR\",\n\"total_amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"payment_settings\": [\n{\n\"type\": \"payment_gateway\",\n\"payment_gateway\": {\n\n\"type\": \"razorpay / payu\",\n\"configuration_name\":\"payment-config-id\"\n}\n}\n]\n\"order\": {\n\"status\": \"pending\",\n\"items\": [\n{\n\"retailer_id\": \"R1\",\n\"product_id\": \"product-id\",\n\"name\": \"Test Payment Rs. 1\",\n\"amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"quantity\": 1\n}\n],\n\"subtotal\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"tax\": {\n\"value\": 0,\n\"offset\": 100\n}\n\n}\n}\n},\n\"footer\": {\n\"text\": \"{{text}}\"\n}\n}\n}" }' ``` ### JavaScript ```javascript const response = await fetch('https://whatsapp.1spoc.com/v3/{phone_number_id}/messages', { method: 'POST', headers: { "apikey": "", "Content-Type": "application/json" }, body: JSON.stringify({ "raw_example": "{\n\"messaging_product\": \"whatsapp\",\n\n\"to\": \"{{Recipient phone number}}\",\n\"type\": \"interactive\",\n\"recipient_type\": \"individual\",\n\"interactive\": {\n\"type\": \"order_details\",\n\"body\": {\n\"text\": \"Test payment\"\n},\n\"header\": {\n\"type\": \"{{Media-type}}\",\n\"image\": {\n\"link\": \"{{Media-Url}}\"\n}\n},\n\"action\": {\n\"name\": \"review_and_pay\",\n\"parameters\": {\n\"reference_id\": \"EZV2023032712042512044720\",\n\"type\": \"digital-goods\",\n\"currency\": \"INR\",\n\"total_amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"payment_settings\": [\n{\n\"type\": \"payment_gateway\",\n\"payment_gateway\": {\n\n\"type\": \"razorpay / payu\",\n\"configuration_name\":\"payment-config-id\"\n}\n}\n]\n\"order\": {\n\"status\": \"pending\",\n\"items\": [\n{\n\"retailer_id\": \"R1\",\n\"product_id\": \"product-id\",\n\"name\": \"Test Payment Rs. 1\",\n\"amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"quantity\": 1\n}\n],\n\"subtotal\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"tax\": {\n\"value\": 0,\n\"offset\": 100\n}\n\n}\n}\n},\n\"footer\": {\n\"text\": \"{{text}}\"\n}\n}\n}" }) }); if (!response.ok) throw new Error(`HTTP ${response.status}`); const data = await response.json(); console.log(data); ``` ### NodeJS ```node const response = await fetch('https://whatsapp.1spoc.com/v3/{phone_number_id}/messages', { method: 'POST', headers: { "apikey": "", "Content-Type": "application/json" }, body: JSON.stringify({ "raw_example": "{\n\"messaging_product\": \"whatsapp\",\n\n\"to\": \"{{Recipient phone number}}\",\n\"type\": \"interactive\",\n\"recipient_type\": \"individual\",\n\"interactive\": {\n\"type\": \"order_details\",\n\"body\": {\n\"text\": \"Test payment\"\n},\n\"header\": {\n\"type\": \"{{Media-type}}\",\n\"image\": {\n\"link\": \"{{Media-Url}}\"\n}\n},\n\"action\": {\n\"name\": \"review_and_pay\",\n\"parameters\": {\n\"reference_id\": \"EZV2023032712042512044720\",\n\"type\": \"digital-goods\",\n\"currency\": \"INR\",\n\"total_amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"payment_settings\": [\n{\n\"type\": \"payment_gateway\",\n\"payment_gateway\": {\n\n\"type\": \"razorpay / payu\",\n\"configuration_name\":\"payment-config-id\"\n}\n}\n]\n\"order\": {\n\"status\": \"pending\",\n\"items\": [\n{\n\"retailer_id\": \"R1\",\n\"product_id\": \"product-id\",\n\"name\": \"Test Payment Rs. 1\",\n\"amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"quantity\": 1\n}\n],\n\"subtotal\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"tax\": {\n\"value\": 0,\n\"offset\": 100\n}\n\n}\n}\n},\n\"footer\": {\n\"text\": \"{{text}}\"\n}\n}\n}" }) }); if (!response.ok) throw new Error(`HTTP ${response.status}`); const data = await response.json(); console.log(data); ``` ### Python ```python import json import requests url = 'https://whatsapp.1spoc.com/v3/{phone_number_id}/messages' headers = { "apikey": "", "Content-Type": "application/json" } payload = json.loads(r'''{ "raw_example": "{\\n\\"messaging_product\\": \\"whatsapp\\",\\n\\n\\"to\\": \\"{{Recipient phone number}}\\",\\n\\"type\\": \\"interactive\\",\\n\\"recipient_type\\": \\"individual\\",\\n\\"interactive\\": {\\n\\"type\\": \\"order_details\\",\\n\\"body\\": {\\n\\"text\\": \\"Test payment\\"\\n},\\n\\"header\\": {\\n\\"type\\": \\"{{Media-type}}\\",\\n\\"image\\": {\\n\\"link\\": \\"{{Media-Url}}\\"\\n}\\n},\\n\\"action\\": {\\n\\"name\\": \\"review_and_pay\\",\\n\\"parameters\\": {\\n\\"reference_id\\": \\"EZV2023032712042512044720\\",\\n\\"type\\": \\"digital-goods\\",\\n\\"currency\\": \\"INR\\",\\n\\"total_amount\\": {\\n\\"value\\": 100,\\n\\"offset\\": 100\\n},\\n\\"payment_settings\\": [\\n{\\n\\"type\\": \\"payment_gateway\\",\\n\\"payment_gateway\\": {\\n\\n\\"type\\": \\"razorpay / payu\\",\\n\\"configuration_name\\":\\"payment-config-id\\"\\n}\\n}\\n]\\n\\"order\\": {\\n\\"status\\": \\"pending\\",\\n\\"items\\": [\\n{\\n\\"retailer_id\\": \\"R1\\",\\n\\"product_id\\": \\"product-id\\",\\n\\"name\\": \\"Test Payment Rs. 1\\",\\n\\"amount\\": {\\n\\"value\\": 100,\\n\\"offset\\": 100\\n},\\n\\"quantity\\": 1\\n}\\n],\\n\\"subtotal\\": {\\n\\"value\\": 100,\\n\\"offset\\": 100\\n},\\n\\"tax\\": {\\n\\"value\\": 0,\\n\\"offset\\": 100\\n}\\n\\n}\\n}\\n},\\n\\"footer\\": {\\n\\"text\\": \\"{{text}}\\"\\n}\\n}\\n}" }''') response = requests.post(url, headers=headers, json=payload) response.raise_for_status() print(response.json()) ``` ### Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; var client = HttpClient.newHttpClient(); String body = """ { "raw_example": "{\n\"messaging_product\": \"whatsapp\",\n\n\"to\": \"{{Recipient phone number}}\",\n\"type\": \"interactive\",\n\"recipient_type\": \"individual\",\n\"interactive\": {\n\"type\": \"order_details\",\n\"body\": {\n\"text\": \"Test payment\"\n},\n\"header\": {\n\"type\": \"{{Media-type}}\",\n\"image\": {\n\"link\": \"{{Media-Url}}\"\n}\n},\n\"action\": {\n\"name\": \"review_and_pay\",\n\"parameters\": {\n\"reference_id\": \"EZV2023032712042512044720\",\n\"type\": \"digital-goods\",\n\"currency\": \"INR\",\n\"total_amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"payment_settings\": [\n{\n\"type\": \"payment_gateway\",\n\"payment_gateway\": {\n\n\"type\": \"razorpay / payu\",\n\"configuration_name\":\"payment-config-id\"\n}\n}\n]\n\"order\": {\n\"status\": \"pending\",\n\"items\": [\n{\n\"retailer_id\": \"R1\",\n\"product_id\": \"product-id\",\n\"name\": \"Test Payment Rs. 1\",\n\"amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"quantity\": 1\n}\n],\n\"subtotal\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"tax\": {\n\"value\": 0,\n\"offset\": 100\n}\n\n}\n}\n},\n\"footer\": {\n\"text\": \"{{text}}\"\n}\n}\n}" } """; var request = HttpRequest.newBuilder(URI.create("https://whatsapp.1spoc.com/v3/{phone_number_id}/messages")) .header("apikey", "") .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString(body)) .build(); var response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); System.out.println(response.body()); ``` ### PHP ```php 'https://whatsapp.1spoc.com/v3/{phone_number_id}/messages', CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => ["apikey: ","Content-Type: application/json"], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($curl); if ($response === false) throw new Exception(curl_error($curl)); curl_close($curl); echo $response; ``` ### C# ```csharp using System.Net.Http.Headers; using System.Text; using var client = new HttpClient(); client.DefaultRequestHeaders.Add("apikey", ""); var json = """ { "raw_example": "{\n\"messaging_product\": \"whatsapp\",\n\n\"to\": \"{{Recipient phone number}}\",\n\"type\": \"interactive\",\n\"recipient_type\": \"individual\",\n\"interactive\": {\n\"type\": \"order_details\",\n\"body\": {\n\"text\": \"Test payment\"\n},\n\"header\": {\n\"type\": \"{{Media-type}}\",\n\"image\": {\n\"link\": \"{{Media-Url}}\"\n}\n},\n\"action\": {\n\"name\": \"review_and_pay\",\n\"parameters\": {\n\"reference_id\": \"EZV2023032712042512044720\",\n\"type\": \"digital-goods\",\n\"currency\": \"INR\",\n\"total_amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"payment_settings\": [\n{\n\"type\": \"payment_gateway\",\n\"payment_gateway\": {\n\n\"type\": \"razorpay / payu\",\n\"configuration_name\":\"payment-config-id\"\n}\n}\n]\n\"order\": {\n\"status\": \"pending\",\n\"items\": [\n{\n\"retailer_id\": \"R1\",\n\"product_id\": \"product-id\",\n\"name\": \"Test Payment Rs. 1\",\n\"amount\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"quantity\": 1\n}\n],\n\"subtotal\": {\n\"value\": 100,\n\"offset\": 100\n},\n\"tax\": {\n\"value\": 0,\n\"offset\": 100\n}\n\n}\n}\n},\n\"footer\": {\n\"text\": \"{{text}}\"\n}\n}\n}" } """; using var content = new StringContent(json, Encoding.UTF8, "application/json"); var response = await client.PostAsync("https://whatsapp.1spoc.com/v3/{phone_number_id}/messages", content); response.EnsureSuccessStatusCode(); Console.WriteLine(await response.Content.ReadAsStringAsync()); ``` ### Go ```go package main import ( "fmt" "io" "net/http" "bytes" ) func main() { request, err := http.NewRequest("POST", "https://whatsapp.1spoc.com/v3/{phone_number_id}/messages", bytes.NewBufferString("{\n \"raw_example\": \"{\\n\\\"messaging_product\\\": \\\"whatsapp\\\",\\n\\n\\\"to\\\": \\\"{{Recipient phone number}}\\\",\\n\\\"type\\\": \\\"interactive\\\",\\n\\\"recipient_type\\\": \\\"individual\\\",\\n\\\"interactive\\\": {\\n\\\"type\\\": \\\"order_details\\\",\\n\\\"body\\\": {\\n\\\"text\\\": \\\"Test payment\\\"\\n},\\n\\\"header\\\": {\\n\\\"type\\\": \\\"{{Media-type}}\\\",\\n\\\"image\\\": {\\n\\\"link\\\": \\\"{{Media-Url}}\\\"\\n}\\n},\\n\\\"action\\\": {\\n\\\"name\\\": \\\"review_and_pay\\\",\\n\\\"parameters\\\": {\\n\\\"reference_id\\\": \\\"EZV2023032712042512044720\\\",\\n\\\"type\\\": \\\"digital-goods\\\",\\n\\\"currency\\\": \\\"INR\\\",\\n\\\"total_amount\\\": {\\n\\\"value\\\": 100,\\n\\\"offset\\\": 100\\n},\\n\\\"payment_settings\\\": [\\n{\\n\\\"type\\\": \\\"payment_gateway\\\",\\n\\\"payment_gateway\\\": {\\n\\n\\\"type\\\": \\\"razorpay / payu\\\",\\n\\\"configuration_name\\\":\\\"payment-config-id\\\"\\n}\\n}\\n]\\n\\\"order\\\": {\\n\\\"status\\\": \\\"pending\\\",\\n\\\"items\\\": [\\n{\\n\\\"retailer_id\\\": \\\"R1\\\",\\n\\\"product_id\\\": \\\"product-id\\\",\\n\\\"name\\\": \\\"Test Payment Rs. 1\\\",\\n\\\"amount\\\": {\\n\\\"value\\\": 100,\\n\\\"offset\\\": 100\\n},\\n\\\"quantity\\\": 1\\n}\\n],\\n\\\"subtotal\\\": {\\n\\\"value\\\": 100,\\n\\\"offset\\\": 100\\n},\\n\\\"tax\\\": {\\n\\\"value\\\": 0,\\n\\\"offset\\\": 100\\n}\\n\\n}\\n}\\n},\\n\\\"footer\\\": {\\n\\\"text\\\": \\\"{{text}}\\\"\\n}\\n}\\n}\"\n}")) if err != nil { panic(err) } request.Header.Set("Content-Type", "application/json") request.Header.Set("Accept", "application/json") request.Header.Set("apikey", "") response, err := http.DefaultClient.Do(request) if err != nil { panic(err) } defer response.Body.Close() data, err := io.ReadAll(response.Body) if err != nil { panic(err) } if response.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, data)) } fmt.Println(string(data)) } ``` ## Related resources - [Interactive documentation page](https://devdocs.1spoc.com/docs/whatsapp/3-0/order-details) - [Version documentation](https://devdocs.1spoc.com/docs/whatsapp/3-0.md) - [OpenAPI JSON](https://devdocs.1spoc.com/docs/whatsapp/3-0/openapi.json) - [OpenAPI YAML](https://devdocs.1spoc.com/docs/whatsapp/3-0/openapi.yaml) - [Postman collection](https://devdocs.1spoc.com/postman/whatsapp/3-0/collection.json) - [Postman environment](https://devdocs.1spoc.com/postman/whatsapp/3-0/environment.json) - [MCP setup](https://devdocs.1spoc.com/mcp-setup) - [AI documentation index](https://devdocs.1spoc.com/llms.txt) - [Complete AI documentation](https://devdocs.1spoc.com/llms-full.txt) - [Node.js SDK](https://devdocs.1spoc.com/sdk/whatsapp/3-0/node.zip) - [Python SDK](https://devdocs.1spoc.com/sdk/whatsapp/3-0/python.zip) - [Java SDK](https://devdocs.1spoc.com/sdk/whatsapp/3-0/java.zip) ## Guidance for AI assistants Treat this document and its linked OpenAPI contract as the source of truth for **POST /{phone_number_id}/messages**. - Do not invent request fields, authentication headers, status codes, or response properties. - Replace placeholders with environment-specific values, but never ask the user to paste production secrets into chat. - Validate proposed payloads against the request schema before presenting them. - Explain which values are required and identify assumptions clearly. - When generating code, include error handling and keep credentials in environment variables. - Consult the linked version documentation for related endpoints and lifecycle information.