About this guide

Changes

Version history.

Version

Change Description

Date

8.6

Updated

  • Union Pay list of accepted currencies

Added

  • SOFORT Note on end-of-life

September 2024

8.5

Updated

  • Giropay refund description

April 2024

8.4

Added

  • iDEAL 2.0 to the list of available APMs

February 2024

Version

Change Description

Date

8.3

Added

  • MyBank to the list of available APMs

August 2023

8.2

Updated

  • SafetyPay country list

May 2023

8.1

Removed

  • IDR as an acceptance currency from UnionPay

  • INICIS

  • MOLPay

  • PostePay

  • ToditoCash Card

  • PbBa

  • Masterpass (moved to Add Mobile and Digital Wallets in developer.worldpay.com)

June 2022

8.0

Removed

  • Paga Wallet topic
  • Page Verve topic
  • Qiwi topic
  • Webmoney topic

April 2021

7.8

Removed

  • Yandex.Money topic

February 2021

7.7

Updated

  • UnionPay - Payment Properties table

October 2020

7.6

Updated

  • Webmoney removed currency RUB

August 2020

7.5

Removed

  • ToditoCash card topic

March 2020

7.4

Updated:

  • Giropay - Information about Giropay's restrictions on use.

February 2020

7.3

Updated:

  • Pay by Bank app - new shopper journey screens and revised text and layout

November 2019

7.2

Removed:

  • Boleto Bancário topic

October 2019

7.1

Updated:

  • Alipay - Information on the popularity of the various payment methods, a note on Alipay's optional two factor authentication challenge
  • Klarna - Removed the Pay Now, KCO (Klarna Checkout) information

July 2019

7.0

New

  • Pay by Bank app

June 2019

6.4

Updated:

  • Boleto Bancário is suspended and is not available to Worldpay merchants

June 2019

6.3

Removed

  • XML order example pages

January 2019
6.2 Updated
  • Multibanco: Increased maximum transaction value from 400 EUR to 2500 EUR
 November 2018
6.1

Updated

  • Alipay topic with a paragraph on the Dynamicdescriptor field
  • Alipay acceptance currencies
  • Alipay Restrictions
  • UnionPay 'Declined' payment scenario Warning
 October 2018

6.0

Updated

  • Worldpay logo and colours in the guide
  • Alipay minimum transaction limits

August 2018
5.9 Updated
  • Yandex.Money - Updated the timeout from 20 minutes to one hour
 August 2018
5.8 Updated
  • Neosurf - Updated supported countries and currencies
  • Giropay - Added PendingURL to XML example and Mandatory Data
 July 2018
5.7 Removed
  • Abaqoos
 July 2018
5.6

Updated

  • Alipay: Payment method properties - Country list expanded beyond China
  • UnionPay: Payment method properties - Acceptance currencies added

Removed

  • Alipay: Payment method properties - Reference to future development of settlement currencies
 July 2018
5.5

Updated

  • Side menu with links to the Overview, Refunding and Testing guides
 June 2018
5.4 Updated:
  • Boleto bank partner screenshots from Santander to Itau
 May 2018
5.3

Updated:

  • Sofort and Pay now. with new screens and an example bank statement
 April 2018
5.2

Updated:

  • Sofort and Pay now. screens
  • MOLPay - THB minimum transaction amount

Removed:

  • In the MOLPay guide - Thailand ATM section
March 2018
5.1 Updated:
  • Union Pay statement narrative to Yes
 January 2018
5.0 Removed:
  • AstroPay Card
  • BankAxess
  • ComGate
  • Hal-Cash
  • Moneta
  • TrustPay
 December 2017
4.2 Added:
  • Trustly
 December 2017
4.1 Added:
  • Switzerland and CHF as a supported country and currency to Sofort
  • Switzerland to the logo type list for Sofort
  • Maximum and minimum amounts for CHF
  • Austria and Switzerland to supported languages

Removed:

  • France from Sofort supported countries
 December 2017
4.0 Removed:
  • Dineromail
  • Ticket Premium
 December 2017
3.3

Updated:

  • UnionPay acceptance currencies added: AED, BND, BHD, GEL, IDR, KZT, LAK, MOP, OMR, NPR, TWD, VND
  • Alipay $8,000 transaction limit for MCC codes: 4111, 4131, 4411, 4511, 4512, 4513, 4722, 5309, 5691, 5944, 7011, 7032, 7512, 8220
 December 2017
3.2

Updated:

  • Alipay guide - new transaction limits
 November 2017
3.1

New:

  • MOLPay guide
 November 2017
3.0

New:

  • BillDesk guide

Removed:

  • eKonto
  • Sporopay
  • TeleIngreso
 October 2017
2.7

Updated:

  • SOFORT Banking is now called SOFORT in Austria and Germany, and Pay now. everywhere else. The Worldpay integration is unaffected.
  • Alipay transaction limits have been changed.

New:

  • Pay now. topic which directs you to the SOFORT and Pay now. topic.
  • The About Alipay topic has a link to a spreadsheet that lists the MCC codes that Alipay is willing to associate with.
 August 2017
2.6

Updated:

  • Neosurf - Added additional countries and acceptance currencies
July 2017
2.5

Removed:

  • CashU - Service suspended

Updated:

  • UnionPay - KO (Korean) and JA (Japanese) added to the supported languages
 July 2017
2.4

Added:

  • Alipay mobile app screens

Updated:

  • Alipay - chargeback information
  • Boleto Bancario - No chargebacks and payments are guaranteed
  • Przelewy24 - Will not accept gambling merchants
  • SafetyPay can apply an exchange rate charge in some circumstances
  • UnionPay refund period is now 365 days with some possible exceptions
 June 2017
2.3 Updated:
  • Klarna APM guide updated from Version 1 to Version 1.1
May 2017
2.2 Updated:
  • Konbini, Poli and MasterPass now in HTML
 May 2017
2.1

Updated:

  • Bancontact is now a standalone guide linked to the APM guide
  • Updated the link to the new MAI Guide in UnionPay
 April 2017
2.0

Added:

  • Klarna APM guide
 April 2017
1.5

Updated:

  • Astropay Card - Worldpay payment page screen
 March 2017
1.4

Added:

  • Giropay

Updated:

  • PostePay screens and shopper journey
 February 2017
1.3 Added:
  • Alipay mobile shopper journey and associated information

Removed:

  • Video gaming restriction for Alipay. Alipay now accept payments for video gaming.
 December 2016
1.2

Updated:

  • SOFORT Banking topic - now available in Spain
 November 2016
1.1

Updated:

  • Boleteo Bancário topic

  • Boleto Bancário: Example XML order topic

  • Yandex.Money: Example XML order topic

October 2016

1.0

Added:

  • Guide created from the old APM Guide

September 2016

Legal

© FIS 2025, and/or its subsidiaries. All rights reserved.

Worldpay (UK) Limited (Company No. 07316500 / FCA No. 530923), Worldpay Limited (Company No. 03424752 / FCA No. 504504), Worldpay AP Limited (Company No: 05593466 / FCA No: 502597). Registered Office: The Walbrook Building, 25 Walbrook, London EC4N 8AF and authorised by the Financial Conduct Authority under the Payment Service Regulations 2017 for the provision of payment services. Worldpay (UK) Limited is authorised and regulated by the Financial Conduct Authority for consumer credit activities. VAT number: 991 2802 07

Worldpay B.V. has its registered office in Amsterdam, the Netherlands (Handelsregister KvK no. 60494344). WPBV holds a licence from and is included in the register kept by De Nederlandsche Bank, which registration can be consulted through www.dnb.nl.

Prettify

We use Google code-prettify to syntax highlight the code examples in this guide.

Copyright 2025 Worldpay

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for specific language governing permissions and limitations under the License.

Contact us

To find out more, get in touch with your corporate support manager or:

Feedback

We'd really appreciate your feedback on this guide. If you have any comments or suggestions, please let us know.

You can email us at: guides@worldpay.com