diff --git a/fern/products/swml/pages/reference/methods/pay/index.mdx b/fern/products/swml/pages/reference/methods/pay/index.mdx
index 7e1918655..9f8a0a5fa 100644
--- a/fern/products/swml/pages/reference/methods/pay/index.mdx
+++ b/fern/products/swml/pages/reference/methods/pay/index.mdx
@@ -9,7 +9,10 @@ max-toc-depth: 3
 [supported-languages-voice]: /docs/platform/voice/tts
 [currency-code]: https://en.wikipedia.org/wiki/ISO_4217
 
-Enable secure payment processing during voice calls. When implemented in your voice application, it manages the entire payment flow, including data collection, validation, and processing, through your configured payment gateway.
+Enable secure payment processing during voice calls. 
+When implemented in your voice application, it manages the entire payment flow — 
+collecting card details from the caller via DTMF, then POSTing them to a `payment_connector_url` you host. 
+Your server is responsible for charging the card through your payment processor (Stripe, Braintree, etc.) and returning the result to SignalWire.
 
 ## **Transaction Types**
 
@@ -27,7 +30,7 @@ version: 1.0.0
 sections:
   main:
     - pay:
-        charge_amount: 25.00
+        charge_amount: "25.00"
         payment_connector_url: "https://example.com/process"
 ```
 </CodeBlock>
@@ -39,7 +42,7 @@ sections:
     "main": [
       {
         "pay": {
-          "charge_amount": 25.0,
+          "charge_amount": "25.00",
           "payment_connector_url": "https://example.com/process"
         }
       }
@@ -68,7 +71,7 @@ version: 1.0.0
 sections:
   main:
     - pay:
-        charge_amount: 0
+        charge_amount: "0"
         payment_connector_url: "https://example.com/process"
 ```
 </CodeBlock>
@@ -80,7 +83,7 @@ sections:
     "main": [
       {
         "pay": {
-          "charge_amount": 0,
+          "charge_amount": "0",
           "payment_connector_url": "https://example.com/process"
         }
       }
@@ -949,4 +952,4 @@ sections:
 }
 ```
 </CodeBlock>
-</CodeBlocks>
\ No newline at end of file
+</CodeBlocks>