Skip to content

UnionPay International

Karin Kraus edited this page Mar 21, 2019 · 4 revisions

UnionPay International provides payment solutions used by an increasing number of consumers and online merchants all over the world.

UnionPay International Configuration

  1. Select System/Configuration/Payment Methods.
  2. Click Wirecard UnionPay International to open the UnionPay International configuration page: UnionPay International Configuration

Payment Action

UnionPay International payments can be performed using two different payment actions:

1. Authorization: Payments for orders are not captured/invoiced but only authorized by the consumer, and therefore only reserved. For debit, you have to confirm/capture the amount manually.

  • This payment action triggers the transaction type authorization for payment method UnionPay International.
  • The order created in Magento order management will be labeled as Processing.

2. Purchase: Set payment action to Purchase to capture/invoice payments of orders automatically.

  • This payment action triggers the transaction type purchase for payment method UnionPay International.
  • The order created in Magento order management will be labeled as Processing.

Send Additional Information

If this field is set to Yes, additional data will be sent for the purpose of fraud protection. This additional data includes billing/shipping address, shopping basket, and descriptor.

Note: The additional information includes the descriptor even if the descriptor option is set to No.

Descriptor

The descriptor is the text representing an order on the consumer's bank statement issued by their bank. It provides information for the consumer, as it associates a specific debit on the consumer's account with the respective purchase in your shop.

  • If the descriptor is set to No, the consumer's bank generates a default entry for each purchase.

  • If the descriptor is set to Yes, the default descriptor text consists of up to 9 characters of the shop name and the full order number. The default maximum length is 20.
    To modify the descriptor, use the method getDescriptor in the file lib/WirecardEE/PaymentGateway/Service/PaymentHandler.php.

    • Allowed characters: umlaut, 0-9,a-z,A-Z, , +, ,, -, .
    • Max. length: 27 characters.

Set this feature to Yes to send the descriptor with each request/response.

Supported Post-Processing Operations

Depending on your Payment Action settings, there are different options for the UnionPay International post-processing operation workflow:

Payment Action Authorization

1. Cancel: Triggers transaction type void-authorization. The payment will be canceled/voided, and the corresponding order in Magento order management will be updated to status Canceled.

2. Invoice: Triggers transaction type capture-authorization. The payment will be captured/invoiced, and the corresponding order in Magento order management will be updated to status Processing.

3. Credit Memo: Triggers transaction type refund-capture. The payment/invoice will be refunded, and the corresponding order in Magento order management will be updated to status Closed.

Payment Action Purchase

1. Credit Memo: Triggers transaction type refund-purchase. The payment/invoice will be refunded, and the corresponding order in Magento order management will be updated to status Closed.

You also have the option of partial Credit Memo/Invoice. Partial Credit Memo/Invoice is possible until the payment has been refunded/captured in full.

For a step-by-step guide to canceling, invoicing, and refunding payments, go to our Post-Processing Operations Workflow page.


Please be aware that stock management is not included in the post-processing operations triggered in the Wirecard extension but only in Magento order management.

You can’t perform that action at this time.