Card Checkout

post

https://api-sandbox.coinflow.cash/api/checkout/card/{merchantId}

Processes a checkout via credit card information, will tokenize and save the card for reuse by the customer in the future.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

merchantId

string

required

Body Params

subtotal

required

webhookInfo

object

chargebackProtectionData

array of objects

Purchase *

chargebackProtectionData

customerInfo

settlementType

string

enum

Allowed:

rent

object

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

redemptionCheck

boolean

(Solana only) If a transaction involved in the purchase, should payment be checked for redemption

transactionData

(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.

authOnly

boolean

Only authorize the purchase. This will not actually capture the payment.(default: false)

feePercentage

double

0 to 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.

fixedFee

object

jwtToken

string

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.

threeDsChallengePreference

string

enum

Allowed:

destinationAuthKey

string

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.

customerUsdcTransferData

object

Customer signed USDC transferWithAuthorization data for dual-source payments Used for combined USDC + Credit Card payments on EVM chains

authentication3DS

presentment

string

enum

accountFundingTransaction

object

Used for Account Funding Transactions

card

object

required

saveCard

boolean

Save the new card? If not passed in, will default to true

Headers

x-device-id

string

(Optional) If you are using Coinflow Chargeback Protection, you must pass the device id of the customer's device.

x-coinflow-client-ip

string

user-agent

string

Responses

304

Credit balance available - Please utilize the redemption endpoint to complete the purchase https://docs.coinflow.cash/reference/getredeemtransaction

423

Customer is Blocked

200Ok

412Challenge required

451Must Complete Additional Verification