Versions Compared

Old Version 6

changes.mady.by.user Persia Xenopoulou (Deactivated)

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Back to Generic Gateways Main Page

Status
colourYellow
titleAvailable from CRM.COM R11.0.0

Excerpt
hiddentrue

Understand the usage of Payment Gateways within CRM.COM

Panel
nameblue

Table of Contents

Table of Contents

What are Payment Gateways?

Payment Gateways are third-party systems used to perform Payments. CRM.COM is  integrated with the Stripe Payment Gateway, however, it also supports partial handling of Payments for other third-party Payment Gateways, referred to as Generic Gateways. CRM.COM creates Requests for Payments that are intended for Generic Gateways and which can be further handled by WEB APIs. CRM.COM Web APIs can, for example, be used to collect all Payment Requests that require handling by a Payment Gateway, as well as to update CRM.COM with the results of the Payment Requests.  i.e., whether the Requests were completed or rejected.

Payment Gateways Glossary

TermDescription
Payment GatewayThird-party Systems that provide a framework for merchants to accept Credit Card and other forms of electronic payments.
Generic Payment Gateway ProviderThe Payment Gateways for which no direct integration exists with CRM.COM.
Stripe Payment Gateway ProviderStripe Payment Gateway Provider is a built-in integration of CRM.COM and the Stripe Payment Gateway.
Payment RequestA Request for Payment created within CRM.COM that requires processing by third-party Payment Gateways such as Stripe or by a Generic Payment Gateway.
"Pending Verification" PaymentPayments created in CRM.COM that require further processing by a third-party Payment Gateway. The CRM.COM Payment can only be posted once the Gateway updates CRM.COM that it was successful.
"Pending Verification" Payment Cancellation

Payments that have been cancelled in CRM.COM that require further processing by a third-party Payment Gateway. The CRM.COM Payment can only be posted once the Gateway updates CRM.COM that it was successful.
Payment Gateway account refunds customer when CRM.COM Payment Cancellation takes place.

Payment Gateway Merchant AccountThe Payment Gateway account owned by the business (your business), from where customer Payments will be effected and from where money is taken for refunds.
Payment Method

Payment Method is used to determine how a customer chooses to pay an amount of money and is defined when creating a Payment.

Payment Preference

Payment Preference is used to define the preferred method of paying an outstanding amount of money and is defined on the Accounts Receivable.

Payment Gateways Key Processes and Concepts

Processes / ConceptDescription
Automatic Wallet Top-upWallets are simple accounts which primarily handle the financial transactions involving Rewards and Prepaid Subscriptions. Funds from a Wallet are deducted usually when a Prepaid Subscription is billed or when a Rewards Participants redeem their Awards.
A functionality is available which detects whether the Wallet Balance has fallen beneath a certain threshold, in which case the System automatically creates a Payment Request to Top-up the Wallet to the Payment Gateway the customer is registered with.
This is particularly useful to avoid the interruption of a Subscription Service with a recurring fee, which requires automatic payments.
Automatic Bill PaymentUnsettled Bills can be directly paid by Requests made to the Payment Gateway. In this way, a Bill is always handled before it is due, without the customer worrying whether the Payment has been made. This functions like a Direct Debit Request, which in this case is electronically handled via a Payment Gateway.
Refunding Cancelled PaymentsWhen a Payment that was handled and successfully completed via a Payment Gateway is cancelled in CRM.COM, the customer must be refunded. A request is created to be handled by the Payment Gateway and to refund the customer accordingly, deducting money from the merchant's account.
Communicating Payment Gateway Information to Customers

Payment Gateway Cards and Requests can be communicated to customers through email or SMS using Communication Tags which will retrieve data specific to the customer. Lists of customer accounts (known as Segments) that have Payment Gateway Requests or Cards can be created and used in various parts of the System. One of the CRM.COM areas that can make use of Segments is Notifications, which can be used to send Communications in bulk, i.e. to all customers that belong in a Segment.


Payment Gateways Access & Viewing Controls

Business Network Characteristics define the level of access for each entry. i.e., whether it will be available for selection, viewing or editing.

EntityNetwork CharacteristicsDescription

Generic Gateway Provider

Global Viewing Access Entities

Generic Gateway Provider has no access restrictions. It can be viewed and selected by all users.
Payment Gateway RequestsGlobal Viewing Access EntitiesPayment Gateway Requests have no access restrictions. They can be viewed and selected by all users.
Payment Gateway RunsGlobal Viewing Access EntitiesPayment Gateway Runs have no access restrictions. They can be viewed and selected by all users.

 

Payment Gateways Related Modules

EntityInteraction of Payment Gateways with the Entity
WalletsSystem can be set to automatically top-up Wallets when their balance falls below a certain threshold.
Accounts ReceivableThe details required by the Payment Gateway (e.g. Credit Card or Bank account number) are saved on the Payment Preferences of the Accounts Receivable.
BillsBillscan be settled by Payments executed through the Payment Gateway.
StripeStripe is a Payment Gateway with which CRM.COM is integrated. CRM.COM uses the Automatic Payment Run Definitions to update Stripe with the Payments that must be handled.

 

Payment Gateways - Business Examples

The following section provides business examples of how the CRM.COM Payment Gateways module is used.

Handling Payments Online via a Payment Gateway

Panel
nameblue
titleHandling Payments Online via Payment Gateway

Business Requirement

Company ZX has its merchant account registered with Zulu Payment Gateway. Zulu is a Payment Gateway that handles Credit Card payments. Customers that wish to make their payments using Credit Cards must also have a Zulu account. Zulu is updated with the payments made in CRM.COM on an hourly basis and responds to CRM.COM with a success or error message. Payments to be handled by Zulu are the following:

  • Manual Payments (customers call in to make a payment)
  • Automatic Bill Payments (for unsettled Bills)
  • Automatic Wallet Top-Up (when the amount of the Wallet reaches €0, it should be topped up with €20)

 

CRM.COM Solution

  • Configuration
    • Create a Payment Method for Zulu (to be used when creating a new Payment in CRM.COM).
    • Create a Payment Preference for Zulu and set the Identifier field to be the Payment Medium Identifier
      (to be used when registering the customer Accounts Receivable, use the Payment Medium Identifier to save the Credit Card number.)
    • Create a Generic Gateway Provider for Zulu.
    • Create an Accounts Receivable Classification to be used in Wallet Definitions Top-Up Rules.
    • Configure Wallet Definitions "Top Up Rules" to top-up the Wallet with €20 every time its Balance reaches €0 and if its related Accounts Receivable belongs to the specified Accounts Receivable Classification.
    • Configure Automatic Payment Run Definitions to create Payment Requests for unsettled Bills and Wallets that need to be topped-up. The Definition should be scheduled to be executed every 1 hour.
  • User Process
    • Accounts Receivable:
      • When the user registers an Accounts Receivable with Zulu Gateway details, the Zulu Payment Preference must be selected and the Credit Card number of the customer provided as an Identifier
      • The Classification of the account should be set to the one configured in the Wallet Top Up Rules.
    • Payments
      • When a new payment is created, the Zulu Presentment Preference and Payment Method should be selected.
        These Payments will be created with a 'Pending Verification' Life Cycle State. 
    • Technical Staff is responsible for implementing a communication to Zulu (every hour) to inform them of the Payments to beeffected(using CRM.COM WEB APIs to collect pending Payment Requests) and update CRM.COM with the respective responses from Zulu.
Panel
namegrey

Related Areas

Filter by label (Content by label)
showLabelsfalse
spacesV4Manual
showSpacefalse
labelspayment-gateways-basics,payment-gateways-advanced,payment-gateways-admin