Switching to Wirecard Payment Gateway

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).

  • 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 integration examples and documentation on GitHub.

  • Free of charge PHP software library.

  • Updated on a regular basis.

  • Used by mosthttps://doc.wirecard.com/ShopSystems.html[Wirecard Shop Extensions].


Integrate with REST API or Wirecard PHP Payment SDK?

REST API Wirecard PHP Payment SDK

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

image

Wirecard Payment Gateway Workflow

wirecard_payment_processing_gateway_flow.png

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. 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

-

-

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

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

deposit()

deposit

pay()

Initiate a recurring payment

RECURPAYMENT

recurPayment()

recurPayment

pay() with given tokenID from previous successful authorization/payment

Initiate a refund

REFUND

refund()

refund

cancel() or credit()

Reverse a payment approval

APPROVEREVERSAL

approveReversal()

approveReversal

cancel()

Reverse a payment deposit

DEPOSITREVERSAL

depositReversal()

depositReversal

cancel()

Further Information