How To: Whitelist Your Contract Address

Overview

Coinflow works by wrapping your transaction’s instructions with two Coinflow program instructions. This way we can modify the user’s CFLOW balance, send them USDC or other tokens necessary to complete the purchase, and then clean up after the fact so the user does not have more of those tokens than when they started.

In order for this process to work, your program must be ‘whitelisted’ by Coinflow admins. In any transaction, the Coinflow program will verify that all of the instructions belong to a whitelisted program ID.

To learn more, read our article on Coinflow Transactions.

Implementation

To get started whitelisting your program, head to the Coinflow Merchant Dashboard. On the side menu, select the ‘Whitelist Program’ page. You’ll see a screen similar to below, since you’re new to this:

How to submit a request to whitelist your contract / programs. Part 1.

Notice the ‘New request’ button highlighted in the red box. Click this to begin.

How to specify the program id and chain to whitelist your program on.

Now, fill in your blockchain of choice among the options, and add your program ID. Click ‘Request whitelist’ to finish.

After this, you’ll notice a new request populate on the dashboard. This request will always have 1 of 3 different statuses:

Status	Explanation
Approved	The request has been approved and the program can be used for transactions through Coinflow
In review	The team has not yet reviewed your request. Please allow 24 hours for completion, or reach out to our team for support.
Rejected	The Coinflow team has rejected your request. Please try a different program.

📘 In Sandbox all requests are automatically approved

How to identify when your program has been whitelisted.

Here, we see Coinflow has approved our request and we can begin processing custom transactions. Done! You may request a whitelist for unlimited programs, although 1 or 2 is usually enough depending on your use case.