What is Bitfinex Pay
Bitfinex Pay is a crypto payment processor that allows businesses/merchants to receive crypto payments into their Bitfinex account for products sold or services rendered.
Using Bitfinex Pay is a swift process; payments (up to $1,000 equivalent per 24 hours per end customer) will usually be received within minutes. There are zero processing fees for using the service.
Currently, supported cryptocurrencies include:
|
|
For Merchants:
- How does Bitfinex Pay work
- How to set up Bitfinex Pay
- What payment methods are available
- Manual Invoice Generator
- Can I change the KYC information afterwards?
- What do the different invoice statuses mean?
- What happens if the customer pays the wrong amount?
- What are the invoice limitation amounts?
For Customers:
- How to pay with my Bitfinex account
- Do I have to be a Bitfinex user to use Bitfinex Pay?
- What information is required to make payment?
- Are there any restrictions for using Bitfinex Pay?
- What happens if the amount I paid does not match the amount of my order?
- I didn’t receive the item I purchased. What can I do?
For Merchants
How does Bitfinex Pay work
1. When checking out, your customers click the Bitfinex Pay button on your Product page.
2. Upon clicking, they will be directed to the Bitfinex payment gateway page. (This page contains your customers’ order details.)
3. The countdown shows the remaining amount of time to complete the payment.
4. Your customers will be redirected back to your website upon successful payment.
Note: If your customer does not complete the payment before the countdown period, the invoice will be marked as Expired, and the customer will need to create a new payment request. You can customise the time for the payment countdown when you configure the authenticated API endpoints. You can also configure it from WordPress after installing the Bitfinex Pay plugin.
How to set up Bitfinex Pay
Step 1: Verify and create a sub-account
1. Firstly, log in to your Bitfinex account. If you don’t have one yet, don’t worry, creating one takes only a few minutes here.
2. Then, go to the Verification page and verify your account to the Intermediate level of verification.
3. Once your account has been verified at least to the Intermediate level, apply for the Merchant verification on the Verification page; you will find this option under the verification required fields and will need to fill in information relevant to your product/business.
Note: After your application has been submitted, if you would like to update any Merchant profile details, please contact Bitfinex Customer Support.
4. Once the verification has been completed, go to your Sub-Accounts page and set up a new sub-account specifically for Bitfinex Pay purposes. Also, you will need to check the Merchant Account box and accept the Merchant terms.
5. Verify your sub-account.
Important: Your sub-account will inherit the verification status of your main account.
Note: Currently, you can only create one merchant sub-account per Master account.
Step 2: Create deposit addresses for each of the tokens
1. Log in to your new Merchant sub-account and navigate to the Deposit page.
2. Generate a cryptocurrency deposit address for each of the currencies you want to support in your checkout.
Note: To track your funds, please check the addresses of your Bitfinex Exchange wallet.
Important: For Lightning BTC, select the minimum payment allowed as the amount ($0.10 equivalent)
Step 3: Configure the API endpoints
1. Firstly, you will need to have your API Key. To create your API Key, follow the steps here.
Note: Make sure “Edit account information” and “Create and cancel orders” permissions are ON.
2. Next, create an order with the authenticated API endpoints. The API endpoints you will need to use to configure Bitfinex Pay options can be found in our API documentation. The Merchant specific endpoints can be found here.
The options available for customisation:
- Submit Invoice (to submit an invoice for payment):
https://docs.bitfinex.com/reference#submit-invoice. - Invoice List (to list submitted invoices):
https://docs.bitfinex.com/reference#invoice-list. - Complete Invoice (to mark invoices as completed):
https://docs.bitfinex.com/reference#complete-invoice. - Key Permissions (to retrieve current API key/token permissions):
https://docs.bitfinex.com/reference#key-permissions.
Step 4: Integrate Bitfinex Pay
1. Now you are ready to integrate Bitfinex Pay with your product store!! Firstly, go to https://pay.bitfinex.com/merchant/.
2. Then, navigate to the Widget setup tab and scroll down to point seven, where you will find a button snippet.
3. After clicking the button snippet, a pop-up will appear, allowing you to add the order ID into the coding [your_order_id]
4. Here, you can choose between a dark or a light theme for the Bitfinex Pay button.
5. Select Copy code to get the HTML code that you can embed on your Check-out page.
6. Now, the Bitfinex Pay widget will be integrated, giving your customers a choice to pay using cryptocurrency through Bitfinex!
Note: Additionally, Merchants have the option to download the Bitfinex Pay plugin from WordPress. The plugin requires the WooCommerce plugin to be installed first. To view the steps, check out the WordPress plugin section. Furthermore, it can also be accessed from our REST API Node.JS library here or the WordPress Directory. You can find more information in Bitfinex’s GitHub repository.
Step 5: Configuring Bitfinex Pay in WordPress
If you are using WordPress plugin to configure Bitfinex Pay, there are several settings that you will need to fill in to set up and customise it:
- Title: Adds a text which will be shown next to the Bitfinex Pay button on your check-out.
- Description: Adds a text which will be shown below the Bitfinex Pay button on your check-out.
- Instructions: Adds a text that will be included in the emails your customer receives when he starts an order and when the payment is confirmed. You can choose to leave this blank if you do not want to add any text.
- API URL: By default, it is https://api.bitfinex.com/.
- Redirect URL: By default, it is https://pay.bitfinex.com/gateway.
- API Key: Here, you should enter your Bitfinex API Key. Please view How to create and revoke a Bitfinex API Key for more information.
- API Secret: Here, you should enter your Bitfinex API key secret.
- Button theme: This lets you select the type of button image to display on the cart and Check-out pages. You can choose either light or dark variants.
- Enable/Disable one-click check-out button for products: This will show/hide the Bitfinex Pay button on your store.
- Debug: Sends the debug messages to the WooCommerce System Status log.
- Pay currencies: This lets you select the payment cryptocurrencies you want to accept. To add more than one currency, hold the ctrl/cmd button.
- Currency: This lets you select the base currency you want to use.
Note: Currently, only USD, EUR and GBP are available; more fiat currencies will be added in the future.
- Duration: Controls the expiration time for invoices in seconds. This sets the time your customers will have to complete the transaction. Time amounts must be between 300 seconds (5 minutes) and 86400 seconds (24 hours).
Step 6: Tracking payments
Congratulations! You have now integrated Bitfinex Pay into your website. Bitfinex will call your API endpoint webhook to update the status of each payment. Successful payments will be deposited in your Merchant sub-account Exchange wallet, and each payment will be accompanied by an order number that relates to the product sold or service provided. For more information, please refer to our Documentation page.
Important: To refund your customers, please ensure you do so in the same token as the payment received and to the same wallet address of your buyer.
What payment methods are available
After your customer confirms a purchase and is ready to pay, an invoice will be generated. The customer will then choose how to make the payment. There will be three different payment options available.
Pay with Bitfinex
Your customer will need to log in to their Bitfinex account and pay directly from Bitfinex.
1. Pay with Crypto: Your logged-in customer will be able to pay with their crypto funds on Bitfinex.
Note: Customers making crypto payments do not have to be Bitfinex users. If your customer is a Bitfinex user, they can log in via the Pay with Bitfinex button, and it will be considered as an internal transfer within Bitfinex; the transaction will not be broadcasted on the blockchain and will therefore also be faster than on-chain transactions.
2. Pay with Credit Card: Your logged-in customer will be able to buy the amount of crypto required for the purchase with their credit card using one of our providers. Please view How to buy crypto on Bitfinex instantly for more information.
Note: Depending on the provider and token selected by the customer, the minimum amount to pay with a credit card may vary from $25 to $35 in equivalent.
Important: To pay with a credit card, you will need to verify your Bitfinex account to the Intermediate or higher level. Only non-corporate, individual accounts may use Credit Card Payments.
Pay with your Wallet
- WalletConnect: WalletConnet is a service that allows users to easily connect to their preferred wallets to complete payments with Bitfinex Pay. Users can choose from more than 100 wallets. You can find the complete list here.
Your customer will be able to choose WalletConnect after selecting the Pay with your Wallet option. Then, a QR code will be shown, which the user can scan from their preferred compatible wallet to link to Bitfinex Pay easily.
Note: Currently, WalletConnect is only compatible with ERC-20 tokens.
- Wallet integrations: Your customer will be able to connect to other wallets such as Metamask to pay directly.
Currently, only Metamask and WalletConnect are available, but we are working on adding more wallets and hard-wallets in the future.
Note: Currently, only ETH, MATIC (Ethereum) and USDt (Ethereum) are compatible with Wallet Payments
Manual Payment
Your customer will need to copy the address shown in the QR code and in the address box below, then paste it to their wallets and make a transaction. This can be done from any wallet or exchange with compatible Bitfinex Pay tokens.
Manual Invoice Generator
As a verified Merchant account on Bitfinex, you will be able to manually generate invoices without the need to integrate Bitfinex Pay with your store. This also allows you to create a custom order for a specific client if needed.
How to manually generate an invoice on Bitfinex Pay
Access this link and complete all the required information below:
- Order Number: An order ID so you can identify this payment.
- Expiration Time: Controls the expiration time for this invoice in hours and minutes. This sets the time your customer will have to complete the transaction. Time must be within 5 minutes and 24 hours.
- Redirect URL: Where your customers will be redirected after payment completion.
- Price: Price amount in fiat, currency depends on the Currency field you select.
- Currency: Fiat currency for the price.
Note: Currently, only USD, EUR and GBP are available; more currencies will be added in the future.
- Tokens: Available tokens your customer will be able to pay with in this invoice
- Customer Info: Your customer’s full name, email and nationality
- Customer full address: Your customer’s full address.
Once all the fields have been filled out, click on Create Invoice to generate.
Bitfinex Pay (For Merchants) — Frequently Asked Questions (FAQ)
— Can I change the KYC information afterwards?
Yes, but you will need to contact Bitfinex Customer Support to update any information on your account and/or profile.
Note: While you await your new KYC information to be updated, you can continue to receive deposits in the tokens chosen previously during KYC.
— What do the different invoice statuses mean?
An invoice will have different statuses, starting from when the invoice is created until the time the funds are received in your account:
- Created: An invoice has been created;
- Pending: A deposit is pending confirmation to your account (for information on cryptocurrency deposit times, please view Where is my cryptocurrency deposit or withdrawal);
- Completed: A deposit has been completed, and the payment amount and invoice amount was exactly matched;
- Expired: An invoice payment time has expired, meaning that the funds were not deposited in the required countdown period provided.
— What happens if a customer pays the wrong amount?
If the payment is marked in your account as a normal deposit and not as a Pay Invoice transaction, this means that the customer used the Manual Payment option and paid an amount different from the required amount.
To view the details of your payments, please visit your Reports > Ledgers.
In such cases, it is entirely up to you as to how to arrange refunds for your customer.
Please note:
- You should only deliver your products if the invoice is marked as Completed.
- If your customers do not agree to the Bitfinex Pay End User Terms of Service, the funds will be deposited to your account as a normal deposit, and the status of the invoice will stay as Created even though the funds have been deposited to you. In this case, you should arrange for a refund.
- According to Bitfinex Terms of Service, we will be unable to offer services if your customer is from a Prohibited Jurisdiction or is a Prohibited Person. Please also make a note of the Merchant Terms of Service.
— What are the invoice limitation amounts?
The minimum invoice amount is $0.1 equivalent.
If your customer is a Bitfinex user who authenticates their Bitfinex account via the Pay with Bitfinex button, they can pay the minimum invoice amount equivalent, which will be deducted from their Bitfinex wallet balance.
However, if your customer is a Bitfinex user who makes the payment through the transaction address provided in the encrypted QR code or from the address box, they will be subject to the minimum withdrawal amount of $5 equivalent. For more information, please see Minimum Withdrawals.
Note: The maximum invoice amount is $ 1,000 (equivalent).
— Is there a guide on how to set up Bitfinex Pay for Merchants?
Yes, you can look at our Bitfinex Pay Merchant Setup Guide that can be downloaded here.
For Customers
How to pay with my Bitfinex account
If you already have a Bitfinex account, you can pay directly by logging in to your account.
1. At the bottom of the payment invoice, find a Pay with Bitfinex button.
2. Tap on this option to log in to your Bitfinex account and pay with the funds on your Bitfinex Exchange wallet.
If you are already logged in, you will be directed to the Invoice page to confirm the payment.
Note: You will be prompted to fill in your Bitfinex account 2FA. You can choose between Google Authenticator or U2F, depending on which Bitfinex account security setting you have enabled.
3. As a Bitfinex user, you can also buy the crypto amount with one of our credit card payment providers.
Important: To use a credit card, you will need to verify your Bitfinex account to the Intermediate or higher level.
4. When you have confirmed the payment, the funds will be deducted from your Bitfinex account and credited to the Merchant.
Note: As it will be considered an internal transfer within Bitfinex, no fees will incur, and the transaction will not be broadcasted on the blockchain and will therefore also be faster than on-chain transactions. The minimum invoice amount that you will be able to pay is $0.1 equivalent.
Bitfinex Pay (For Customers) — Frequently Asked Questions (FAQ)
— Do I have to be a Bitfinex user to use Bitfinex Pay?
No, customers making payments using Bitfinex Pay do not have to be Bitfinex users.
You can select to pay through either Bitfinex, through other wallets such as Metamask or send a Manual Payment from any wallet or exchange.
If you want to pay as a Bitfinex user, you will need to authenticate your account via the Pay with Bitfinex button in order to pay invoice amounts smaller than $5 equivalent and have the benefits of internal transfers within Bitfinex.
If you do not authenticate your Bitfinex account via the Pay with Bitfinex button, the invoice can still be manually paid by using the address provided in the encrypted QR code or from the address box. However, the transaction will be subject to the minimum withdrawal amount on Bitfinex, which is $5 equivalent if the payment comes from a Bitfinex wallet; for more information, please view Minimum Withdrawals.
— What information is required to make payment?
Certain information is taken from a user to correspond with legal and regulatory requirements.
For details, please view the Bitfinex Pay - Privacy Statement.
— Are there any restrictions for using Bitfinex Pay?
According to the Bitfinex Terms of Service, we will be unable to offer services if you are from a Prohibited Jurisdiction or are a Prohibited Person.
Note: When using Bitfinex Pay, you will also need to agree to the Bitfinex Pay End User Terms of Service in order for your payment to be processed properly.
— What happens if the amount I paid does not match the amount of my order?
Merchants must receive the exact amount displayed in the invoice. It is important to make sure to add any network or withdrawal fees on top of the invoice amount. If the amount transferred doesn’t exactly match the amount of the invoice, the Merchant will not be able to deliver the goods or services as the invoice associated with your purchase will not be able to be identified as Completed.
Here we advise that you contact the Customer Support of the website/Merchant and inquire relevant information about a refund.
— I didn’t receive the item I purchased. What can I do?
Please reach out to the website/Merchant directly regarding any issues with your order or an update on your order status.
If you have any questions, please feel free to reach out to us at Bitfinex Support. We are happy to help!
