Quick Start
Make your first payment through the FetcherPay API in under 5 minutes.
1
Get API Credentials
For sandbox testing, use the token sandbox. For production, request API keys from the FetcherPay dashboard.
Authorization: Bearer sandbox2
Create a Payment
Send a POST request to create a payment. Use rail: "auto" to let FetcherPay choose the optimal rail (RTP for speed, ACH for cost).
curl -X POST https://sandbox.fetcherpay.com/v1/payments \
-H "Authorization: Bearer fp_test_your_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"amount": 10000,
"currency": "USD",
"source": {
"payment_method_id": "pm_bank_123"
},
"destination": {
"payment_method_id": "pm_merchant_456"
},
"rail": "auto"
}'3
Handle the Response
The API returns a 202 Accepted status with a payment object. Payments are processed asynchronously — monitor the status via webhooks or polling.
{
"id": "pay_abc123",
"status": "pending",
"amount": 10000,
"currency": "USD",
"rail_selected": "rtp",
"timeline": [
{"status": "pending", "timestamp": "2026-02-18T20:00:00Z"}
]
}
4
Verify Webhooks (Optional)
Register a webhook endpoint to receive real-time status updates. All webhooks include an HMAC-SHA256 signature for verification.
Learn about webhooks →