WhatsApp Payment Messages

Send payment request messages to customers via WhatsApp, enabling seamless payment collection through integrated payment gateways.

note

Payment Messages are available for WhatsApp Business API accounts with an approved payment partner. Contact your Exotel account manager to enable this feature.

Send Payment Request

POST /v2/accounts/<account_sid>/messages

Request Body

{
  "whatsapp": {
    "messages": [{
      "from": "your_waba_number",
      "to": "+919876543210",
      "content": {
        "type": "order_details",
        "header": {
          "type": "text",
          "text": "Payment Request"
        },
        "body": {
          "text": "Please complete payment for your order"
        },
        "footer": {
          "text": "Powered by Exotel"
        },
        "action": {
          "name": "review_and_pay",
          "parameters": {
            "reference_id": "order_12345",
            "type": "digital-goods",
            "payment_settings": [{
              "type": "payment_gateway",
              "payment_gateway": {
                "type": "razorpay",
                "configuration_name": "your_payment_config"
              }
            }],
            "currency": "INR",
            "total_amount": {
              "value": 50000,
              "offset": 100
            },
            "order": {
              "status": "pending",
              "items": [
                {
                  "retailer_id": "SKU001",
                  "name": "Premium Plan - Monthly",
                  "amount": {
                    "value": 50000,
                    "offset": 100
                  },
                  "quantity": 1
                }
              ]
            }
          }
        }
      }
    }]
  }
}

Parameters

Parameter	Type	Required	Description
from	String	Yes	Your WhatsApp Business number
to	String	Yes	Recipient number in E.164 format
content.type	String	Yes	Must be order_details
action.name	String	Yes	Must be review_and_pay
reference_id	String	Yes	Your unique order/payment reference
type	String	Yes	digital-goods or physical-goods
currency	String	Yes	ISO 4217 currency code (e.g., INR)
total_amount.value	Integer	Yes	Amount in smallest currency unit (paise)
total_amount.offset	Integer	Yes	Decimal offset (100 for INR)

Response

{
  "request_id": "req_pay_001",
  "method": "POST",
  "http_code": 200,
  "response": {
    "code": 200,
    "status": "success",
    "data": {
      "message_id": "msg_pay_abc123",
      "status": "sent",
      "to": "+919876543210"
    }
  }
}

Payment Status Webhook

When a payment is completed, you receive a webhook:

{
  "event": "payment_status",
  "message_id": "msg_pay_abc123",
  "reference_id": "order_12345",
  "payment_status": "captured",
  "amount": {
    "value": 50000,
    "offset": 100,
    "currency": "INR"
  },
  "transaction_id": "txn_xyz789",
  "timestamp": "2024-06-15T10:35:00.000Z"
}

Payment Status Values

Status	Description
pending	Payment request sent, awaiting customer action
captured	Payment successfully completed
failed	Payment failed
canceled	Customer canceled the payment

Supported Payment Gateways

Gateway	Configuration
Razorpay	type: "razorpay"
PayU	type: "payu"
Zaakpay	type: "zaakpay"

HTTP Status Codes

Code	Description
200	Success
400	Bad Request — Invalid payment parameters
401	Unauthorized
402	Payment Gateway not configured
403	Payment messages not enabled