Charge a customer

Take a single card, bank, or payment-link payment against a record, right now.

Before you start

• A gateway that's connected and verified, Active, and mapped to this record's object.
• The Charge action on this object's page layout — see Part 6 of the quick start guide if it's missing.
• You need the ChargeOn permission to take instant payments (part of the ChargeOn Admin, ChargeOn Operator or ChargeOn Standard User permission set).
• Know the gateway's Checkout Experience — it decides what the payment form looks like below. See Choose a checkout experience.

Steps

1. Open the record you want to charge.
2. Click Charge.
3. If more than one gateway is available, select it from Select Payment Gateway.

4. Choose the payment type — Card Payment, the bank-transfer option for this gateway (shown as ACH Payment, BECS Payment, E-Check Payment or SEPA depending on the gateway and currency), or Payment Link.

   On a gateway running the Redirect checkout experience, only one option appears here, named after the gateway itself — for example Stripe Link. Choosing it sends a payment link rather than collecting card details in Salesforce; see Send a payment link for what happens next.

5. Choose Instant.

6. Enter the payer's details — Payer Name, Email, and address if the form asks for it.

7. Enter the card or bank details.

   • On a Direct API gateway, the card or bank fields belong to ChargeOn's own form, inside Salesforce.
   • On a Hosted Fields gateway, the same fields sit inside a frame that belongs to the gateway — Salesforce never sees the card number.
   • On a Redirect gateway, there are no card fields here at all — see step 4.

8. Tick Customer consents to securely save this payment method for future payments if you want to keep the details on file. See Save a payment method.

9. Click Charge (or Send Payment Link on a Redirect gateway).

What you should see

A success message, and a new Transaction History record with status Success, the amount, and the gateway you charged. On a Redirect gateway, a payment link is generated instead — the Transaction History record starts at status Pending and updates once the customer completes the payment.

If you see \"Payment Requires Attention\"

This means the gateway took the money but Salesforce hit a system error saving the record immediately afterwards. ChargeOn logs it as an Unresolved Transaction instead of losing track of it. Do not retry the payment — that would charge the customer twice. Resolve it first; see Resolve unresolved transactions.

If it does not work

Symptom	Likely cause	What to do
"No payment gateways support {currency}."	No active gateway is configured for this record's currency	Check gateway configuration, or use a different gateway
"Your default payment gateway does not support {currency}."	The auto-selected gateway can't settle in this record's currency	Choose a compatible gateway from the picker
"Amount must be greater or equal to {X}."	The amount is below this gateway's minimum charge amount	Increase the amount, or use a different gateway
The card is declined	ChargeOn shows the gateway's own decline reason underneath the form	Read the message; try a different card, or a different gateway
The customer is asked to complete an extra verification step	The card requires 3D Secure — this is normal for that card, not a failure	Have the customer complete it; the charge finishes once they do
"Payment Requires Attention" / "Unresolved Transaction"	The gateway succeeded but Salesforce failed to finish saving the record	Do not retry — see the warning above
The Charge button doesn't appear	The action hasn't been added to this object's page layout	Part 6 of the quick start guide
The Charge button opens but no gateway is selectable	The gateway is inactive, or not mapped to this payment object	Check Active on the gateway record, then the gateway mapping under Global Settings