Skip to main content
POST
Create a crypto transfer

Request

string
required
Active production API key belonging to the customer and source wallet merchant.
string
required
UUID of the customer making the transfer
string
required
Complete recipient address on the selected network. Stellar requires a valid Stellar public address.
string
required
The blockchain network for the transfer: solana or stellar.
string
required
Solana supports sol, usdc, and usdt. Stellar supports xlm and usdc. Use lowercase values.
number
required
Gross token amount. The configured fee is deducted and the net amount is sent to the recipient.
string
Optional Stellar text memo, maximum 28 characters. FossaPay generates a memo when omitted. This field is used only for Stellar transfers.

Request Example

For a Stellar transfer, set network to stellar, currency to xlm or usdc, and recipient to the destination’s full Stellar public address. Add a memo if the recipient requires one:
The address above is illustrative. Use the recipient’s actual address and required memo when submitting a payment.

Response

The response indicates provider processing, not final blockchain settlement. This endpoint has no merchant-provided idempotency key or reference. After a timeout, inspect wallet history and balances before submitting another transfer. Stellar wallets must retain the configured native XLM reserve and enough XLM for network fees; the default reserve is 1.5 XLM.

Errors

Authorizations

x-api-key
string
header
required

Body

application/json
customerId
string
required
recipient
string
required
network
enum<string>
required
Available options:
solana,
stellar
currency
enum<string>
required

Solana: sol, usdc, usdt. Stellar: xlm, usdc.

Available options:
usdc,
usdt,
sol,
xlm
amount
number
required

Gross token amount. FossaPay deducts the quoted transfer fee, if any, and sends the remainder to the recipient. SOL supports up to 9 decimal places; XLM up to 7.

memo
string

Optional text memo for Stellar transfers. FossaPay generates one when omitted.

Maximum string length: 28

Response

Crypto transfer submitted

status
boolean
required
message
string
required
data
object
required