Apple Pay Withdrawal (checkout)

ApplePay is a secure, easy way to make payments for physical goods and services within iOS and watchOS. Websites can also accept ApplePay – it is available in Safari for iPhone, iPad, and Mac. Users authorize payments and provide shipping and contact information, using securely stored credentials on an iPhone, an iPad, or a MacBook Pro with Touch ID. On other Macs, the purchase is confirmed with the user's nearby iPhone or Apple Watch that has ApplePay enabled.

The following method ID`s are covered in this section:

IDNameDebit State
463Apple Visa WithdrawalWithdrawnByProvider
464Apple ECMC WithdrawalWithdrawnByProvider

Payment method interaction type: Synchronous Execution (see Interaction Types)

📘

Availability

Apple Withdrawal is currently available only for provider (acquirer) Vantiv (Worldpay).

Redirect Integration

ApplePay withdrawal is available in the PXP checkout.

In the checkout any existing ApplePay accounts will be listed for initiating a withdrawal request.

📘

PaymentMethodGroupID

When including the PaymentMethodGroupID 10003 in the request below, only the detail page (grouped page) for Apple card withdrawal will be be displayed.

When excluding the PaymentMethodGroupID in the request below, the selection page will be shown, listing the Apple logo for Apple withdrawals.

<getRedirectDataRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
                        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                        xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<merchantID>{{merchant}}</merchantID>
	<redirectParameters xsi:type="paymentMethodSelectionWithDetailsRedirectParameters">
		<shopID>{{shop}}</shopID>
		<httpMethod>GET</httpMethod>
		<returnUrl>https://www.google.at</returnUrl>
		<languageCode>en</languageCode>
		<currencyCode>EUR</currencyCode>
		<countryCode>AT</countryCode>
		<additionalDetails>
			<!-- <detail xsi:type="keyStringValuePair">
                <key>PaymentMethodSelectionProfile</key>
                <value>Sale</value>
            </detail>             -->
			<detail xsi:type="keyStringValuePair">
				<key>description</key>
				<value>Test description</value>
			</detail>
			<!--<detail xsi:type="keyStringValuePair">
				<key>PaymentMethodGroupID</key>
				<value>10003</value>
			</detail>-->
		</additionalDetails>
		<user>
			<id>CreateAppleWithdrawalBDD</id>
		</user>
		<merchantTransactionID>{{checkoutMerchantTransactionID}}</merchantTransactionID>
		<grossAmount>1</grossAmount>
		<successUrl>https://www.dropbox.com/s/o1a7hdrsls25fd0/Success.png?dl=0</successUrl>
		<pendingUrl>https://www.dropbox.com/s/eius69rznlr2jow/Pending.png?dl=0</pendingUrl>
		<errorUrl>https://www.dropbox.com/s/x72sbaohk9p9f59/ErrorPage.png?dl=0</errorUrl>
		<cancelUrl>https://www.dropbox.com/s/i3x47m6v8k54sut/CancelPageUrl.png?dl=0</cancelUrl>
		<refusedUrl>https://www.dropbox.com/s/jek5e39jxoaekj8/Refused.png?dl=0</refusedUrl>
		<paymentDirection>Withdrawal</paymentDirection>
	</redirectParameters>
</getRedirectDataRequest>

Appearance in the Checkout

Selection page with several payment methods including Apple withdrawal:

Detail page with Apple withdrawal:


Notifications

The following notifications can be sent:

Sample handlePaymentStateChangedNotificationRequest for state Created:

<?xml version="1.0" encoding="utf-16"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsd=http://www.w3.org/2001/XMLSchema
                                              xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance>
<payment
         xmlns=http://www.cqrpayments.com/PaymentProcessing
         xsi:type="paymentWithPaymentAccount">
	<merchantID>{{merchant}}</merchantID>
    <shopID>{{shop}}</shopID>
	<paymentMethod>
		<key>463</key>
		<value>Apple Visa Withdrawal</value>
	</paymentMethod>
	<merchantTransactionID>619e5756-b150-4975-b67a-cc50c59d2a3f</merchantTransactionID>
	<paymentID>d90395b4-18c0-4fd4-b562-c8707a1124e8</paymentID>
	<userID>VantivAppleCardWithdrawalAT</userID>
	<paymentProvider>
		<key>124</key>
		<value>Vantiv</value>
	</paymentProvider>
	<amount currencyCode="EUR">10.1000</amount>
	<creationType>
		<key>1</key>
		<value>User</value>
	</creationType>
	<userIP>127.0.0.1</userIP>
	<state>
		<id>c5cf10c0-964b-46f4-bab8-5a27cf4cc4ec</id>
		<definition>
			<key>232</key>
			<value>Created</value>
		</definition>
		<createdOn>2024-12-02T13:43:30.273</createdOn>
		<paymentStateDetails xsi:nil="true"/>
	</state>
	<isExecuted>true</isExecuted>
	<baseAmount currencyCode="EUR">10.1000</baseAmount>
	<paymentDetails>
		<detail xsi:type="keyStringValuePair">
			<key>ProviderExternalID</key>
			<value>1284109</value>
		</detail>
		<detail xsi:type="keyIntValuePair">
			<key>MerchantSettlementCurrencyID</key>
			<value>2</value>
		</detail>
		<detail xsi:type="keyStringValuePair">
			<key>ProviderTransactionID</key>
			<value>0561284937</value>
		</detail>
		<detail xsi:type="keyStringValuePair">
			<key>ApprovalCode</key>
			<value>764577</value>
		</detail>
	</paymentDetails>
	<paymentAccount>
		<paymentAccountID>f3fda16b-45d0-4eac-8118-12f4f761eeee</paymentAccountID>
	</paymentAccount>
</payment>
</handlePaymentStateChangedNotificationRequest>

Sample handlePaymentStateChangedNotificationRequest for state WithdrawnByProvider:

<handlePaymentStateChangedNotificationRequest xmlns:xsd=http://www.w3.org/2001/XMLSchema
                                              xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
                                              xmlns=http://www.cqrpayments.com/PaymentProcessing>
<payment
         xsi:type="paymentWithPaymentAccount">
	<merchantID>{{merchant}}</merchantID>
    <shopID>{{shop}}</shopID>
	<paymentMethod>
		<key>462</key>
		<value>Apple ECMC Withdrawal</value>
	</paymentMethod>
	<merchantTransactionID>de0a0616-3f94-4268-8cb8-740d91e88757</merchantTransactionID>
	<paymentID>408ea62b-7379-40c6-a554-26fb4f17ffda</paymentID>
	<userID>VantivAppleCardWithdrawalGB</userID>
	<paymentProvider>
		<key>124</key>
		<value>Vantiv</value>
	</paymentProvider>
	<amount currencyCode="GBP">100.0100</amount>
	<creationType>
		<key>3</key>
		<value>Api</value>
	</creationType>
	<userIP>127.0.0.1</userIP>
	<state>
		<id>812cddc1-966e-4a19-877c-74f415c0ffda</id>
		<definition>
			<key>20</key>
			<value>WithdrawnByProvider</value>
		</definition>
		<createdOn>2024-12-02T13:22:50.61</createdOn>
		<paymentStateDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderResponseCode</key>
				<value>00</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderResponseMessage</key>
				<value>APPROVAL</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ApprovalCode</key>
				<value>837468</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>AVSResponse</key>
				<value>Z</value>
			</detail>
		</paymentStateDetails>
	</state>
	<isExecuted>true</isExecuted>
	<baseAmount currencyCode="EUR">115.7000</baseAmount>
	<paymentDetails>
		<detail xsi:type="keyStringValuePair">
			<key>ProviderExternalID</key>
			<value>1284102</value>
		</detail>
		<detail xsi:type="keyStringValuePair">
			<key>ProviderTransactionID</key>
			<value>0389564217</value>
		</detail>
		<detail xsi:type="keyStringValuePair">
			<key>ApprovalCode</key>
			<value>837468</value>
		</detail>
	</paymentDetails>
	<paymentAccount>
		<paymentAccountID>23c24ef3-b164-4e92-b231-f94bbf45bfa2</paymentAccountID>
	</paymentAccount>
</payment>
</handlePaymentStateChangedNotificationRequest>

Sample handlePaymentStateChangedNotificationRequest for state RefusedByProvider:

<handlePaymentStateChangedNotificationRequest xmlns:xsd=http://www.w3.org/2001/XMLSchema
                                              xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
                                              xmlns=http://www.cqrpayments.com/PaymentProcessing>
<payment
         xsi:type="paymentWithPaymentAccount">
	<merchantID>{{merchant}}</merchantID>
    <shopID>{{shop}}</shopID>
	<paymentMethod>
		<key>463</key>
		<value>Apple Visa Withdrawal</value>
	</paymentMethod>
	<merchantTransactionID>129673b2-4862-44bd-9c6d-31c3d2632b14</merchantTransactionID>
	<paymentID>eb675fac-22e1-4044-b2de-bffb68ca5f4f</paymentID>
	<userID>VantivAppleCardWithdrawalAT</userID>
	<paymentProvider>
		<key>124</key>
		<value>Vantiv</value>
	</paymentProvider>
	<amount currencyCode="EUR">2222.0000</amount>
	<creationType>
		<key>1</key>
		<value>User</value>
	</creationType>
	<userIP>127.0.0.1</userIP>
	<state>
		<id>953540f1-5239-4b13-853f-ebd39870286a</id>
		<definition>
			<key>100</key>
			<value>RefusedByProvider</value>
		</definition>
		<createdOn>2024-12-02T13:25:39.643</createdOn>
		<paymentStateDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderResponseCode</key>
				<value>12</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderResponseMessage</key>
				<value>DECLINED</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>AVSResponse</key>
				<value>N</value>
			</detail>
			<detail xsi:type="keyIntValuePair">
				<key>PaymentStateReasonID</key>
				<value>1</value>
			</detail>
		</paymentStateDetails>
	</state>
	<isExecuted>false</isExecuted>
	<baseAmount currencyCode="EUR">2222.0000</baseAmount>
	<paymentDetails>
		<detail xsi:type="keyStringValuePair">
			<key>ProviderExternalID</key>
			<value>1284103</value>
		</detail>
	</paymentDetails>
	<paymentAccount>
		<paymentAccountID>f3fda16b-45d0-4eac-8118-12f4f761eeee</paymentAccountID>
	</paymentAccount>
</payment>
</handlePaymentStateChangedNotificationRequest>

Sample handlePaymentStateChangedNotificationRequest for state WithdrawErrorReportedByProvider:

<handlePaymentStateChangedNotificationRequest xmlns:xsd=http://www.w3.org/2001/XMLSchema
                                              xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
                                              xmlns=http://www.cqrpayments.com/PaymentProcessing>
<payment
         xsi:type="paymentWithPaymentAccount">
	<merchantID>{{merchant}}</merchantID>
    <shopID>{{shop}}</shopID>
	<paymentMethod>
		<key>463</key>
		<value>Apple Visa Withdrawal</value>
	</paymentMethod>
	<merchantTransactionID>ff23c2a9-383d-41f2-a9a4-930616a2947f</merchantTransactionID>
	<paymentID>1aabbfee-328c-47a4-86eb-049fdbd68fd4</paymentID>
	<userID>VantivAppleCardWithdrawalAT</userID>
	<paymentProvider>
		<key>124</key>
		<value>Vantiv</value>
	</paymentProvider>
	<amount currencyCode="GBP">11.0000</amount>
	<creationType>
		<key>1</key>
		<value>User</value>
	</creationType>
	<userIP>127.0.0.1</userIP>
	<state>
		<id>81edaecc-e619-4fa1-8a47-3e377a09a478</id>
		<definition>
			<key>21</key>
			<value>WithdrawErrorReportedByProvider</value>
		</definition>
		<createdOn>2024-12-02T13:32:07.957</createdOn>
		<paymentStateDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderErrorMessage</key>
				<value>Credit card is blocked.</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderErrorCode</key>
				<value>03</value>
			</detail>
			<detail xsi:type="keyIntValuePair">
				<key>PaymentStateReasonID</key>
				<value>1</value>
			</detail>
		</paymentStateDetails>
	</state>
	<isExecuted>false</isExecuted>
	<baseAmount currencyCode="EUR">12.7300</baseAmount>
	<paymentDetails>
		<detail xsi:type="keyStringValuePair">
			<key>ProviderExternalID</key>
			<value>1284105</value>
		</detail>
	</paymentDetails>
	<paymentAccount>
		<paymentAccountID>f3fda16b-45d0-4eac-8118-12f4f761eeee</paymentAccountID>
	</paymentAccount>
</payment>
</handlePaymentStateChangedNotificationRequest>

Sample handlePaymentStateChangedNotificationRequest for state ProviderCommunicationErrorOccurred

<handlePaymentStateChangedNotificationRequest xmlns:xsd=http://www.w3.org/2001/XMLSchema
                                              xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
                                              xmlns=http://www.cqrpayments.com/PaymentProcessing>
<payment
         xsi:type="paymentWithPaymentAccount">
	<merchantID>{{merchant}}</merchantID>
    <shopID>{{shop}}</shopID>
	<paymentMethod>
		<key>463</key>
		<value>Apple Visa Withdrawal</value>
	</paymentMethod>
	<merchantTransactionID>937ea0b5-a279-4d2f-8511-bba4a643679d</merchantTransactionID>
	<paymentID>c7f67a03-ecf4-48df-ba36-d338d52cc0b6</paymentID>
	<userID>VantivAppleCardWithdrawalAT</userID>
	<paymentProvider>
		<key>124</key>
		<value>Vantiv</value>
	</paymentProvider>
	<amount currencyCode="GBP">11.0000</amount>
	<creationType>
		<key>1</key>
		<value>User</value>
	</creationType>
	<userIP>127.0.0.1</userIP>
	<state>
		<id>8ff16389-e7d6-45ed-bc3e-1673ca8c6b55</id>
		<definition>
			<key>233</key>
			<value>ProviderCommunicationErrorOccurred</value>
		</definition>
		<createdOn>2024-12-02T13:36:28.84</createdOn>
		<paymentStateDetails>
			<detail xsi:type="keyIntValuePair">
				<key>PaymentStateReasonID</key>
				<value>1</value>
			</detail>
		</paymentStateDetails>
	</state>
	<isExecuted>false</isExecuted>
	<baseAmount currencyCode="EUR">12.7300</baseAmount>
	<paymentDetails>
		<detail xsi:type="keyStringValuePair">
			<key>ProviderExternalID</key>
			<value>1284107</value>
		</detail>
	</paymentDetails>
	<paymentAccount>
		<paymentAccountID>f3fda16b-45d0-4eac-8118-12f4f761eeee</paymentAccountID>
	</paymentAccount>
</payment>
</handlePaymentStateChangedNotificationRequest>