Payment Routes
Create wallets for end-customers and enable payment orchestration for your product or platform.
A Payment Route is a permanent blockchain address for your end-customer to pay in to. When a customer sends crypto, such as BTC, ETH, or USDC, to their liquidation address, Swapped will automatically send funds to the merchant.
Payment routes are the easiest way to embed crypto and stablecoin acceptance into your existing platform. If your platform:
enables customers to login and deposit
provides customers wallet addresses
then Payment Routes are for you
To get started, create your first Payment Route:
Successful
POST /v1/merchants/{merchantId}/payment-routes HTTP/1.1
Host: pay-api.swapped.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 68
{
"externalId": "text",
"chains": [
"base"
],
"email": "text",
"name": "text"
}Successful
{
"data": {
"paymentRoutes": [
{
"id": "text",
"merchantId": "text",
"externalId": "text",
"available": true,
"address": "text",
"memo": "text",
"supportedCurrencies": [
"text"
],
"userEmail": "text",
"userName": "text",
"createdAt": "2025-10-17",
"merchant": {
"id": "text",
"name": "text",
"logoUrl": "text",
"roles": [
"MERCHANT"
],
"localCurrency": {
"id": "text",
"symbol": "text",
"precision": 1,
"type": "FIAT",
"flows": [
"PAYMENT"
],
"blockchain": {
"id": "text",
"name": "text"
}
},
"countryCode": "text",
"coverPercentage": "text"
}
}
],
"pagination": {
"currentPage": 1,
"totalPages": 1,
"totalItems": 1,
"itemsPerPage": 1
}
},
"message": "text",
"success": true
}That's it! Now whenever a deposit is made to this blockchain address, you'll receive the funds to the merchant's account, receive an email notification, and receive webhook information to proceed further.
Generally we see merchants store and save the payment route to their customer, so when they come back to deposit or pay again, the same blockchain address can be used each time.
Last updated