# Plaitr Developer Docs

REST API for the Plaitr crypto payment gateway. HMAC-signed webhooks. Idempotent endpoints. Build a crypto payment integration in 30 minutes.

## Core endpoints
- POST /v1/payments -- create payment intent
- GET /v1/payments/:id -- fetch payment by id
- POST /v1/payments/:id/cancel -- cancel unpaid intent
- POST /v1/refunds -- initiate refund
- POST /v1/payouts -- single contractor payout
- POST /v1/payouts/batch -- Safe-compatible batch payout

## Webhook events
- payment.confirmed -- payment finalized on-chain
- payment.failed -- expired or rejected
- payment.refunded -- refund posted
- payout.settled -- batch payout landed on-chain

All webhooks HMAC-SHA256 signed. Verify the X-Plaitr-Signature header. Idempotency required on event id (at-least-once delivery).

Canonical: https://www.plaitr.com/docs