Introduction
The Intershop reference payment services are provided in three different cartridges (+ source code) within the Intershop7 system. The standard payment services are stored in ac_payment_std, gift payment services in ac_giftcard_std and demo payment services in ac_payment_demo.
The question is, why does Intershop deliver reference payment services?
We want to address different purposes. The Intershop standard payment services and gift card service can be used - out of the box - in a real customer production environment. Whereas the Intershop demo payment services show one way, how to develop a payment service connector for an Intershop 7 system and can be used as a blueprint. We are using these payment services in our demo environment inSPIRED to the test the checkout and payment business use cases we want to address to the customer. To demonstrate the whole Intershop 7 feature set we need of course the Intershop reference payment services too.
What is the benefit for the customer?
- Use the Intershop standard payment services and gift card service out of the box
- Use the Intershop demo payment service as a blueprint to develop your own payment service (connector)
- Use the Intershop reference payment services to consider the possible payment and checkout business use cases in the Intershop 7 application
- Use the Intershop reference payment services to test payment and checkout business use cases in the Intershop 7 in an early state of the development or project.
Errors and defects will be minimized, development effort as well as the test effort will be reduced - minimizing the project risk.
Download Class Hierarchy Diagrams
Since some of the class hierarchy diagrams are quite large and tricky to be displayed in the document this document also provides a download zip-folder containing all the diagrams as *.png files.
References
Standard Payment Services
Invoice, Cash on Delivery, Cash in Advance, Direct Debit are available out of the box in Inershop 7 as standard payment services. Their name best describes the usage. In our demo shop inSPIRED the services are enabled, configured and ready for usage. In a new sales organization you have to:
- Enable the payment services in the Operations application.
- Create managed services before you can add the standard payment services to a channel.
When all configurations are done the customer can select the payment method during checkout on payment page without adding additional data.
Only when using direct debit the user has to fill in the name of the account holder and the international bank account number. Optionally the bank identifier code can be filled in.
After selection of such a method the user jumps to the review page in checkout and can submit the order.
Cartridge | Payment Method | Description |
|---|---|---|
ac_payment_std | INVOICE CASH ON DELIVERY CASH IN ADVANCE DIRECT DEBIT TOTAL ZERO | All payment methods provide implementation classes, required configuration as well as the initilization for inSPIRED. They are ready to use. |
Features
| ID | Name | Supported Capabilities | PropertyGroups |
|---|---|---|---|
| ISH_INVOICE | Invoice | OfflinePayment | - |
| ISH_CASH_IN_ADVANCE | Cash in Advance | OfflinePayment | - |
| ISH_CASH_ON_DELIVERY | Cash on Delivery | OfflinePayment | - |
| ISH_DEBIT_TRANSFER | Direct Debit | OfflinePayment, Validate | BankingInformationSEPA |
| ISH_INVOICE_TOTAL_ZERO | Zero Payment | OfflinePayment | - |
Workflow
Class Hierarchy
ac_payment_std
Gift Payment Services
Gift cards are stored as physical gift certificates and as digital goods in Intershop 7. After the purchase the buyer get a number and PIN (only for gift cards) of the chosen gift product.
If you want to use gift cards and gift certificates as limited tender you have to fill in those numbers on the payment page. Depending on total amount you have to chose another payment method to cover the full total amount. A multiple tender is possible in Intershop 7.
Cartridge | Payment Method | Description |
|---|---|---|
ac_giftcard_std | GIFT CARD GIFT CERTIFICATE |
Features
| ID | Name | Supported Capabilities | PropertyGroups |
|---|---|---|---|
| ISH_GIFT_CARD | Gift Card / Certificate | Authorize, LimitedTender, Validate, Refund | GiftCardInformation |
Workflow
See standard payment service workflow.
Class Hierarchy
ac_giftcard_std
Demo Payment Services
Cartridge | Payment Method | Description |
|---|---|---|
ac_payment_demo | CREDITCARD FASTPAY ONLINEPAY |
Features
| ID | Name | Supported Capabilities | PropertyGroups |
|---|---|---|---|
ISH_ONLINEPAY | ISH Online Pay | RedirectAfterCheckout, Refund | - |
ISH_CREDITCARD | ISH Demo Credit Card | RedirectBeforeCheckout, Validate, Authorize, Cancel, Capture, Refund | CreditCardInformation |
| ISH_FASTPAY | ISH Fast Pay | FastCheckout, Authorize, Refund | - |
Class Hierarchy
Credit Card
Online Pay
Fast Pay
Note
This feature uses the Standard-Payment API 2.0. Intershop Commerce Suite patch 7.6.1 or later required!
Type: "For Authorization": ISH Online Pay
It simulates a payment service like sofortüberweisung or giropay. ISH Online Pay is a payment service that aggregates the payment information of the customer to trigger a bank transfer from the customer's bank account to the shop's bank account.
Note
If you use an active approval service, ISH Online Pay is not available in checkout in inTRONICS Business. This is because the redirect would be executed after the order creation which needs an approval.
Workflow
Type: "Before Checkout": ISH Credit Card
It simulates a payment service with credit card methods. ISH Credit Card is a payment service that transfers the credit card data to an external payment service provider (ISH Pay) at the payment selection step. There, the shopping system gets a token for that transaction. If the test customers are placing the order, they must enter the Card Security Code, and the token is transferred back to the payment service provider. In case of success, the token and the payment transaction is assigned to the credit card data of the customer at the payment service provider ISH Pay.
Workflow
Configuration - Additional Settings
- Use Automatic Capture
- Capture Time (duration in min until the order is captured)
- Enable Address Data Transfer
- Gateway [StandardPaymentGateway|ExtendedPaymentGateway]
- CC Verification using 3-D Secure
Credit Card - Demo Data
Demo data for testing and demo
Intershop provides the following credit card demo data alongside with the product for demo and testing purposes.
Note
Please have in mind, a redirect for credit cardsonly occurs by using credit card numbers 4111-1111-1111-1111 and 5555-5555-5555-4444.
Type: "Fast Checkout": ISH Fast Pay
Note
This feature uses the Standard-Payment API 2.0. Intershop Commerce Suite patch 7.6.1 or later required!
It simulates a payment service like PayPal Express. It starts at the shopping cart where the user is redirected to the ISH Fast Pay service. There, the user prepares the whole checkout. If this was successful, the user is redirected back to the shop system. Here the the order must be confirmed.
Workflow
Configuration - Additional Settings
- Use Automatic Capture
- Capture Time (duration in min until the order is captured)
- Enable Address Data Transfer