Skip to main content

​
Configuration in the HUB2 Dashboard

To use payment links, you need an API key with the required permissions. You can configure your API keys from the dashboard.
1

API Key Configuration

Generate a new API key with the permissions for Payment Links:
  • Go to Management → Developers
  • Click Create a key
  • Select the following permissions during creation:
    • Api.payment_intent_create: create and close payment links
    • Api.payment_intent_read: retrieve and list payment links

API Key

​
Supported Providers

For mobile money, a payment link accepts any provider enabled for the link’s country. Providers that are not available in that country are rejected when the link is created. Card payments (credit_card) do not use the providers list. They go through the card provider configured for your merchant account, and are available only when card payments are enabled on your account.
A payment link is only valid for one country. To collect payments with providers from different countries, create one payment link per country.

​
Card payments

To offer credit_card on a link, your merchant account must meet all of these conditions:
  • a card provider is configured on the account
  • that card provider is available in the link’s country
  • the account does not pass payment fees on to the customer, which card payments do not support
Card payments are not self-service: contact HUB2 support to have them enabled on your account. These conditions are checked when the link is created, and checked again each time a customer pays. A multi_use link can outlive the settings it was created under, so a card payment can be refused on a link that was created successfully. In that case, the checkout page tells the customer that card payment is unavailable. See Card payments for the error codes and the checkout behavior.

​
Get Help

If you encounter issues during configuration, contact our support team and include the error messages you received.