Stripe

Stripe

InfoModule: Payment Processing Account
Topic: Stripe Payment Processing Account Token Generation
Version(s): Version 5.1
Editions: All Editions


What Is Stripe

Stripe is a payment gateway that processes the various credit cards and tokenization.

What Is Tokenization

Tokenization replaces sensitive data with non-sensitive data and is used to safeguard a card's PAN (primary account number) by replacing it with a unique string of numbers. This secure token, can then also be stored in the customer's payment profiles on the customer's detail center for future billing use.


Making The Connection

Where Will I See This Within OLX?

What Reports Can Be Pulled?

  1. Payment Batch Report Definitions (orderlogix.com)

What Imports/Exports Relate to Stripe

Currently there are no import nor exports for creating or editing PPA's


Trouble Shooting

  1. Agent receives error during order entry - Object variable or With block variable not set.
    1. check settings on gateway for Card Verification before storing the card in the vault.
  2. A token can only be used in the account is created in.
    1. A payment profile that has been tokenized will fail payment processing if attempting to process payment in any other payment account

Setup

The Payment Processing Account Token Generation feature is optional, and turned off by default so it would need to be enabled by a programmer as there isn't an option to "turn it on" by a user in the GUI. This feature allows tokenization of payment methods within OrderLogix, in order to securely process payments for the customer. 

There are multiple places within OrderLogix to take into consideration when it comes to generating and managing tokens, so the first place would be to set up the payment processing account that the tokens will be created through. This article will show you how to set up and manage this feature for the Stripe payment gateway.

Payment Processing Account Set up:

Navigate to Company Data>Payment Data>Payment processing accounts and click the  edit pencil icon next to the one you are modifying or the  add new button to create a brand new account:



The labels for each field under the selected payment processor are specific to values needed to be passed to the gateway for a token to be generated and will vary depending on what processor you are integrating with. 

The payment processing account settings for Stripe contain values that allow the user to determine

The field labeled "Store Stripe Fee(1/0)" has acceptable values of "Yes", "1", "true" for active, and "No","0","false" for inactive.

Once you enter all of the required fields for the account and ensure that the "Allow Tokenization" checkbox is selected you can save the settings and then move onto associating to desired script(s).


Where to Find Values in Stripe

  1. Login to your Stripe Gateway account. 
  2. Click on Developers, top right menu
  3. Tokenization Key
    1. Developers > API Keys > Standard Keys > Publishable key
  4. Store Stripe Fee (0|1
    1.  > 
  5. Fee Custom Field (1|2|3|4|5)
    1. Settings > ? > ? > ?
  6. API Key (Confirm Password)
    1. Developers > API Keys > Standard Keys > Secret key


Maintaining Scripts:

Once you are ready to test, or activate the payment processing account to generate tokens via the order entry screen you can navigate to Company Data>Advertising>Maintain Scripts and click on the "Payment" tab:

You will notice when you allow real time auth for pre-authorizations, not only does the standard "payment processing account" display but now there is also a "payment processing account" for tokenization and these MUST be the same. If you have 2 different accounts selected, you will see the following message appear:


Once you have the Stripe account selected for the desired script(s) then tokens can be created from the order entry screen when manual orders are submitted.



Order Entry:

When users access the order entry screen after the previous steps have been taken, the payment method entry is going to be considerably different. All of the customer's billing and shipping information would be entered with no change, however once you select the method of payment from the drop-down menu you will see a new button that says  "Set Payment." You will only see this option when tokenization is activated for a script:



Once the "set payment" button is selected, the following payment information window will pop up:



All of the fields that are displayed in the pop up are required and must be filled out before the "save button" can be selected. Once you save the payment information screen, a token will be pending for the customer's information and then generated once the order has been pre-authed or submitted if pre-auth isn't enabled on the script:




If the customer wishes to change their method of payment, before the pre-auth or submission is conducted you can simply click back on the "set payment" button in order to wipe the slate clean and enter new information. Keep in mind that when accessing the payment information a second time on the order screen, you will not see what the previous information was only a blank screen for you to enter new information.

If the script enables pre-authorizations, the token will be returned and displayed under the Payment Method selection before submitting it:



The customer and payment values are generated at the payment processor level, and displayed in OLX within the token value which also contains the last 4 numbers of the CC. Now we will take a look at how this information is displayed on the customer's order screen, when it's not broken out and how customer service will manage tokens within payment profiles.



Order Detail Screen:

Orders with tokens instead of their primary account number will be easily identified under the payment information on the detail screen:



If a change needs to be made to the payment information, and the item(s) on the order are in eligible status(es) then you can click into the  edit pencil icon in order to modify the payment data. The Payment Information window will pop up, displaying the current token details:



If a new token for the order needs to be generated then you will click the  "generate new token" icon located beside the current token, which will then launch the same payment information screen that we saw on the order entry screen. This allows you to enter brand new information in order to create a new token for the order, and will show pending until the response comes back from the processor:




You will then see that the "token details" located at the bottom of the payment information window will be updated as well:




Customer Detail Screen:

Customers that have tokens applied to orders will have this information securely stored on their detail center in the payment profile section, for use on future continuity and or one-time orders. Once viewing the payment profile tab, you will see all profiles stored for a given customer and a "dummy" credit card number will be applied to the "credit card number" field in the profile based on the details stored in the system preferences section. This is necessary due to the CC details being required on order, however if a token is present that will trump the card number. The token will be visible to the right-hand side of the payment profile details:


If the profile needs to be modified, click the edit pencil icon and the "edit payment profile" window will appear as seen below:



Generating a new token for the profile will work the same way as shown in the order detail section of this article.


Importing orders with tokens:

A Token generated via different payment gateways can be used for continuity or one time billing and imported via either the OrderLogix API or Order Import v4. To accompany the Token, the following must also be sent:
  1. MERCHANT_TRANSACTION_ID
  2. PAYMENT_METHOD = CC.
  3. CC_TYPE
    1. V=Visa, MC=MasterCard, D=Discover, A = American Express
  4. EXP_DATE
  5. TOKEN
  6. PAY_PROC_ACCT

Example:
<MERCHANT_TRANSACTION_ID>123456</MERCHANT_TRANSACTION_ID>
<PAYMENT_METHOD>CC</PAYMENT_METHOD>
<CC_TYPE>V</CC_TYPE>
<EXP_DATE>09/29</EXP_DATE>
<CVV_CODE>123</CVV_CODE>
<TOKEN>cus_RFrEAG8zzKQLSK,card_1QNLWFEwtCrW11FGpb3JYedX,1111</TOKEN>
<PAY_PROC_ACCT>OLT TEST ACCOUNT</PAY_PROC_ACCT>


Payment Gateways will have different formats of information that needs to be passed in the token field, please see integrated list formats below:

Stripe Gateway       

Customer/Payment,/CCLast 4.  customer = StripeCustomerId, Payment = StripeCardId,



Stripe - Payment Processing Account Token Generation
Copyright 2024

Revised 11.20.2024
    • Related Articles

    • Account Updater

      Module: Payment Prod Accounts Path: Campaigns > Payment Prod Accounts Topic: Account Updater Version(s): 5.1 & up Editions: All Account Updater Account Updater is a paid feature most payment gateways offer. You will have to reach out to your payment ...
    • Mercado Pago Payment Processor

      Module: Payment Processor Topic: Mercado Pago Payment Processor Version(s): All Editions: All What is Mercado Pago Mercado Pago is a payment gateway. Mercado Pago is more complex than some of the other payment gateways you may have used in the past ...