Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spitshake.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

DocuTrust integrates with Stripe to collect payments as part of the signing workflow. Add a payment field to any template, and signers will be prompted to pay before completing their submission. Supports one-time charges with configurable amounts and currencies.

​
Configure Stripe

Connect your Stripe account to enable payment collection. 
curl -X POST "https://spitshake.io/api/settings/payments/update_config" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "stripe_secret_key": "sk_live_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
    "stripe_publishable_key": "pk_live_z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4j3",
    "currency": "usd",
    "webhook_secret": "whsec_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
  }'

{
  "success": true,
  "message": "Stripe configuration saved successfully",
  "configured": true,
  "currency": "usd",
  "livemode": true
}

​
Check Configuration

curl -X GET "https://spitshake.io/api/settings/payments/config" \
  -H "X-Auth-Token: YOUR_API_TOKEN"

{
  "configured": true,
  "currency": "usd",
  "livemode": true,
  "publishable_key": "pk_live_z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4j3"
}

​
Create Payment Intent

When a signer reaches a payment field, create a Stripe PaymentIntent to begin the checkout process. 
curl -X POST "https://spitshake.io/api/payments/{submission_id}/create_intent" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "usd",
    "description": "NDA signing fee - Project Alpha",
    "field_uuid": "f1a2b3c4-d5e6-7890-abcd-000000000001",
    "metadata": {
      "template_name": "NDA Agreement",
      "submitter_email": "jane@example.com"
    }
  }'

{
  "payment_intent_id": "pi_3P4Q5R6S7T8U9V0W",
  "client_secret": "pi_3P4Q5R6S7T8U9V0W_secret_X1Y2Z3A4B5C6D7E8",
  "amount": 5000,
  "currency": "usd",
  "status": "requires_payment_method",
  "description": "NDA signing fee - Project Alpha",
  "created_at": "2026-04-08T15:00:00Z"
}

​
Confirm Payment

After the signer completes payment on the client side, confirm the payment was successful. 
curl -X POST "https://spitshake.io/api/payments/{submission_id}/confirm" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_intent_id": "pi_3P4Q5R6S7T8U9V0W",
    "field_uuid": "f1a2b3c4-d5e6-7890-abcd-000000000001"
  }'

{
  "success": true,
  "payment_intent_id": "pi_3P4Q5R6S7T8U9V0W",
  "amount": 5000,
  "currency": "usd",
  "status": "succeeded",
  "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xT...",
  "confirmed_at": "2026-04-08T15:02:30Z"
}

​
Stored Payment Data

After successful payment, the following object is saved to the submitter’s values hash under the corresponding field UUID: 
{
  "payment_intent_id": "pi_3P4Q5R6S7T8U9V0W",
  "amount": 5000,
  "currency": "usd",
  "status": "succeeded",
  "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xT...",
  "paid_at": "2026-04-08T15:02:30Z"
}

​
Get Payment Status

Check the status of a payment for a specific submission. 
curl -X GET "https://spitshake.io/api/payments/{submission_id}/status?field_uuid=f1a2b3c4-d5e6-7890-abcd-000000000001" \
  -H "X-Auth-Token: YOUR_API_TOKEN"

{
  "paid": true,
  "payment_intent_id": "pi_3P4Q5R6S7T8U9V0W",
  "amount": 5000,
  "currency": "usd",
  "status": "succeeded",
  "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xT...",
  "paid_at": "2026-04-08T15:02:30Z"
}

​
Supported Currencies

Amounts are always specified in the smallest currency unit (e.g., cents for USD). Supported currencies include:
CurrencyCodeSmallest UnitExample
US Dollarusdcents5000 = $50.00
Euroeurcents5000 = 50.00
British Poundgbppence5000 = 50.00
Canadian Dollarcadcents5000 = $50.00
Australian Dollaraudcents5000 = $50.00
Japanese Yenjpyyen5000 = 5,000
All currencies supported by Stripe are available. See Stripe’s currency documentation for the full list.