Salesforce Billing Developer Guide

Salesforce Billing Fields on Standard Objects
Salesforce Billing Custom Objects
Salesforce Billing Standard Objects
Salesforce Billing Developer Guides & Lightning Components
Salesforce Billing Payment Gateway Developer Guide
Get Started with Salesforce Billing Payment Gateway API
Payment Gateway Class Reference
CaptureInputParameter Class
CaptureOutputResult Class
Payment Gateway Core Classes
InputParameter Class
OutputResult Class
PaymentGateway Interface
PaymentGateway Methods
PaymentGateway Example Implementation
PaymentGateways Interface
PaymentGatewayParameter Class
PaymentGatewayStatus Interface
TransactionAPI Class
TransactionParameter Class
TransactionResult Class
TransactionResult.GatewayStatusType Enum
Custom Gateway Classes
Salesforce Billing Tax Integration Developer Guide
Revenue Recognition Service Developer Guide
Hosted Card Payments Lightning Component
REST API for Converting Invoice Lines with Negative Balances
Set Up Standalone Orders with API
Salesforce Billing Apex Reference
PDF

Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

PaymentGateway Interface

Interface for standard payment transaction operations such as voids and refunds.

Namespace

blng

Usage

A gateway implementor uses logic such as paymentGatewayParameter.getTransactionType() == "generateToken" and calls underlying payment transaction functions. Similar logic applies for voids, refunds, and other actions.

PaymentGateway Methods

The following are methods for PaymentGateway.

generateToken(mapOfTransactionParameterById)

Generates a token for a payment method.

Signature

global Map<String, TransactionResult> generateToken(Map<String, TransactionParameter> mapOfTransactionParameterById)

Parameters

mapOfTransactionParameterById
Type: Map<String, TransactionParameter>
Map of parameter is based on the payment gateway.

Return Value

Type: Map<String, TransactionResult>

List of Transaction Results : List<TransactionResult>

chargeTransaction(mapOfTransactionParameterById)

Authorize and capture a credit card payment and ACH payment.

Signature

global Map<String, TransactionResult> chargeTransaction(Map<String, TransactionParameter> mapOfTransactionParameterById)

Parameters

mapOfTransactionParameterById
Type: Map<String, TransactionParameter>
Map of parameter is based on the payment gateway.

Return Value

Type: Map<String, TransactionResult>

List of Transaction Results : List<TransactionResult>

voidTransaction(mapOfTransactionParameterById)

The Void transaction type can cancel either an original transaction or a transaction that hasn't been settled.

Signature

global Map<String, TransactionResult> voidTransaction(Map<String, TransactionParameter> mapOfTransactionParameterById)

Parameters

mapOfTransactionParameterById
Type: Map<String, TransactionParameter>
Parameter map is based on the payment gateway.

Return Value

Type: Map<String, TransactionResult>

List of Transaction Results : List<TransactionResult>

authorizeTransaction(mapOfTransactionParameterById)

Authorizes a credit card payment. To perform a charge transaction, the user must follow the authorization with a capture transaction.

Signature

global Map<String, TransactionResult> authorizeTransaction(Map<String, TransactionParameter> mapOfTransactionParameterById)

Parameters

mapOfTransactionParameterById
Type: Map<String, TransactionParameter>
Map of parameter is based on the payment gateway.

Return Value

Type: Map<String, TransactionResult>

List of Transaction Results : List<TransactionResult>

refundTransaction(mapOfTransactionParameterById)

Refund a customer for a transaction that wsa successfully settled through the payment gateway.

Signature

public Map<String, TransactionResult> refundTransaction(Map<String, TransactionParameter> mapOfTransactionParameterById)

Parameters

mapOfTransactionParameterById
Type: Map<String, TransactionParameter>
Map of parameter is based on the payment gateway.

Return Value

Type: Map<String, TransactionResult>

List of Transaction Results : List<TransactionResult>

PaymentGateway Example Implementation

The YourGatewayAPI class implements the PaymentGateway, PaymentGateways, and PaymentGatewayStatus interfaces.