Release History
| Version | Date | Changes |
|---|---|---|
| 22.1.0 | 2021-11-08 | Initial release |
| 23.1.0 | 2023-03-22 | Challenge preferences for 3DSV2 |
| 23.2.0 | 2024-02-05 | Paypal and Instanea methods |
Introduction
Axepta BNP Paribas payment platform accept payment orders, process the data and carry out the merchant’s payment transactions in a secure way.
In order to send payment orders to the payment platform Axepta BNP Paribas, the merchant:
● Connects via Internet to the payment platform.
● Sends the required payment data in a defined homogeneous format.
Regardless of the payment method, the same parameters are transmitted so that all payment methods operate in the same way and require no additional effort. Axepta BNP Paribas cartridge enables merchants to manage the different payment methods and their various options (Refund, Payment One click). The cartridge provides several options for adding payment specific details (credit card or debit card information) during the checkout process: through a hosted page that is, external to the Salesforce Commerce Cloud platform or via an iframe on the merchant’s Salesforce Commerce Cloud storefront.
This document fully describes how to install the cartridge and integrate it into the online store. It is required for the merchant to first contact Axepta BNP Paribas and request an account for the integration to work properly. Axepta support provide a testing and production accounts for the merchant.
There are also a configuration to be made in Salesforce Commerce Cloud Business Manager. Axepta BNP Paribas cartridge currently supports the following payment methods:
- Bankcard
- American Express
- FLOA Pay (in progress)
Axepta BNP Paribas cartridge is developed based on en_US locale but it can be configured in any locale needed. The location of payment data storage is very important for the security of the payments online. The card organizations have established a security program with the PCI security authorization (Payment Card Industry) in order to guarantee the secure storage of card data. Also, the cartridge doesn’t perform any request of PCI sensitive information.
This cartridge is available for the 2 versions of SFCC (SFRA or Sitegenesis)
Compatibility
Axepta integration cartridge was certified with the version of Salesforce Commerce Cloud : currently API version 22.10, Site Genesis version 104.1.3 and SFRA version 5.3.0. It is typically backward compatible with older versions since it uses common and stable methods accessing the Customer, Order and Payment system objects.
Currently, SFRA version 6.x and above are not supported.
Technical documentation
To benefit from all the documentation of the SFCC cartridge, we invite you to contact your BNP Paribas account manager.
Component Overview
Functional Overview
Bussiness Manager Extenstion for Axepta
Merchants can configure the Axepta cartridge features from the Salesforce Commerce Cloud BM. On the Business Manager page each merchant can configure the connection to Axepta. The merchant will have to enter the credentials received when opening an account with Axepta in order to create a connection to the platform.
Hosted iFrameMode
The cartridge enables the merchant to use the Axepta payment solutions via an iframe that is integrated into his own Salesforce Commerce Cloud implementation.
Hosted Form Mode
The cartridge supports the hosted payment page approach, where the payment information is entered directly on pages that are hosted and provided by Axepta. During the checkout process, when the customer selects to use one of the payment methods for which the hosted form mode is enabled, he/she will be redirected to the Axepta hosted payment pages in order to complete the order. Once the order is completed, the customer is returned to the merchant’s store, where he/she can review the order summary.
Payment Methods
The cartridge allows the customer to select and use a variety of payment methods in order to complete the checkout process. The available payment methods and afferent configurations are handled via an activation key which Axepta provides, which is configured in Bussiness Manager.
Account configuration
The cartridge supports multiple accounts configuration. Each account can be customized according to the merchant’s needs, by accessing the Axepta Module > Accounts Configuration screen and editing the options.
Manage Orders
The custom order manager screen provided with the Axepta cartridge allows the merchant to perform operations on each individual order, as well as viewing the order information, payment details and notes.
Axepta Signature
A signature verification mechanism is available for verifying the content of requests and redirections between the merchant site and the Axepta platform. Every request it is signed with a string parameter that ensures the request’s origin and integrity, hashed with a SHA256 algorithm.
Supported Operations
The cartridge supports both authorization and payment operations, as well as partial or total refunds. Each operation is triggered according to the payment method selected by the customer during the checkout
process.
Payment
In this case the capture is requested automatically after the authorization. If the capture is not successful, the customer (the buyer) is redirected to an error page. If the capture is successful, the customer is redirected to a success page and completes the checkout process.
Authorization
In this case the customer (the buyer) is not charged automatically or direct after the order is placed. The merchant has a defined amount of time to capture the amount money from the customer. Only total capture is supported by the cartridge. The capture can be triggered in a number of ways :
automatically within a set time period, which can be configured by the merchant in the setting for the Deffered Payment Option
- via a job, which will capture the amount for all orders that have shipping status = “Shipped”
Cancel
It is possible to cancel an order by accessing the Axepta Module > Manage Orders > Order Details screen. An order can only be cancelled if it has not been captured yet. Otherwise, the merchant will be offered to perform a refund.
Refund
The cartridge offers the merchant the possibility to perform partial or total refund for an order, by accessing the Axepta Module > Manage Orders > Order Details screen. This operation enables the merchant to credit funds back to an end-user following a previous debit and it is always linked to a succesfull payment or capture transaction.
Uses Cases
During the checkout, the customer can select to complete the process using one of the available payment methods :
- Bank card (CB, Visa, Mastercard)
- American Express
Each payment method can be customized by the merchant in Bussiness Manager > Axepta Module > Accounts Configuration section. A variety of options can be enabled as well and customized, options that will be taken into account during the checkout process, according to the specifications set by the merchant :
- Standard Payment: this option triggers a payment operation
- Deffered Payment: this option triggers an authorization operation, which needs to be followed by a
- Capture
- Manually for each order, by accessing the order details from the Axepta Module > Manage Orders screen
Two integration modes are in use for the Axepta cartridge in order to process the transactions :
- Hosted form: the shopper is redirected to Axepta’s hosted payment page.
- Hosted form inside an iframe: the Axepta’s hosted payment page is displayed inside an iframe.
After completing the payment, the shopper is returned to the shop's notification URL. This notification URL can be configured and contains the result of the payment (success or fail) . The data received in the notifications is added in the form of notes to the order details.
Both registered and guest customers will follow the standard checkout flow, with the following branching :
- When the shopper selects a payment method for which hosted form mode is enabled, he will no longer enter his credit card details in the payment page of the shop, but will be redirected instead for the Axepta payment page. Once the
customer has confirmed the order, he/she is returned to the merchant’s shop, on the order summary page after a successful transaction or on the order confirmation page if the order was canceled or the payment was refused.
When the shopper is authenticated and selects a credit card payment method, he will have several options presented, and once a selection is made, the normal checkout flow is continued :
- Use a new credit card and save it
- Use a new credit card without saving it
- Use an already saved credit card
- Edit and use an existing card
Sample of testing scenarios :
- All test scenarios involve successful and declined payments
- Test scenarios should be done with every available payment method and option
- The used currency should be EUR or USD
- If for a payment method on a hosted page there is an emulation page, all options (e.g. cancel, exception, decline) should be used as an outcome to test how the system will behave
- When making a payment a Salesforce Commerce Cloud Order object changes its status as follows :
- CREATED - the iFrame page has been shown – the Basket has been cleared – the order may stay/hang in this status if the process did not complete properly (bug) or the user abandons the Iframe or Hosted page and does not complete the payment
- NEW – the Iframe has been closed with an accept – the Order changed it’s status
- OPEN – the Order has been viewed in DW Business Manager after it was in status NEW
- FAILED – all cases of cancel and decline
UC – 1
Summary :
Customer places an order as guest or authenticated, using a payment method with hosted form mode enabled
Preconditions :
- Bank Card or American Express payment methods are enabled in Bussiness Manager > Merchant Tools > Axepta Module > Account Configuration
- Hosted form mode is selected for the enabled payment method
Steps :
1. Customer navigates to the site, selects some products and adds them to cart
2. Customer initiates the checkout flow and fills in the required information in the shipping form
3. Customer fills in the required information in the billing form
4. Customer proceeds to the payment step and selects the payment method and proceed to last step
5. The customer is redirected to the Axepta Payment Page where he/she will add the credit card information and proceeds to placing the order
6. After a succesfull payment, he/she is redirected to the Order Summary page
7. Customer can verify the Order Summary information
8. The merchant can verify the order details, payment information and notifications Bussiness Manager >Merchant Tools > Axepta Module > Manage Orders
9. The merchant can verify the information in the Axepta Extranet platform
UC – 2
Summary :
Customer places an order as guest or authenticated, using a payment method with iframe form mode enabled
Preconditions :
- Bank Card or American Express payment methods are enabled in Bussiness Manager > Merchant Tools > Axepta Module > Account Configuration
- Iframe form mode is selected for the enabled payment method
Steps :
1. Customer navigates to the site, selects some products and adds them to cart
2. Customer initiates the checkout flow and fills in the required information in the shipping form
3. Customer fills in the required information in the billing form
4. Customer proceeds to the payment step and selects the payment method and proceed to last step
5. The iframe with form is displayed where the customer will add the credit card information and proceeds to placing the order
6. After a succesfull payment, he/she is redirected to the Order Summary page
7. Customer can verify the Order Summary information
8. The merchant can verify the order details, payment information and notifications Bussiness Manager > Merchant Tools > Axepta Module > Manage Orders
9. The merchant can verify the information in the Axepta Extranet platform
UC – 3
Summary :
Customer places an order as authenticated user, using Bank Card or American Express payment method with One Click option enabled
Preconditions :
- Bank Card and/or American Express payment methods are enabled in Bussiness Manager > Merchant Tools > Axepta Module > Account Configuration
Steps :
1. Customer navigates to the store and logs in with a pre-existing account
2. Customer selects some products and adds them to cart then initiates the checkout process
3. Customer fills in the required information in the shipping and billing forms
4. Customer proceeds to the payment step and selects the payment method
5. The customer selects in the form one of the presented options: use new card, use pre-saved card or edit and use presaved card
6. Customer proceeds to last checkout step and presses on Place Order button
7. After a succesfull payment, he/she is redirected to the Order Summary page
8. The merchant can verify the order details, payment information and notifications in Bussiness Manager > Merchant Tools > Axepta Module > Manage Orders
9. The merchant can verify the information in the Axepta Extranet platform
UC – 4
Summary :
The merchant performs a manual capture/refund operations on a new order
Preconditions :
- Orders have been placed, with New or Open status
Steps :
1. Merchant Navigates to Bussiness Manager > Merchant Tools > Axepta Module > Manage Orders and opens the order details screen for an existing order
2. The merchant triggers the available operation (capture or refund)
3. A message is presented to the merchant with the status of the operation (success or failure)
4. The merchant can verify the result once the notes have been added to the order
5. The order details are updated
6. The merchant can verify the information in the Axepta Extranet Platform
Limitations, Constraints
- The merchant needs a configured Axepta account
- The following features are out of scope:
- Multi-authorization
- Multi-capture
- Void
- N-times payment
- Direct Link payments
Axepta cartridge is developed based on en_US locale but it can be configured in any locale needed. Also, the cartridge doesn’t perform any request of PCI sensitive information
Compatibility
Axepta integration cartridge was certified with the version of Salesforce Commerce Cloud : currently API version 22.10, Site Genesis version 104.1.3 and SFRA version 5.3.0. It is typically backward compatible with older versions since it uses common and stable methods accessing the Customer, Order and Payment system objects. Currently, SFRA version 6.x and above are not supported.
FLOA PAY : General Information
FLOA Pay allows a merchant to offer 3X, 4X, 1XD or 3XD installment plans for customers during checkout. During the first step FLOA Pay checks the customer for eligibility for chosen installment. Then, in case of positive result, FLOA Pay redirects the customer to FLOA Pay Hosted Payment page. A merchant can be configured on FLOA Pay side for AUTO Capture or for MANUAL Capture. In case of AUTO Capture, FLOA Pay does not expect capture from the merchant. FLOA Pay does capture automatically based on the authorization. In case of MANUAL Capture, the merchant needs to call Capture API. After a credit check, FLOA Pay assumes the entire customer's payment default risk for each transaction. The merchant receives full amount of the installment from FLOA Pay after capture.