Stripe Integration

ZipZign uses Stripe for all payment processing. You don't need your own Stripe account unless you want to route payments to connected accounts.

Default payment flow

By default, payments are processed through ZipZign's Stripe account. The payer's credit card is charged, and funds are settled into your ZipZign account balance.

Stripe Connect

If you're building a platform where you want to route payments to your own or a third party's Stripe account:

{
  "type": "payable",
  "payment": {
    "amount": 100000,
    "currency": "usd",
    "description": "Project payment",
    "payerName": "Customer Name",
    "payerEmail": "customer@example.com",
    "destination_account": "acct_1ExampleStripeId",
    "platform_fee_percent": 5
  }
}

Stripe Connect fields

Example: 5% platform fee on $1,000

• Customer pays: $1,000
• Platform fee (5%): $50 retained by your platform
• Net to destination_account: $950

Sandbox / test mode

In sandbox mode ("sandbox": true), Stripe is automatically in test mode. Use Stripe test card numbers:

Success:       4242 4242 4242 4242
Decline:       4000 0000 0000 0002
Auth required: 4000 0025 0000 3155

Expiry: any future date. CVV: any 3 digits.

Payment webhooks

ZipZign fires webhooks when Stripe confirms payment:

{
  "event": "document.paid",
  "data": {
    "id": "doc_abc123",
    "amount": 100000,
    "currency": "usd",
    "payerEmail": "customer@example.com",
    "payerName": "Customer Name",
    "status": "paid"
  }
}

Connecting your Stripe account

1. Go to Dashboard → Settings → Stripe Connect
2. Click Connect with Stripe and authorize
3. Your destination_account ID will be pre-filled for convenience

Refunds

Process refunds directly in your Stripe dashboard. ZipZign document status is not affected by refunds.

Updated on: 16/04/2026