Accepting Transfers through the API
Ready to automate fiat on‑ramps and off‑ramps? Integrate Sphere’s Transfer API in minutes to let your users move seamlessly between fiat and stablecoins.
Easily integrate Sphere’s Transfer API into your backend so that your users can convert fiat into stablecoins (on‑ramp) or redeem stablecoins for fiat (off‑ramp), all through a single, secure endpoint.
Prerequisites
- A Sphere account with an active API secret key.
- A verified Customer (KYC approved).
- Wallet addresses and bank accounts registered for transfers.
Transfer Flow
Transfer API
https://api.spherepay.co/v1/transferhttps://api.sandbox.spherepay.co/v1/transferFor full request/response details, see the Create Transfer API Reference.
Request Example
{
"amount": "100",
"customer": "{{customer_id}}",
"source": {
"id": "{{bank_account_id}}",
"currency": "usd",
"network": "achPush"
},
"destination": {
"id": "{{wallet_account_id}}",
"currency": "usdc",
"network": "ethereum"
}
}Tip: Make sure your source.currency and destination.currency align (e.g. "usd" → "usdc").
If you receive a 200 response with "status": "pending", the transfer is created and awaiting funds.
Request Example
{
"amount": "100",
"customer": "{{customer_id}}",
"source": {
"id": "{{wallet_account_id}}",
"currency": "usdc",
"network": "ethereum"
},
"destination": {
"id": "{{bank_account_id}}",
"currency": "usd",
"network": "achPush"
}
}Tip: Make sure your source.currency and destination.currency align (e.g. "usdc" → "usd").
If you receive a 200 response with "status": "pending", the transfer is created and awaiting funds.
Transfer through SpherePay
Transfer through SpherePay requires the customer to manually initiate the transfer and send the funds to the bank account or wallet address provided in the instructions.
Choosing Your SpherePay Solution
Explore the different integration options—Dashboard, Ramp, API, and combinations—to find the best fit for your business needs.
Accepting Transfers through Ramp Widget
Seamlessly integrate Sphere's Ramp Widget into your platform to enable users to convert fiat currencies into stablecoins with ease and security.