WL SIPS DOCS

Release 22.5

go directly to content

Search by keywords

China UnionPay integration

To search in the page use Ctrl+F on your keyboard

WL Sips is a secure multi-channel e-commerce payment solution that complies with the PCI DSS standard. It allows you to accept and manage payment transactions by taking into account business rules related to your activity (payment upon shipping, deferred payment, recurring payment, payment in instalments, etc.).

The purpose of this document is to explain the CUP payment mean integration into WL Sips.

This document is intended to help you implement the CUP payment mean on your e-commerce site.

It includes:

  • functional information for you
  • implementation instructions for your technical team

To get an overview of the WL Sips solution, we advise you to consult the following documents:

  • Functional presentation
  • Functionality set-up guide

The CUP (China UnionPay) card is a means of payment by card hold by more than 150 millions customers across the world (figures in 2018 ), mainly in Asia, allowing you to increase the visibility and attract new international customers.

To pay with a CUP network card, cardholders have to provide their card details, namely:

  • the card number;
  • the expiry date;
  • the visual security code (or security code, referred to as CVV).
Payment channels
Internet V Default payment channel
MOTO X
Fax X
IVS X
Means of payment
Immediate payment V
End-of-day payment X
Deferred payment X
Payment upon shipping X
Payment in instalments X
Subscription payment X
Batch payment X
OneClick payment X
Currency management
Multicurrency acceptance X EUR only
Currency settlement X EUR only

The customer selects the CUP means of payment.

They are then redirected to the required information entry page:



The payment ticket is displayed, then the customer returns to your website.

In order to offer the CUP means of payment on your website, you have to sign an acceptance contract with Worldline Sweden. Thereafter, you transmit us the contract number for recording in our information system.

You can offer the CUP means of payment through the Sips Paypage interface which directly acts as the payment interface with customers via their web browser.

The only remittance mode available for a CUP transaction is the immediate mode (the transaction remittance is executed at the time of the online payment acceptance).

The diagram below explains the different transaction statuses according to the chosen capture mode:


Description of the possible statuses for a CUP transaction

In immediate mode (captureMode = IMMEDIATE), if the transaction is accepted (responseCode equal to 00), it is set to status CAPTURED. If the transaction is refused (responseCode not equal to 00), it is set to status REFUSED. And if the transaction is aborted (responseCode equal to 17), it is set to status ABORTED.

The payment process for Sips Paypage is described below:


Steps of a CUP payment via Paypage

1) The customer proceeds with the payment. 2) They are redirected to the means of payment selection page hosted by WL Sips, they select CUP and enter their card number. 3) They are redirected to the CUP page where they authenticate themselves. 4) They are redirected to a WL Sips page. 5) If they click on the back to eshop button, they are redirected to your website which triggers the manual response to be sent. 6) WL Sips sends an automatic response.

The following fields have a particular behaviour:

Field name Remarks/rules
captureMode Tհe value sent in the request is ignored.
The capture mode is forced to IMMEDIATE.
captureDay Tհe value sent in the request is ignored.
The capture delay is forced to 0.
customerLanguage Allows to choose the language used on WL Sips and CUP pages.
paymentPattern The value sent in the request isignored.
The payment type is forced at ONE_SHOT
statementReference The value sent will appear on your account statement. The allowed characters are [a-zA-Z0-9 /\+=.].

The following table summarises the different response cases to be handled:

Status Response fields Action to take
Payment accepted acquirerResponseCode = 00
authorisationId = (cf. the Data Dictionary).
You can deliver the order.
Pending transaction acquirerResponseCode = (cf. the Data Dictionary). You must wait until you receive the second automatic response for this transaction to know its final status and whether you can ship the goods. If you do not receive the automatic response, you will need to check the transactions report regularly.
Acquirer refusal acquirerResponseCode = (cf. the Data Dictionary). The authorisation is refused for a reason unrelated to fraud.
If you have not opted for the "new payment attempt" option (please read the Functionality set-up Guide for more details), you can suggest that your customer pay with another means of payment by generating a new request.
Refusal due to the number of attempts reached responseCode = 75 The customer has made several attempts that have all failed.
Refusal due to a technical issue acquirerResponseCode = 90-98
responseCode = 90, 99
Temporary technical issue when processing the transaction. Suggest that your customer redo a payment later.

For the complete response codes (responseCode) and acquirer response codes (acquirerResponseCode), please refer to the Data dictionary.

The CUP means of payment acceptance is not available through the Sips Office solution.

The following operations are available on CUP transactions:

Cash management
Cancellation X
Validation X
Refund V
Duplication X
Credit X

The diagram below explains which cash management operation is available when a transaction is in a given state:


Cash management operations availability

In case of acceptance, the status is set to CAPTURED. When the status is CAPTURED, a total or partial refund can be made. In the case of partial refund the status remains CAPTURED and in the case of total refund the status becomes CREDITED.

The reports provided by WL Sips allow you to have a comprehensive and consolidated view of your transactions, cash operations, accounts and chargebacks. You can use this information to improve your information system.

The availability of CUP transactions for each type of report is summarised in the table below:

Reports availability
Transactions report V
Operations report V
Reconciliations report V
Chargebacks report X
Note: for CUP transactions, the paymentMeanBrand field is populated with the value CUP.

You can view your CUP transactions and perform various cash management operations with Sips Office Extranet.



This site uses trackers to improve your experience, perform analysis and researches on your use of WL Sips documentation website.
You have several options:
Closing this banner you refuse the use of trackers on your device.

Configuration