Skip to main content

POST /flexi/pay

Pay the pending SOL order from one of the user's wallets.

Sends the SOL the initiated bots still lack from the wallet to the user's payment address. The worker starts the bots once the payment address holds their summed nSOL. Sync — waits for tx confirmation and returns the signature.

If the payment address already holds enough SOL, nothing is sent.

Token-paid orders (ePaymentMode: "TOKEN") are not payable here — send the token to the payment address with POST /wallets/transfer.

Use case​

Skip the manual transfer after /flexi/initialize: pay the pending order straight from a wallet listed by /wallets/all.

Headers​

HeaderRequiredDescription
Idempotency-Keyno8–128 chars of [A-Za-z0-9_-]. A retry with the same key within 24 hours returns the first response (with Idempotent-Replayed: true) instead of sending a second payment. 409 while the first request is still running; 503 if idempotency is unavailable.

Body​

FieldTypeRequiredDescription
sWalletAddressstringyesSource pubkey; must be user-owned.

Response 200​

{
"message": "Payment sent",
"paymentAddress": "…",
"sFrom": "…",
"nSol": 5,
"signature": "3k…"
}

When the payment address already covers the order:

{
"message": "The payment address already covers this order",
"paymentAddress": "…",
"nSol": 0
}
FieldDescription
nSolSOL sent: the summed nSOL of the initiated bots minus what the payment address already held.

Errors​

StatusMeaning
400Invalid sWalletAddress; the pending order is token-paid; insufficient balance (response includes nBalanceSol, nRequiredSol); or the wallet would be left below the rent-exempt minimum.
403The wallet was imported through /wallets/import and is reserved for Smart Sell.
404No initiated bot, or wallet not found / not owned.
502The transfer was not confirmed.
503Balance could not be fetched; retry later.

Example​

curl -X POST "$BASE_URL/flexi/pay" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID" \
-H "Idempotency-Key: pay-66b4-0001" \
-H "Content-Type: application/json" \
-d '{ "sWalletAddress": "…" }'