Prepare Top-Up Transaction

POST

customer

topup

prepare

curl --request POST \
  --url https://orbitflare.com/api/customer/v2/topup/prepare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 5002.5,
  "wallet_address": "<string>"
}
'

{
  "success": true,
  "message": "<string>",
  "data": {
    "transaction": "<string>",
    "memo": "<string>",
    "amount_usdc": 123,
    "amount_micro_usdc": 123,
    "destination_wallet": "<string>",
    "blockhash": "<string>",
    "last_valid_block_height": 123
  }
}

Authorizations

Authorization

string

header

required

Bearer token from device or wallet auth

Body

application/json

amount

number<float>

required

USDC amount to top up.

Required range: 5 <= x <= 10000

wallet_address

string

required

Solana wallet public key (base58).

Required string length: 32 - 44

Response

Unsigned transaction built successfully.

success

boolean

Example:

true

message

string

data

object

Show child attributes

Confirm Top-Up TransactionBroadcasts the customer's signed transaction to Solana, waits for finalization, verifies on-chain data (memo, signer, USDC transfer, amount, destination), then credits the account balance. Creates an invoice and payment record.

Prepare Top-Up Transaction

curl --request POST \
  --url https://orbitflare.com/api/customer/v2/topup/prepare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 5002.5,
  "wallet_address": "<string>"
}
'

{
  "success": true,
  "message": "<string>",
  "data": {
    "transaction": "<string>",
    "memo": "<string>",
    "amount_usdc": 123,
    "amount_micro_usdc": 123,
    "destination_wallet": "<string>",
    "blockhash": "<string>",
    "last_valid_block_height": 123
  }
}