Send and receive
stablecoin payment flow stablecoins can be sent and received using the cross river stablecoin payments api docid\ lnz2vwmxvaha4yp7mayed each transaction is initiated, validated, and reconciled through cross river regulated infrastructure, ensuring that onchain transfers follow the same operational, compliance, and regulatory frameworks applied to other payment rails outbound payments use the post /v1/payments docid 97ecbpklpcwxvcxkeo la endpoint to send stablecoins to a verified external blockchain address for outbound payments, usd is debited from the cross river account , and the corresponding usdc amount is delivered onchain how it works step 1 payment initiation submit a request to post /v1/payments specifying the account number, amount, currency ( usdc ), blockchain ( solana ), and destination blockchain address step 2 validation cross river validates account permissions verifies available balances confirms that the specified blockchain and asset are supported performs any other necessary compliance and regulatory validations step 3 execution once validated, the transaction is broadcast to the selected blockchain for settlement step 4 confirmation after settlement, cross river records the transaction and issues a webhook notification ( crypto payment sent ) containing the payment id and blockchain transaction hash step 5 reconciliation the completed transaction is reflected in account reporting to support operational and accounting traceability inbound payments stablecoins may be received into a cross river managed onchain address inbound transfers are detected and validated once confirmed onchain, after which usd is credited to the cross river account how it works step 1 address retrieval use get /v1/accounts/{accountnumber}/account addresses docid 28f lh3ataq88tjcqntw to retrieve the receiving blockchain address for the selected network step 2 sender transfer initiation a sender, which may be cross river’s customer or the customer’s customer (i e the end user), initiates a stablecoin transfer to the retrieved address using a supported blockchain network step 3 onchain confirmation cross river detects the transaction and validates that it matches the account and asset configuration, and issues a crypto payment onchainpaymentdetected webhook step 4 pii submission and account credit if sender pii is not being reused from a previous transfer, provide the required sender pii using post /v1/payments/{id}/pii once the required pii is submitted and the transfer is validated, the equivalent usd amount is credited to the account and reflected in reporting step 5 notification a webhook ( crypto payment received ) confirms that the inbound transfer has completed successfully example a payment of 1,000 usdc is sent to a supplier a call is made to post /v1/payments , specifying the supplier’s solana blockchain address cross river validates and executes the transaction on the solana network the payment is finalized onchain, subject to network conditions a webhook notification ( crypto payment sent ) is issued containing the payment id and blockchain transaction hash for reconciliation