> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.coinflow.cash/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.coinflow.cash/_mcp/server. # How To: Implement Marketplace Credits (API) > **Warning** > > **This page is for advanced / cryptocurrency-native companies.** If that's not you, head back to the [Quickstart](/guides/getting-started/quickstart) for the standard flows. ## Summary Merchants can follow this guide to learn how to implement a Credits purchase flow on Coinflow's Marketplace so that end-users can purchase credits, then spend those credits towards purchases with sellers. Upon spending credits, Sellers receive their earnings in their seller balance and can withdraw at any time. > **Note:** Coinflow's marketplace credits run on regulated stablecoin rails under the hood, which is why some API responses return a `wallet` address. You don't need any blockchain knowledge to integrate — treat the `wallet` field as an opaque account identifier for the payer's credits balance. ## Setup * [**Register a marketplace account** on sandbox](https://sandbox-merchant.coinflow.cash/marketplace/register) > 🚧 Please reach out to the Coinflow team with your merchant id once you've completed this so we can configure your account for marketplaces! ## Resources * [Demo of marketplaces](/guides/marketplaces/marketplace-overview#marketplaces-demo) * Read about [how 3DS works.](/guides/checkout/payment-security-risk-management/fraud-protection/about-chargeback-protection) * Read about [how to override chargeback protection decisions.](/guides/checkout/payment-security-risk-management/fraud-protection/overriding-chargeback-protection) * Read about [how credit card payments work](/guides/checkout/payment-scenarios/authorize-capture) . * Read about [credit card authorization, capture, and void.](https://blog.coinflow.cash/understanding-authorization-capture-and-void-9e582c265bb8) * Read about [what countries Coinflow supports withdrawing directly to banks to.](/guides/payouts/payout-methods/available-countries) * Sellers in countries Coinflow doesn't yet support for direct-to-bank payouts can receive their earnings in USDC (a stablecoin pegged 1:1 to the US dollar). Contact the Coinflow team for details on the USDC withdrawal flow. ## Getting Started #### 1.[Create a seller registration link](/api-reference/api-reference/marketplace/get-seller-register-link) * This will generate a link which sellers can use to register themselves as a seller under the marketplace. ``` curl --request POST \ --url https://api-sandbox.coinflow.cash/api/marketplace/link/seller/registration \ --header 'Authorization: YOUR_API-KEY_HERE' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "email": "sellerEmailAddress@email.com", // the seller email address "sellerId": "seller1", // the seller id on your platform "country": "us", // the seller's location "redirectUrl": "https://www.mywebsite.com/" // url to redirect the seller to upon registration completion } ' ``` #### 2.[Get a seller login link](/api-reference/api-reference/marketplace/get-seller-login-link) * This will generate a link which sellers can use to login to their seller dashboard to view purchases, customers, withdraw their funds, view withdraw history. ``` curl --request POST \ --url https://api-sandbox.coinflow.cash/api/marketplace/link/seller/login \ --header 'Authorization: YOUR_API-KEY_HERE' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "email": "sellerEmailAddress@gmail.com" //you can optionally pass the seller id instead of email eg: {"sellerId": "seller1"} } ' ``` #### 3.[Create a credits account for the payer](/api-reference/api-reference/marketplace/get-wallet-address-by-email) In order to purchase credits, payers need a credits account, which holds their balance. Calling this endpoint provisions one for them based on their email. The endpoint returns a `wallet` address — treat this as the credits-account identifier, not as a user-visible crypto wallet. **`Request`** ```shell Request curl --location 'https://api-sandbox.coinflow.cash/api/marketplace/wallet' \ --header 'Authorization: YOUR_API_KEY' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data-raw ' { "email": "tasha+testmarketplace@coinflowlabs.app" } ' ``` **`Reponse`** ```json Reponse { "wallet": "P1uPQFW6Q9fL8csc8oh9qnFKub7h5JWBWKxmqygGd4U", "blockchain": "solana" } ``` #### 4. Allow the payer to [purchase credits ](/api-reference/api-reference/checkout/get-checkout-link) This endpoint will generate a purchase link. Marketplaces can collect their own fees for each credit purchase if they'd like. The `fixedFee` or `percentageFee` will be taken from the `subtotal` and be immediately sent to your marketplace's wallet balance when the payer purchases the credits. In the example below, the marketplace will receive \$5 and the payer will receive \$50 in credits. **`Request`** ```shell Request curl --request POST \ --url https://api-sandbox.coinflow.cash/api/checkout/link \ --header 'Authorization: YOUR_API_KEY' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --header 'x-coinflow-auth-blockchain: solana' \ --header 'x-coinflow-auth-wallet: P1uPQFW6Q9fL8csc8oh9qnFKub7h5JWBWKxmqygGd4U' \ // This should be the wallet address returned in step 1 --data ' { "subtotal": { "currency": "USD", "cents": 5500 }, "fixedFee": { "cents": 500 }, "email": "tasha+testmarketplace@coinflowlabs.app", "blockchain": "solana", "settlementType": "Credits" } ' ``` **`Response`** ```json Response { "link": "https://sandbox.coinflow.cash/solana/purchase-v2/tylee?sessionKey=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ3YWxsZXQiOiJQMXVQUUZXNlE5Zkw4Y3NjOG9oOXFuRkt1YjdoNUpXQldLeG1xeWdHZDRVIiwiYmxvY2tjaGFpbiI6InNvbGFuYSIsIm1lcmNoYW50SWQiOiJ0eWxlZSIsImlhdCI6MTc0Mjg0MDA3NiwiZXhwIjoxNzQyOTI2NDc2fQ.ouDD47g1RSTj1QzxncgGbK209DqFJ8uDzVcTM8Oxgx0¢s=5500¤cy=USD&email=iamapayer%40gmail.com&useHeightChange=true&jwtToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoi456C4oKW26LXguCxoOWMg-uAieiCrOKgoeqZkuiBseqAs-GogOuAguaRgOmwgOOGmeuUgeuAhuazgueghOaanuKAg-SIgsOs7oCC54CJ7oCB7ICL6IiyReOJjOyMhOOtjOekqOqJouySnNik6YCc7IOM6IGG5LW46amQ5ruE6YSE54e17Jqn4Lia5LCO74aS5KGO4Kmq7KGM5LCR4qSI5Kex4YOV4qKC74ao7LGR5bGJ7ZGJ6LCZ6LSo6aG84aad5LCQ5LSw6aGQ6YGN6qST44GM4rS04aOVXHVkOTA44YWS6aao74SK6q6s5YGN4KC14Y-Y7KCJ4KKQ75KR6qaw6KuQ75CY5LKYXHVkOTVj4Yap6qab44GI7ZCN6rSQ7YeZ6qSI5aGR4Kap4qaw77WG46OQ7oaw4YSS46yT5Yug6YGI5KOY7LuQ5aCX7KOyXHVkODRj7KGY5ICB57KAIiwibWVyY2hhbnRJZCI6InR5bGVlIiwiaWRlbXBvdGVuY3lLZXkiOiJJS2VlOWY5NDFlLTc0OGItNGI0OS1iYWNmLTYzYzJhOTRlYzc5YyIsInN1YnRvdGFsIjp7ImN1cnJlbmN5IjoiVVNEIiwiY2VudHMiOjU1MDB9LCJpYXQiOjE3NDI4NDAwNzYsImV4cCI6MTc0MjkyNjQ3Nn0.8gINpQ2EelWrMhBmVEGOZlf58NWF_-B9UYMXbfSHREM" } ``` **`Display Payment`** ```html Display Payment