Skip to content

Setup

Everything an administrator configures once. You will not touch most of it again after go-live, with the exception of gateway credentials and email templates.

Page What it covers
Connect a payment gateway Adding credentials so ChargeOn can reach a gateway
Verify gateway credentials Confirming the connection works before you take live money
Route payments between gateways Sending transactions to different gateways by rule, and falling back on failure
Map fields to your objects Telling ChargeOn where to read customer and amount data from
Show payments on your own records Putting invoices, transactions and billing schedules on the record you bill from
Customise notification emails Changing what customers receive for links, receipts and credit memos
Rotate the encryption key Replacing the key that protects stored credentials
Set up multicurrency payments Scoping gateways to currencies and understanding how ChargeOn picks one

Connect a gateway before anything else

Every other page in this guide assumes at least one gateway is connected and verified. Nothing in ChargeOn can move money until that is true.

The Order That Actually Matters

Most of this section can be read in any order once a gateway exists, but three pages build on each other:

  1. Connect a payment gateway. Nothing else in this guide works until a gateway is connected.

  2. Verify gateway credentials. Do this immediately after connecting, before you rely on the gateway for anything else.

  3. Map fields to your objects. This needs a connected, verified gateway to point at. It is also where you assign the notification email templates and, optionally, fallback gateways.

Rotate the encryption key and set up multicurrency payments are independent of this sequence. Come back to them whenever they apply to you.