API ReferenceCheckout

Crypto Payin

Initiates a payment where the customer is paying with Crypto

Authentication

x-coinflow-auth-user-idstring

The external identifier of the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

OR
x-coinflow-auth-walletstring

The web3 wallet of the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

x-coinflow-auth-blockchainstring

The blockchain associated with the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

Request

This endpoint expects an object.
subtotalobjectRequired
emailstringRequired
chainstringRequired
The name of the chain to perform the crypto payin on.
tokenstringRequired
The symbol of the token to execute the payin with.
fixedFeeobjectOptional
settlementTypeenumOptional
Allowed values:
customerInfoobjectOptional
webhookInfoobjectOptional
feePercentagedoubleOptional0-100

If this purchase is for a seller/submerchant where the marketplace takes a fee, this is the % fee which is taken from the subtotal amount.

jwtTokenstringOptional
This is a token encoding the parameters for the request. Allows purchase parameters to be verified to prevent manipulation when the checkout page is presented to the user.
transactionDataobjectOptional

(EVM only) if you want to execute an EVM transaction on a successful purchase, you can pass a transaction request here.

Gas fees for the transaction will be automatically calculated and added to the total charged to the customer. Optionally the merchant can opt to pay for these gas fees.

rentobjectOptional

(Solana only) if your transaction requires a known amount of Rent to be paid, you can pass it here.

destinationAuthKeystringOptional
If utilizing USDC settlement to addresses other than your main merchant settlement address. Utilize this destinationAuthKey which is a JWT encoded with the information for which address to send the USDC to.

Response

Ok
sessionIdstring

The session/payment identifier

depositAddressstring
The deposit address where funds should be sent
paymentChainNamestring

Human-readable chain name

paymentCurrencySymbolstring
The token symbol
paymentAmountstring
The amount to pay in the selected currency
chainLogoUrlstring
currencyLogoUrlstring
paymentIdstring
serviceFeesUSDstring or null
Commission amount if customer is paying fees

Errors