Charges

A charge is an attempt to pay to a merchant via Beam which contains information about the payment, such as amount, currency, payment method, and status. It can come from charge sources, such as payment links or API calls.

A charge can be in one of the following states:

PENDING: The charge is being processed and the final outcome is not yet known.
SUCCEEDED: The charge has been successfully processed. A transaction will be created for this charge.
FAILED: The charge is unable to be processed. This can happen due to various reasons such as insufficient funds, card declined, etc. The accompanying failureCode field will provide more details on the failure reason.
- CH_PROCESSING_FAILED means that the charge could not be processed due to an error.
- CH_INSUFFICIENT_FUNDS means that the charge could not be processed due to insufficient funds.
- CH_AUTHENTICATION_FAILED means that the charge could not be processed due to authentication failure for the payment method.

Charge Status Life Cycle

charges-status

Charge Sources

Charge sources are the different sources that a charge could come from. Each charge source can support different payment scenarios based on your business needs. This value is fixed by Beam and cannot be changed by the merchant. Currently, the following charge sources are supported:

Payment Links (PAYMENT_LINK)
API (API)
Store Links (STORE_LINK)
QR PromptPay Link (QR_PROMPT_PAY_LINK)