Bitfinex Pay

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, and there are zero processing fees for using the service.

Supported cryptocurrencies include Bitcoin (including over the Lightning Network and the Liquid Network), Ethereum, Tether USDt Token (over Ethereum, Tron and the Liquid Network), with more to come.

For Merchants:

• How does Bitfinex Pay work
• How to set up Bitfinex Pay
• 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:

• 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
• How to pay with my Bitfinex account

For Merchants

How does Bitfinex Pay work

1.   Your customers click the Bitfinex Pay button on your product page when checking out.
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.

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. Here, apply for the Merchant verification; 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.
   You will need to do this by checking the Merchant Account box and accepting the Merchant terms.
   
5. Verify your sub-account.
   Note: Your sub-account can inherit the verification status of your main account, so this process does not require you to wait too long.

Step 2: Create a deposit address

1. Log in to your new Merchant sub-account and navigate to the deposits page.
2. Generate the cryptocurrency deposit addresses in the currencies that you will receive payments in.
   Note: In order to track your funds, please check the addresses of your Bitfinex Exchange wallet. 

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.
2. Next, create an order with the authenticated API endpoints. The API endpoints that 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.
   With the following 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 
  • 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 website!
   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 the 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: Tracking payments

Congratulations! You have now integrated Bitfinex Pay into your website. Bitfinex will call your API endpoint webhook in order 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.

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.

Step 6: 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 in order to setup and customize it:

• Title: Adds a text which will be shown on your check-out next to the Bitfinex Pay button.
• Description: Adds a description below the Bitfinex Pay button.
• Instructions: Adds a text that will be included to 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, for more information please view: How to create and revoke a Bitfinex API Key
• API Secret: Here you should enter your Bitfinex API key secret.
• Button theme: 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 debug messages to the WooCommerce System Status log.
• Pay currencies: Lets you select the payment crypto currencies that you want to accept. To add more than one currency, hold the ctrl/cmd button.
• Currency: Lets you select the base currency you want to use.
  Note: Currently only USD is available, more 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 and 86400 seconds.

Step 7: Tracking payments

Congratulations! You have now integrated Bitfinex Pay into your website. Bitfinex will call your API endpoint webhook in order 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.

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. They will have the following options available:

1. To copy the address shown in the QR code and in the address box below, then pasting it to their wallets and making a transaction;
2. To log in to their Bitfinex account and to pay directly from Bitfinex;
   Note: Customers making 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 an internal transfer within Bitfinex; the transaction will not be broadcast on the blockchain and will therefore also be faster than on-chain transactions.
3. To connect to other wallets such as Metamask and to pay directly.
   

Can I change the KYC information afterwards

Yes, but you will need to contact Bitfinex Customer Support in order to update any information on your profile. This includes such information as your social media handle and the addition of more tokens from the available supported tokens.

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

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 USD equivalent. For more information, please see Minimum Withdrawals.

Note: The maximum invoice amount is $ 1,000 (equivalent).

For Customers

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 or through other wallets, such as Metamask.

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 USD 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 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 USD equivalent; 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 with regards to 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.

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

If you have any questions, please feel free to reach out to us at Bitfinex Support. We are happy to help!