5-Minute Quickstart Guide
This guide walks you through integrating Pay with Handle using our Headless REST API.Step 1: Obtain Your API Keys
- Log in to the Handle Merchant Dashboard.
- Copy your Secret Key (
sk_test_...for development,sk_live_...for production).
Step 2: Resolve Customer Handle
When the customer enters@ayodeji at checkout, make a request from your backend to resolve their profile:
Understanding the Resolve Response
The resolve response indicates whether the customer has Auto-Debit enabled:Step 3: Dispatch Payment Authorization
Call/v1/charges/dispatch to initiate the payment:
Dispatch Response Scenarios
[!NOTE]
- For Biometric Push: Display a “Check your phone to approve” waiting modal while listening for the
charge.successwebhook.- For Auto-Debit: Payment completes instantly at dispatch time. No waiting or customer action is required.
Step 4: Listen for Webhooks
Configure your server endpoint to receive real-time payment confirmations:Express.js (Node.js)