Enterprise feature. Contact us for access.
Prerequisites
- API Key: A server-side API key with the
orders.create,orders.read, andorders.updatescopes. In staging, all scopes are included by default. - Verified buyer: The buyer completes KYC before the order can take a Cash App payment. Crossmint links the KYC data to the order through
payment.receiptEmail. See User Onboarding. - Recipient wallet: The recipient is a wallet on Solana, Base, Polygon, Ethereum, or Arbitrum.
- Refund address: Crossmint does not know the buyer’s Cash App address, so it cannot refund to Cash App. Ask the buyer for a Solana address that the buyer controls, and send it as
refundAddress. The buyer always pays on Solana, sorefundAddressis a Solana address for every delivery chain.
Create a Cash App Order
1
Create the order
Call Create Order with these This exact-in order specifies the amount to spend. The delivered quantity accounts for fees; read it from the completed order.
payment fields:The examples deliver on Solana. To deliver on an EVM chain, set
tokenLocator to USDC on that chain, for example base-sepolia:0x036CbD53842c5426634e7929541eC2318f3dCF7e, and set walletAddress to an EVM address.2
Show the QR code
The response holds the payment details in
order.payment.preparation:Response (excerpt)
depositAddress: the address that receives the buyer’s USDC.transactionParameters.amount: the amount to send, in USDC base units.10000000is 10 USDC.paymentLink: a Solana Paysolana:URI with the deposit address, the amount, and the USDC token.
paymentLink as a QR code. The buyer scans it with Cash App to pay. The three fields are present only while quote.status is valid.3
Track the order
Poll Get Order until
phase is completed.- Read the delivered quantity from
lineItems[].delivery.tokens[].quantity. It can differ from the requested amount: a payment of a different amount is filled at a new price. - The order can complete after
quote.statusisexpired. A late payment still completes the order. - If the payment is refunded, the refund goes to
refundAddress.
Verify Wallet Ownership
When the recipient wallet needs a proof of ownership, Crossmint creates the order with the verification challenge and no payment details. To get the deposit address:1
Verify the wallet
Have the buyer sign the challenge and submit the signature, as described in Onramp to Non-Crossmint Wallets.
2
Update the order
Call Edit Order with the same Cash App
payment that you used to create the order. The response holds payment.preparation with the deposit address.Test on Staging
On staging, no real funds move. Each order completes automatically within about 3 minutes of creation. To test another result, create the order with one of these testrefundAddress values:
Any other refund address completes the order normally. These addresses select a test result only on staging, so do not use them in production.
Next Steps
Onramp to Non-Crossmint Wallets
Verify ownership of the recipient wallet
Create Order
Full reference for the onramp order payload

