# Payment methods

When setting up your online shop you have to set up payment methods.

  1. Go to the Settings page in your DG1 admin panel and click Payment methods.

    payment methods

  2. Click Add Add button .

    add payment methods

  3. Select a payment method and click Add Add button green .

    select

Note

Keep in mind that you can only select one payment method at a time.

If you want to have the possibility of paying with credit cards in your online shop, you can choose between different payment providers, such as Billplz, Braintree, Stripe and Payrexx, or choose alternative payment methods such as PayPal or Coinbase.

At the links provided below, you can get all the information for setting up account with each payment service provider:

Note

Before publishing your site, be sure to check if you are using production credentials for payment methods like PayPal, Stripe or Braintree.

  1. Payment provider image
    Each payment provider can be represented with an image in the front end, which helps your customers recognize available payment methods. To add an image to your current payment method, click Select image Select image button , choose a file from your file selector or simply upload the image to the system and click Select & close Select and close button .
  2. Limit payment methods based on selected shipping method
    You can limit each payment method so that it is only available for specific shipping methods. By default the payment method is available for all the shipping methods that you’ve added to the system. To limit a payment method, uncheck the specific shipping methods and leave the check mark only with those shipping methods that you wish to connect to the current payment method

Limit paymenth metod by shipping

Note

When you have multiple sites, you need to add payment methods for each site individually.


# In this section


# Setting up Billplz

  1. To add Billplz as your payment method, you will need to choose the Payment method name and fill out the following form:

Billplz payment method details

Once you have your Billplz profile, you must copy/paste the following information into the above form:

  • API secret key
  • XSignature key
  • Collection ID

Here are short instructions on where to access them:

  • Open your Billplz profile, access to your Billplz Account Settings
  • Under Keys & Integration you can find API secret key and XSignature key
  • Click on to Copy Billplz Secret Key button and Copy XSignature Key button

Billplz keys

  • To obtain the data needed for the Collection ID field, go to the Billing/Payment Form/Payout API section.
  • Click on the Copy button and paste it into your platform

Billplz collection id

  1. Add any additional settings to the payment method and click Submit Submit button green .

Important

Billplz only supports payments in Malaysian Ringgit currency (MYR). This payment method is available in DG1 only when using MYR currency. "XSignature Payment Completion" must always be enabled in Billplz, otherwise payments will fail to complete in DG1.

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Setting up Braintree

  1. To add Braintree as your payment method, you will need to choose the Payment method name and fill out the following form:

braintree details

  • Once you have your Braintree profile, you must copy/paste the following information into the above form:
    • Payment method name
    • Your merchant ID
    • API public key
    • API private key
    • Merchant for your shop’s currency

Here are short instructions on where to access them:

  • Open your Braintree profile, click the Cogwheel and select API.

braintree API

  • Click View on the API Keys page, where you can find the following information:
    • API Public key (Public key)
    • API Private Key (Private key)
    • Merchant ID

braintree ApiKey

  • To obtain the data needed for the Merchant for your shop’s currency field, click the Cogwheel in your Braintree profile and select Business.

braintreeBusiness

This is where you will find the Merchant Accounts from where you can copy a Merchant Account ID into your Merchant for your shop’s currency field.

  • Optional:
    • You can check Settle payments automatically. This means the payments will happen automatically, otherwise the payments will have to be settled manually in Orders section.
    • You can set Provision amount. Example: 30 cents.
  1. Add any additional settings to the payment method and click Submit Submit button green .

Important

Before publishing your site (going live), be sure to check if you are using production credentials for Braintree.

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Setting up Stripe

  1. To add Stripe as your payment method, you will need to choose the Payment method name and fill out the following form:

stripe_details

  • Once you’ve registered with Stripe.com, access your Stripe account and go to Developers and select API keys (left menu), where you can find the following keys you need to enter into the above form:
    • Publishable key
    • Secret key

1 stripe

  • Optional:
    • You can check Settle payments automatically. This means the payments will happen automatically, otherwise the payments will have to be settled manually in Orders section.
  1. Add any additional settings to the payment method and click Submit Submit Submit button green .

Important

Before publishing your site (going live), be sure to check if you are using production credentials for Stripe.

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Setting up Stripe Checkout

  1. To add Stripe Checkout as your payment method, you will need to choose the Payment method name and fill out the following form:

stripe_checkout_details

  • Once you’ve registered with Stripe.com, access your Stripe account and go to Developers and select API keys (left menu), where you can find the following keys you need to enter into the above form:
    • Publishable key
    • Secret key

1 stripe

  1. Add any additional settings to the payment method and click Submit Submit Submit button green .

Important

Before publishing your site (going live), be sure to check if you are using production credentials for Stripe.

Limitations: When using payment methods with delayed notification (Sofort, SEPA debit, Pre-authorized debit in Canada, OXXO, Boleto, BECS direct debit, BECS direct debit, Bacs Direct Debit, ACH Direct Debit) the order or booking in DG1 will be completed after the customer has initiated payment. You will have to check the payment status in Stripe's system to verify if the payment was successful or not. Konbini payments are not supported.

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Setting up Bank Transfer

  1. To add Bank Transfer as your payment method, you will need to choose the Payment method name and fill out the following form:

Bank transfer details

The following informations are mandatory:

  • Payment method name (mandatory)
  • IBAN (your International Bank Account Number) which is going to be displayed in the customer’s confirmation email.
  • BIC/SWIFT (your bank’s identifier/SWIFT) code that is going to be displayed in the customer’s confirmation email.
  • Payment reference - we suggest you insert your {orderId} which is going to be replaced by order id in the customer’s confirmation email.

Note

With this payment method we strongly advise you to use the Additional text field and provide your customers with payment instructions. You should also include information on the payment deadline or when the payment must be received.

  1. Add any additional settings to the payment method and click Submit Submit button green .

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Setting up PayPal Express

  1. To add PayPal Express as your payment method, you will need to choose the Payment method name and fill out the following form:

PayPal Express details

Once you’ve registered with PayPal, you have to create a new API signature (opens new window) and enter the following API credentials into the above form:

  • API username
  • API password
  • API signature

The following figure shows a page with an example of API signature credentials:

PayPal API signature

Optionally, you can also provide the following information:

  • Payment description: If you want, you can add a short payment method description, which will be shown on the front end under the name of your PayPal payment method.
  • You can also set the Provision amount, which will be added to the total price, for example 30 cents.

Note

PayPal generally does not allow charging any fees for accepting PayPal as a payment method without their written consent (see PayPal user agreement (opens new window)).

  • Additional text: Should you like to provide your customers with additional instructions in the order confirmation emails, you can use this field.
  • Custom image: You can set a custom image for this payment method to make it easier for your customers to recognize it on your site.
  1. To save a payment method click Submit Submit button green .

Important

Before publishing your site (going live), be sure to check if you are using production credentials for PayPay.

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Setting up Payrexx

  1. To add Payrexx as your payment method, you will need to choose the Payment method name and fill out the following page:

Payrex Details

To get the needed data for Instance name and Secret API key, visit the Payrexx site in a new tab to register. You will be prompted by Payrexx (image below) to provide your email address and enter a Desired name, which you should copy and paste in the Instance name field in the above payment configuration page on DG1.

Payrexx SignUp

Once you’ve created your Payrexx account, go to API & Integrations page to obtain the API key, which you should copy and paste into the configuration page in DG1.

Payrexx API Key

Next you should add your Webhook URL from DG1 to Payrexx. To add a webhook, simply copy the Webhook URL from DG1 and paste in the corresponding field in Payrexx and make sure the Webhook Type is set to Normal (PHP-Post).

Payrexx webhook DG1

Example of a Webhook URL:
tenant.dg1.com/api/shop/v1/payments_payrexx/payments_payrexx/update_transaction

Payrexx webhook

  1. Add any additional settings to the payment method and click Submit Submit button green .

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Troubleshooting Payrexx payment confirmation issues

In case a customer calls and tells you they have not received a payment confirmation, you can go to Payrexx and use the Trigger webhook function.

Go to Payments and select Transactions.

payment transaction

Find the transaction and click Trigger webhook.

Trigger Webhook

# Setting up Coinbase

  1. To add Coinbase as your payment method, you will need to choose the Payment method name and fill out the following page:

Coinbase_details

To obtain the Secret API key and Shared webhook secret, open commerce.coinbase.com (opens new window) in a new tab and register with Coinbase.

Coinbase registration

coinbaseRegistration

Once you’ve signed into Coinbase, go to Settings and find API keys.

coinbaseSetting

Click Create an API key.

coinbaseAPIKey

Once the key is created, click copy coinbaseCopy and paste it to your DG1 payment configuration page in the Secret API key field.

coinbaseAPICopy

Coinbase_Secret_api_key

After that copy the Webhook URL from your DG1 configuration page.

Coinbase_Webhook_URL

Go to Webhook subscriptions in Coinbase settings and click Add an endpoint.

coinbaseAddEndpoint

Paste the URL and click Save coinbaseSave.

coinbaseAddEndpointPaste

After that click Show shared secret.

coinbaseShowSharedSecrete

A key will appear.

coinbaseWebhookSharedSecreteCopy

Click copy Copy button and paste it to the Shared webhook secret in your DG1 configuration page.

Coinbase Shared Webhook secret

  1. Add any additional settings to the payment method and click Submit Submit button green .

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Setting up Datatrans

  1. To add Datatrans as your payment method, you will need to choose the Payment method name and fill out the following page:

Datatrans_details

To obtain the required data, open www.datatrans.ch (opens new window) in a new tab and register with Datatrans. After registering or signing in, go to UPP Administration.

datatrans-admin-steps-1

Copy all the URLs for Success, Error, Cancel and Post and paste them to matching fields in your DG1 platform.

Important

Make sure the Data in XML is selected under URL Post data format.

datatrans-admin-steps-2

Navigate to Security and copy the Sign.
Paste it to the matching field on your configuration page in DG1.

datatrans-admin-steps-3

Click the Server-to-Server services security.

steps-4

Copy the Username and paste it to the Merchant ID field on your configuration page in DG1.
Copy the password and paste it to the Merchant password field.

steps-5

  1. Add any additional settings to the payment method and click Submit Submit button green .

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

# Setting up On delivery

  1. To add On delivery as your payment method, you only need to choose the Payment method name – all the other information is optional.

On delivery details

  1. Once you’ve selected the name and added any additional settings to this payment method, click Submit Submit button green .

On the Payment methods page you can Edit edit details about all your payment methods and confirm any changes you’ve made by clicking Submit Submit button green .
This is where you can also disable/enable the payment method by clicking yes or no in the list of payment methods. You can do this separately for Shop and Booking.

Enable-disable

Copyright © 2022 DG1 Group Holdings Inc - All Rights Reserved - Terms of use - Privacy Policy - v0.2.2