Skip to main content
Payments API lets you accept payments, manage customers, issue refunds, and receive real-time webhook notifications — all through a clean REST interface with predictable, resource-oriented URLs.

Core Resources

ResourceDescription
PaymentIntentRepresents a payment attempt. Tracks the lifecycle from creation to settlement.
CustomerStores customer information for recurring payments and record-keeping.
RefundReturns funds to a customer for a completed payment.
Webhook EndpointConfigures a URL to receive real-time event notifications.
EventRecords something that happened in your account, delivered to webhook endpoints.

Getting Started

1

Get your API keys

Sign up for an account and grab your test mode secret key (sk_test_...) from the dashboard.
2

Create a PaymentIntent

Make a POST request to /v1/payment_intents with an amount and currency.
3

Confirm and capture

Confirm the PaymentIntent to charge the customer. Use automatic or manual capture depending on your business model.
4

Go live

Switch to your live secret key (sk_live_...) and start processing real payments.

Explore

  • Error Handling — Understand error types and handle them gracefully
  • Idempotency — Safely retry requests without double-charging
  • Pagination — Navigate large result sets efficiently
  • Testing — Test your integration with simulated payment methods