Introduction
Overview
Chargent REST API is a payment processing solution that helps businesses accept and process payments online.
Objects
There are six objects involved in Chargent REST API requests and responses.
Object | Definition |
---|---|
Chargent Order | Chargent Orders contain information related to the order such as billing information, total amount, due balance, and charge amount. They are central objects to payments lifecycle management. |
Payment Gateway | Payment Gateways track all the configuration settings that Chargent will use to proccess the payments and send requests to the gateway. |
Payment Method | Payment Methods are items that may be used to make or take payment. |
Token | Tokens are the strings used to represent the payment instrument account details at the gateway or other payment service provider. Payment tokens replace sensitive payment account data with a different data called a “token” and the token strings cannot be decrypted. |
Chargent Transaction | Transactions record the results of the requests made to the payment gateway on the Chargent Order. Transactions are also used to make additional requests in the payments lifecycle. |
Log | The Chargent Log object retains the history of actions taken in Chargent. |
Payments Lifecycle
Businesses have many different needs for payment processing workflows. The general sequence of operations to create a successful payment Sale operation includes the following five steps:
- Create Payment Gateway
- Create Payment Method
- Create Chargent Order
- Create Payment Authorization
- Create Payment Capture
Many varitions on this workflow exist, and this sequence may also be followed with additional operations, such as Void and Refund. Additionally, a Sale operation combines an Authorization and Capture into a single payment operation.
Headless Requests
Add the Chargent-Headless HTTP Header to the POST request and Chargent will not store payment gateway response data in Salesforce.
Methods
Chargent supports two methods for headless requests.
Method | Definition |
---|---|
Payment Method Tokenization | Payment Method Tokenization is the exchange of payment data for a token representation provided by the payment gateway for PCI Compliance. This is an initial step in the payments lifecycle. |
Payment Sale | Payment Sale will perform both a Payment Authorization and a Payment Capture in a single payment operation request. |
Learn More
Learn more about Headless Requests