BitPay is a payment service provider platform that offers Bitcoin and Bitcoin cash payment services. To begin your BitPay integration, you must first create an account with BitPay. We recommend creating an account for production and another for testing purposes. Once you have completed the initial account setup, you can configure BitPay to work with DirectScale.

BitPay Setup

1. Access the BitPay Setup page in Corporate Admin using a direct URL in the following format: https://[CLIENTID].corpadmin.directscale[ENVIRONMENT].com/Corporate/Admin/BitPaySetup

   

2. Check the IsLive? box if configuring BitPay for your production environment. Otherwise, leave this unchecked.

   

3. Enter a ClientApplicationName. Choose a name you will recognize, as this name will appear when pairing with BitPay.
4. Enter a SecurityFilename.

   The SecurityFilename must not contain any spaces or special characters.

   

5. Click Save Settings.

   

6. Select Generate Key. This button will only appear if the filename does not exist and all fields are complete.

   

   A Pairing Code will generate.

   This code is valid for 24 hours.

   

7. Highlight the code and press Cntrl+C to copy the code to your clipboard

Managing API Tokens

Now that you have successfully generated and copied the Pairing Code, it is time to enter it on the Manage API Tokens page.

1. Log in to your BitPay dashboard.
   
   • Production Sign-in URL: https://bitpay.com/dashboard/
   • Test Sign-in URL: https://test.bitpay.com/dashboard/
2. Select Payment Tools from the side navigation menu.

   

3. Click on the API Tokens section.

   

4. Paste the Pairing Code into the search field and click Find.

   

   The Client ID will appear if the entry was successful.

5. Click Approve.

   

   The DirectScale Client appears in your Tokens list. Your BitPay DirectScale integration is now complete.

   

Mapping BitPay

Admin: Corporate Admin
Page: Settings > Company Settings > Payment Methods
URL: [CLIENTID].corpadmin.directscale[ENVIRONMENT].com/Corporate/Admin/CountryPaymentMap
Permission: ViewAdministration()

To make BitPay available, you must map it to your regions and stores.

Refer to Mapping New Market Payment Methods for an in-depth guide on mapping a new Payment Method.

Testing BitPay

Before you begin testing BitPay, you will need to complete the following tasks:

• Create a test Associate
• Create a test inventory item
• Access BitPay's testing documentation

To test BitPay transactions:

1. Impersonate an Associate. 
2. Add the test inventory item to your cart.

3. Click PROCEED TO CHECKOUT.

   You navigate to the Order Checkout page.

4. Select BitPay from the Add Payment section.

   Do not select BitPay from Saved Payment Methods.

5. Click FINISH.
6. Log in to BitPay.
7. Select your Wallet and Currency.
8. Click Pay In Wallet.

9. Click Pay.

   A confirmation message will appear to confirm if the payment was successful.

10. Select Return to DirectScale to return to the Order Complete page in Web Office.