Payment Links

Payment links are links that direct your shoppers to a Beam-hosted checkout that allows you to securely accept payments without the need for a full-fledged integration.

Currently only single use payment links are supported. This means that once a payment link is used to make a payment, it cannot be reused.

A payment link can have the following statuses:

ACTIVE: The payment link is active and can be used to accept payments. A newly created payment link will be in this state.
PAID: The payment link has successfully accepted a payment and cannot be reused.
EXPIRED: The payment link has expired and cannot be used to accept payments.
DISABLED: The payment link is disabled and cannot be used to accept payments.
VOIDED: The charge associated with the payment link has been voided. Therefore, the payment link can no longer be used to accept payments.
REFUNDED: The charge associated with the payment link has been refunded. Therefore, the payment link can no longer be used to accept payments.

You can see the API reference for payment links at Payment Links API.

Creating a Payment Link

Payment links can be created via your merchant account in Lighthouse or via API calls to Beam. For more information regarding creating payment links via API calls, please refer to the API Reference.

After creating a payment link, it cannot be deleted or modified. However, you can disable an ACTIVE payment link to prevent the payment link from being used for payment processing.

Sample Diagram of a Payment Link Flow

payment-links

A shopper needs to pay a merchant for something they bought or a service they received.
The merchant then sends a request to create a payment link via POST /api/v1/payment-links.
Beam returns a payment link object to merchant. This contains the id of the payment link,and the URL of the payment link.
The merchant can then redirect the shopper to the checkout page by extracting the url field from the payment link object.
The shopper is directed to the checkout page by the link, pays by filling in information in the Beam-hosted checkout page.
If configured, Beam sends a charge.succeeded webhook to the merchant's server indicating that the charge has been processed successfully.
The merchant processes the webhook and returns an acknowledgment to Beam.
Beam redirects shopper to the payment completion page.

TIP
You can redirect customer to a custom URL after the payment is completed by providing the redirectUrl field in the payment link creation request.

You can read more details about the webhook in the Webhook guide.

Payment Links

Payment links are links that direct your shoppers to a Beam-hosted checkout that allows you to securely accept payments without the need for a full-fledged integration.

Currently only single use payment links are supported. This means that once a payment link is used to make a payment, it cannot be reused.

A payment link can have the following statuses:

ACTIVE: The payment link is active and can be used to accept payments. A newly created payment link will be in this state.

PAID: The payment link has successfully accepted a payment and cannot be reused.

EXPIRED: The payment link has expired and cannot be used to accept payments.

DISABLED: The payment link is disabled and cannot be used to accept payments.

VOIDED: The charge associated with the payment link has been voided. Therefore, the payment link can no longer be used to accept payments.

REFUNDED: The charge associated with the payment link has been refunded. Therefore, the payment link can no longer be used to accept payments.

You can see the API reference for payment links at Payment Links API.

Creating a Payment Link

Payment links can be created via your merchant account in Lighthouse or via API calls to Beam. For more information regarding creating payment links via API calls, please refer to the API Reference.

After creating a payment link, it cannot be deleted or modified. However, you can disable an ACTIVE payment link to prevent the payment link from being used for payment processing.

Sample Diagram of a Payment Link Flow

A shopper needs to pay a merchant for something they bought or a service they received.

The merchant then sends a request to create a payment link via POST /api/v1/payment-links.

Beam returns a payment link object to merchant. This contains the id of the payment link,and the URL of the payment link.

The merchant can then redirect the shopper to the checkout page by extracting the url field from the payment link object.

The shopper is directed to the checkout page by the link, pays by filling in information in the Beam-hosted checkout page.

If configured, Beam sends a charge.succeeded webhook to the merchant's server indicating that the charge has been processed successfully.

The merchant processes the webhook and returns an acknowledgment to Beam.

Beam redirects shopper to the payment completion page.

TIP

You can redirect customer to a custom URL after the payment is completed by providing the redirectUrl field in the payment link creation request.

You can read more details about the webhook in the Webhook guide.