Versioning and Change log

We have created a migration guide which consolidates the changes for an easier upgrade from version 6 to version 7.

• header change to "Content-Type: application/vnd.worldpay.payments-v6+json"
• new mandatory field intent for all recurring resources
• removed code and type from error messages

• header change to "Content-Type: application/vnd.worldpay.payments-v5+json"
• new mandatory field type
• new mandatory field version
• xid to transactionId

• Header change to "Content-Type: application/vnd.worldpay.payments-v0.4+json"
• New mandatory field entityReference

You can now submit additional L2/L3 and airline data in your authorization or settlement request. Supplying this information means you may benefit from reduced cost and more efficient processing.

You can now submit preferredCardBrand in your authorization request to honor your customer's card brand choice for co-badged cards.

You can now submit the following additional values for customerAgreement.type in your MIT request:

• reauthorization - use this where the original authorization has expired before funds could be sent for settlement
• resubmission - use this where the original authorization was declined due to insufficient funds, but the customer has already received goods or services
• noShow - use this to charge a customer who fails to attend a previously-made reservation (in line with a pre-agreed cancellation policy) e.g. a guaranteed reservation is made at a restaurant but the customer does not turn up
• delayedCharge - use this to charge a customer for additional items after you have processed an original CIT payment (in line with previously agreed terms), e.g. charges for hotel mini-bar usage after the customer has checked-out and the original payment has been sent for settlement

You can now request real-time account updates (Visa cards only) when using a previously stored card using instruction.requestAccountUpdater. If the supplied card has been updated, we will return updated card details in the updatedPaymentInstrument object in the authorization response.

You can now submit the fundingType and salesTax field in payment requests for Latin America.

We have now added support for Merchant Initiated Transactions (MIT) to Card Payments Version 7.

You can now submit funds transfers (otherwise known as Account Funding Transactions or AFTs) using the instruction.fundsTransfer object in your authorization request. Non-purchase money movements from a Visa or Mastercard to another account should typically use this.

You can now submit Latin America installment payments using the instruction.customerAgreement object in your authorization request. This allows your customers to opt to pay the full value in installments.

You can now submit the customer.documentReference in your authorization request. This is used in some Latin America regions to verify the identity of the cardholder using a tax or document reference. It is strongly recommended to include this for Brazil domestic processing.

You can now submit the recipient object in your authorization request. If you are using MCC 6012 in Europe, you should include data about the recipient of financial services within this object.

You can now submit a consumerBillPayment flag in your authorization request. If you are registered with Visa as a Consumer of the Bill Payment Service (CBPS), you must set this to true for any payments associated with the CBPS.

We now provide additional values in the authentication and 3DS verification responses when the card brand is Cartes Bancaires. These additional values must then be applied in the authorization request.

You can now receive a rawCode in all refusal responses. See raw response codes for more information.

You now receive a paymentInstrument object in authorized responses to your authorization request, and Sent for Settlement responses to your sale request for card/plain, card/token, and card/checkout.

You can now use our card/networkToken paymentInstrument with our one time authorization and migrateCardOnFileAuthorize endpoints.

You can now use our card/networkToken+applepay paymentInstrument with our one time authorization endpoint.

You can now submit a new intent value of subscription in your card on file request.

The response of a partial refund request returns a link to allow you to perform another partial refund. The json path to the link in the response is $._links.payments:partialRefund.href.

We have added a new set of Mastercard refusalAdvice magic values. This enables to you to test the different refusal outcomes in your Payment response.

You can now supply payment facilitator subMerchant email and telephone number in your authorization request.

The payment facilitator state field in the authorization request now supports 1-3 alphanumeric characters.

MOTO payments (v6) (29 November 2022)

riskProfile in card on file (with verification) payment requests (v6) (04 July 2022)

Card network token for card on file sale endpoint (v6) (09 November 2021)

Optional scheme reference parameter for token requests (v6) (10 September 2021)

Additional exemption result for card on file payments (v6) (18 June 2021)

Additional exemption result for one off payments(v6) (25 May 2021)

Additional risk factor result (v6) (09 April 2021)

Cardholder name is now an optional field (v6) (09 March 2021)

riskProfile in payment requests (v6) (21 January 2021)

Apple Pay decrypted for recurring (v6) (27 November 2020)

Apple Pay decrypted for card on file (v6) (17 November 2020)

Additional element for Mobile Wallet requests (v6) (06 October 2020)

Additional element for Mobile Wallet responses (v6) (22 September 2020)

New optional request parameter for repeat payments (v6) (28 May 2020)

New action link in partialSettle response (v6) (20 May 2020)

Additional allowed character for transactionReference (v6) (05 May 2020)

New paymentInstrument for card on file payments (v5 + v6) (24 April 2020)

Additional fields in wallet response (v6) (16 April 2020)

Additional action link (v6) (03 March 2020)

New optional field (v6) (11 February 2020)

Additional fields in response (v6) (04 February 2020)

• We are returning riskFactors in our refused responses

• You can now submit cvc for requests using tokens

• debtRepayment indicator which flags payments with purpose of repaying debt

Additional action links (v6) (21 November 2019)

Extended error description for card expiry (v5) (13 November 2019)

Formatting update for transactionReference (v5) (15 October 2019)