Menu

User Tools

Create PDF

Site Tools


Differences

This shows you the differences between two versions of the page.

Go

Link to this comparison view

switching_to_wirecard_payment_processing_gateway [2019-02-13 12:53]
switching_to_wirecard_payment_processing_gateway [2019-08-19 11:33] (current)
Line 1: Line 1:
 +====== Switching to Wirecard Payment Gateway ======
 +This general guide provides information on how to switch from Wirecard Checkout Enterprise (legacy stack) to the new Wirecard Payment Gateway stack. \\ It includes descriptions of the components used and compares their different functionalities.
  
 +===== Classification of Components =====
 +
 +^   ^ **Wirecard Checkout Enterprise (legacy)** ^ **Wirecard Payment Gateway (new stack)** ^
 +| **Endpoint** | QTill Server | Wirecard Payment Gateway |
 +| **Interface** | Serial API (SAPI)  \\  Toolkit & Toolkit light | REST API | 
 +| **Libraries** | Java API (JAPI) \\  Toolkit (PHP, ASP, perl) | Wirecard PHP Payment SDK | 
 +
 +
 +----
 +
 +=== JAPI ===
 +  * Java API for Wirecard Checkout Enterprise endpoint (QTill Server).
 +  * Merchant side application to process payment transactions.
 +  * Software library for a straight-forward implementation of payment solutions in Java systems.
 +  * Server requests are bundled to simplify integration.
 +  * Allows front-end and/or back-end operations (initial and follow-up transactions).
 +  * PCI certification needed for processing plain text credit card data.
 +
 +----
 +
 +=== REST API ===
 +  * REST interface for Wirecard Payment Gateway endpoint.
 +  * Merchants have full control over checkout and payment processes.
 +  * Requests are sent via HTTPS protocol.
 +  * Advanced programming skills are required to integrate the REST API.
 +  * PCI certification needed for processing plain text credit card data.
 +  * Allows front-end and/or back-end operations (initial and follow-up transactions).
 +  * [[https://doc.wirecard.com/RestApi.html|Our Online Documentation]] provides examples and documentation.
 +
 +----
 +
 +=== Wirecard PHP Payment SDK ===
 +  * PHP software development kit to integrate Wirecard payment solutions.
 +  * Technical connection between merchant system and Wirecard solutions.
 +  * Simplifies the use of the Wirecard REST API.
 +  * Open-source project with [[https://github.com/wirecard/paymentSDK-php|integration examples and documentation on GitHub]].
 +  * Free of charge PHP software library.
 +  * Updated on a regular basis.
 +  * Used by most[[https://doc.wirecard.com/ShopSystems.html|Wirecard Shop Extensions]].
 +
 +----
 +
 +=== Integrate with REST API or Wirecard PHP Payment SDK? ===
 +
 +^ REST API ^ Wirecard PHP Payment SDK ^
 +|<html><ul><li><font color="black">Highly configurable.</li><li>Can be customized to all systems.</li><li>Independent of programming language.</li><li>Multiple requests are necessary to process a transaction.</li></ul></html> | <html><ul><li><font color="black">Simplifies the use of the REST API.</li><li>Straight-forward integration of payment solutions.</li><li>Only available in PHP.</li><li>Bundles requests into single functions.</li><li>Credit card payments are implemented in Seamless mode for <a href="https://doc.wirecard.com/PP.html#Seamless">Wirecard Payment Page v1</a> or <a href="https://doc.wirecard.com/WPP.html#WPP_Seamless">Wirecard Payment Page v2</a>.</li></ul></html>|
 +
 +----
 +
 +=== Benefits of REST API compared to JAPI/Serial API ===
 +
 +  * State-of-the-art RESTful web service.
 +  * More payment methods available (e.g. ApplePay).
 +  * Extensive documentation (including examples), which is updated constantly.
 +
 +===== Wirecard Checkout Enterprise Workflow =====
 +
 +{{ :wirecard_checkout_enterprise_flow.png?nolink&direct |}}
 +
 +
 +===== Wirecard Payment Gateway Workflow =====
 +
 +{{ :wirecard_payment_processing_gateway_flow.png?nolink&direct }}
 +
 +===== Core Features Overview =====
 +
 +This table gives an **overview** of the main features and functions of each solution and shows the respective counterparts. The functions cannot be seen as equivalents and cannot be used as a copy-paste replacement. However, they show how certain functionalities can be implemented.
 +**[[Detailed Core Feature Comparison|Click here for core feature details]]**.
 +
 +^ Operation  ^ JAPI/Serial API - \\ COMMAND ^ REST API - \\ Transaction Types ^ Toolkit - \\ PHP Functions ^ Toolkit Light \\ WCS/WCP ^ Wirecard PHP Payment SDK - \\ Functions ^ 
 +^ Initiate a payment | INITIATEPAYMENT |<html><ul><li><font color="black">preauthorization</li><li>authorization</li><li> authorization-only </li><li> authorization-supplementary </li><li> final-authorization </li><li> get-url </li><li>debit </li><li> purchase </li><li>check-enrollment</li></ul></html>| - | - |<html><ul><li><font color="black">reserve() </li><li> pay() </li></ul></html>Seamless Payment Page for credit card|
 +^ Verify status of an asynchronous payment | VERIFYPAYMENT \\   \\ **For 3-D Secure payments:** \\ VERIFYPAYMENT + PARES/MD | Retrieve transaction by request-id \\ \\ **For 3-D Secure payments:** \\ check-payer-response | queryOrders() with orderNumber as primary key | [[back-end_operations:transaction-based:getorderdetails|getOrderDetails]] | Notification received from server-to-server request |
 +^ Query status of multiple orders | QUERYORDERS | **merchant side implementation** | queryOrders() | - | **merchant side implementation** |
 +^ Query status of refunds | QUERYCREDITS | **merchant side implementation** | queryCredits() | - | **merchant side implementation** |
 +^ Query status of Day-End-Closing | QUERYBATCHES | **no longer needed** | queryBatches() | - | **no longer needed** |
 +^ Settle a payment | DEPOSIT |<html><ul><li><font color="black">capture-authorization </li><li> capture-preauthorization </li><li> capture-final-auth</li></ul></html>| deposit() | [[back-end_operations:transaction-based:deposit|deposit]] | pay() |
 +^ Initiate a recurring payment | RECURPAYMENT |<html><ul><li><font color="black">debit </li><li> authorization </li><li> referenced-authorization </li><li> referenced-purchase</li></ul></html>| recurPayment() | [[back-end_operations:transaction-based:recurpayment|recurPayment]] | pay() with given tokenID from previous successful authorization/payment |
 +^ Initiate a refund | REFUND |<html><ul><li><font color="black">refund-capture </li><li> refund-purchase </li><li> refund-debit </li><li> refund-request </li><li> first-cb </li><li> second-cb</li></ul></html>| refund() | [[back-end_operations:transaction-based:refund|refund]] | cancel() or credit() |
 +^ Reverse a payment approval | APPROVEREVERSAL |<html><ul><li><font color="black">void-authorization </li><li> void-preauthorization </li><li> void-final-authorization </li><li> reversal-authorization </li><li> void-debit </li><li>void-auth-supplementary</li></ul></html>| approveReversal() | [[back-end_operations:transaction-based:approvereversal|approveReversal]] | cancel() |
 +^ Reverse a payment deposit | DEPOSITREVERSAL |<html><ul><li><font color="black">void-capture </li><li> void-debit </li><li> void-purchase </li><li>reversal-purchase </li><li> void-capture-final-auth </li><li> void-capture-preauthorization</li></ul></html>| depositReversal() | [[back-end_operations:transaction-based:depositreversal|depositReversal]] | cancel() |
 +
 +===== Further Information =====
 +  * [[Detailed Core Feature Comparison|Detailed Core Feature Comparison]].
 +  * [[Code examples for Toolkit PHP, Wirecard PHP Payment SDK and JAPI|Code examples for Toolkit PHP, JAPI and Wirecard PHP Payment SDK]].
 +  * [[Request Comparison JAPI/SAPI vs. REST API]].
 +  * [[Information for switching merchants|Information for Switching Merchants.]]
 +  * [[Token Migration Tool|Token Migration Tool.]]

This website uses cookies to deliver the best service to you. By continuing to browse the site, you are agreeing to our use of cookies.