Solana example

Execute a Carbon card top-up from a Solana wallet through the Zebec Partner API.

Use this flow for a quote whose payment.chain is SOLANA. Start with the shared top-up flow through preflight and use the same wallet public key throughout.

Request the quote

GET /partner/v1/topup/quote?amount=100&currencyCode=USD&sourceChain=SOLANA&sourceTokenMint=<spl-token-mint>
Authorization: Bearer <accessToken>

Read payment.network, payment.contractAddress, payment.tokenAmount, and payment.tokenDecimals from the response. Build and submit the quote-defined SPL-token/card-program transaction with your wallet adapter. Do not convert the quoted base-unit amount with a hard-coded decimal value.

Execute and confirm

The Partners Card SDK exposes ZebecCardSolanaService.purchaseCard() for wallet-backed Solana execution. Supply an adapter backed by the user's wallet and preserve the selected token and quote data when adapting the Partner API quote.

const { signature: txHash } = await solanaCardService.purchaseCard({
  amount: quote.sourceAmount,
  quote: partnerQuoteAdapter.toSdkQuote(quote),
  token: partnerQuoteAdapter.toSdkToken(quote),
  cardProgramId: program.programId,
  recipient,
  userAddress: wallet.publicKey.toBase58(),
  reloadCardId: quote.cardId,
});

Wait for finalization before treating txHash as the receipt. If you use a different Solana integration, it must submit the transaction encoded by the quote and retain the finalized transaction signature.

Sign and submit

Sign the UTF-8 bytes of quote.signingMessage with the same Solana wallet. Encode the detached signature as base58.

const buyerAddress = wallet.publicKey.toBase58();
const signature = base58.encode(
  await wallet.signMessage(new TextEncoder().encode(quote.signingMessage)),
);

await partnerApi.submitTopup({
  quoteId: quote.id,
  receipt: { deposit: { txHash, buyerAddress } },
  userSignature: { signature, publicKey: buyerAddress, scheme: "solana" },
});

The signature wallet, preflight wallet, and transaction payer must identify the same wallet account.