Getting Started
This guide will walk you through how to start building with the Align API, from onboarding to your first payment flow.
1. Request API Access
To receive your API authorization tokens:
Email [email protected] to request API access
Sign the developer agreement
Receive sandbox and production API tokens via secure link
Store your API keys securely and only use them from a secure backend environment.
2. Create a Customer
Every transfer is completed on behalf of a customer. To create a customer, use a Create Customer endpoint.
Example:
curl -X POST https://api.alignlabs.dev/v0/customers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"first_name": "John",
"last_name": "Doe",
"type": "individual"
}'Response:
{
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"type": "individual"
}You can now use customer_id to initiate a KYC session.
3. Start KYC Verification
Every customer needs to go through KYC/KYB. To initiate a KYC session, use a Create KYC Session endpoint.
Example:
curl -X POST https://api.alignlabs.dev/v0/customers/{customer_id}/kycs \
-H "Authorization: Bearer YOUR_API_KEY" \Response:
{
"kycs": {
"kyc_flow_link": "https://link-to-kyc-provider.com"
}
}Once a customer completed KYC, their kycs.status_breakdown object will display for which currency / rails customer is approved.
4. Complete Verification and Enable Payment Rails
When the customer completes KYC/KYB, Align will approve currency and payment rail access (for example USD, EUR, GBP, or stablecoins).
After approval, you can:
Create virtual accounts
Initiate on-ramp transfers (fiat to stablecoin)
Initiate off-ramp transfers (stablecoin to fiat)
5. Webhooks for Real-Time Updates
To receive live events such as:
Customer KYC status changes
Transfer updates
Account events
Register your webhook URL:
Docs: https://docs.alignlabs.dev/align-api/webhooks
Align will push real-time events to your webhook.
6. Developer Dashboard Access
You can manage customers, transfers, and test flows from the dashboard.
Request access by sending admin emails to the Align team.
URL: https://dashboard.alignlabs.dev/
We will provision accounts for your team.
That's It - You Are Ready to Build
From here you can:
Initiate payments
Create virtual accounts
Monitor activity and users in real time
Plug into global fiat and stablecoin rails
Last updated