Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Introduction
Apple Pay on the Web enables customers with iOS devices or Macs to pay using payment methods stored in their wallet-app. Merchants need to display an Apple Pay button to eligible customers, who then get presented a payment sheet for easy review of the order and payment. Merchants can configure the look and feel of both buttons and payment sheet, but should adhere to the Apple guidelines.
Prerequisites
Onboarding
Apple Developer Account
Certificate Management
Apple Pay on Your Website
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"token":{
"paymentData":{
"version":"EC_v1",
"data":"3+f4oOTwPa6f1UZ6tG...CE=",
"signature":"MIAGCSqGSIb3DQ...AAAA==",
"header":{
"ephemeralPublicKey":"MFkwEK...Md==",
"publicKeyHash":"l0CnXdMv...D1I=",
"transactionId":"32b...4f3"
}
},
"paymentMethod":{
"displayName":"Visa 1234",
"network":"Visa",
"type":"debit"
},
"transactionIdentifier":"32b...4f3"
},
"billingContact":{
"addressLines":[
"1 Street",
""
],
"administrativeArea":"",
"country":"United Kingdom",
"countryCode":"GB",
"familyName":"Appleseed",
"givenName":"John",
"locality":"London",
"postalCode":"AB12 3CD",
"subAdministrativeArea":"",
"subLocality":""
},
"shippingContact":{
"addressLines":[
"1 Street",
""
],
"administrativeArea":"",
"country":"United Kingdom",
"countryCode":"GB",
"familyName":"Appleseed",
"givenName":"John",
"locality":"London",
"postalCode":"AB12 3CD",
"subAdministrativeArea":"",
"subLocality":"",
"phoneNumber":"01234 567890",
"emailAddress":"john.appleseed@apple.com"
}
} |
API Requests
Overview of Special Parameters
A successful Apple Pay Session will return a payment object with all info on the session. Many contents of this object can be mapped to existing Server API parameters.
| Section | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| UI Tabs | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
However, the actual payment part of the object is encrypted and has to be sent to the PAYONE API in special parameters.
| API Parameter | Required | Comments | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| clearingtype | + |
| ||||||||||||||||||||||||||||||||
| wallettype | + |
| ||||||||||||||||||||||||||||||||
| cardtype | + |
| ||||||||||||||||||||||||||||||||
| add_paydata[paymentdata_token_version] | + |
| ||||||||||||||||||||||||||||||||
| add_paydata[paymentdata_token_data] | + |
| ||||||||||||||||||||||||||||||||
| add_paydata[paymentdata_token_signature] | + |
| ||||||||||||||||||||||||||||||||
| add_paydata[paymentdata_token_ephemeral_publickey] | + |
| ||||||||||||||||||||||||||||||||
| add_paydata[paymentdata_token_publickey_hash] | + |
| ||||||||||||||||||||||||||||||||
| add_paydata[paymentdata_token_transaction_id] | + |
| ||||||||||||||||||||||||||||||||
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|