Skip to main content
This guide covers how to create an onramp order that the buyer pays from Cash App. The order returns a Solana Pay link that you show as a QR code. The buyer scans it with Cash App and sends USDC on Solana to the order’s deposit address. Crossmint then delivers USDC to the buyer’s wallet.
Enterprise feature. Contact us for access.

Prerequisites

  • API Key: A server-side API key with the orders.create, orders.read, and orders.update scopes. 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, so refundAddress is a Solana address for every delivery chain.
A Cash App order has one line item, delivers only USDC, and delivers at least 1 USDC.

Create a Cash App Order

1

Create the order

Call Create Order with these 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.
This exact-in order specifies the amount to spend. The delivered quantity accounts for fees; read it from the completed order.
A refund goes to refundAddress, not to the buyer’s Cash App account. Crossmint cannot change it after the order is created, so confirm the address with the buyer before you create the order.
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. 10000000 is 10 USDC.
  • paymentLink: a Solana Pay solana: URI with the deposit address, the amount, and the USDC token.
Show 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.status is expired. 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.
A Cash App order cannot change to another payment method, and an order created with another payment method cannot change to Cash App.

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 test refundAddress 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