Apple Pay Request
November 13, 2025 ยท View on GitHub
Information needed to pay using ApplePay.
Structure
ApplePayRequest
Fields
| Name | Type | Tags | Description | Getter | Setter |
|---|---|---|---|---|---|
Id | String | Optional | ApplePay transaction identifier, this will be the unique identifier for this transaction provided by Apple. The pattern is defined by an external party and supports Unicode. Constraints: Minimum Length: 1, Maximum Length: 250, Pattern: ^.*$ | String getId() | setId(String id) |
Name | String | Optional | The full name representation like Mr J Smith. Constraints: Minimum Length: 3, Maximum Length: 300 | String getName() | setName(String name) |
EmailAddress | String | Optional | The internationalized email address. Note: Up to 64 characters are allowed before and 255 characters are allowed after the @ sign. However, the generally accepted maximum length for an email address is 254 characters. The pattern verifies that an unquoted @ sign exists. Constraints: Minimum Length: 3, Maximum Length: 254, Pattern: ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?\.)+[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[A-Za-z0-9-]*[A-Za-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$ | String getEmailAddress() | setEmailAddress(String emailAddress) |
PhoneNumber | PhoneNumber | Optional | The phone number in its canonical international E.164 numbering plan format. | PhoneNumber getPhoneNumber() | setPhoneNumber(PhoneNumber phoneNumber) |
DecryptedToken | ApplePayDecryptedTokenData | Optional | Information about the Payment data obtained by decrypting Apple Pay token. | ApplePayDecryptedTokenData getDecryptedToken() | setDecryptedToken(ApplePayDecryptedTokenData decryptedToken) |
StoredCredential | CardStoredCredential | Optional | Provides additional details to process a payment using a card that has been stored or is intended to be stored (also referred to as stored_credential or card-on-file). Parameter compatibility: payment_type=ONE_TIME is compatible only with payment_initiator=CUSTOMER. usage=FIRST is compatible only with payment_initiator=CUSTOMER. previous_transaction_reference or previous_network_transaction_reference is compatible only with payment_initiator=MERCHANT. Only one of the parameters - previous_transaction_reference and previous_network_transaction_reference - can be present in the request. | CardStoredCredential getStoredCredential() | setStoredCredential(CardStoredCredential storedCredential) |
VaultId | String | Optional | The PayPal-generated ID for the vaulted payment source. This ID should be stored on the merchant's server so the saved payment source can be used for future transactions. Constraints: Minimum Length: 1, Maximum Length: 255, Pattern: ^[0-9a-zA-Z_-]+$ | String getVaultId() | setVaultId(String vaultId) |
Attributes | ApplePayAttributes | Optional | Additional attributes associated with apple pay. | ApplePayAttributes getAttributes() | setAttributes(ApplePayAttributes attributes) |
ExperienceContext | ApplePayExperienceContext | Optional | Customizes the payer experience during the approval process for the payment. | ApplePayExperienceContext getExperienceContext() | setExperienceContext(ApplePayExperienceContext experienceContext) |
Example (as JSON)
{
"id": "id6",
"name": "name6",
"email_address": "email_address4",
"phone_number": {
"national_number": "national_number6"
},
"decrypted_token": {
"transaction_amount": {
"currency_code": "currency_code6",
"value": "value2"
},
"tokenized_card": {
"name": "name4",
"number": "number2",
"expiry": "expiry2",
"card_type": "VISA",
"type": "UNKNOWN"
},
"device_manufacturer_id": "device_manufacturer_id6",
"payment_data_type": "3DSECURE",
"payment_data": {
"cryptogram": "cryptogram6",
"eci_indicator": "eci_indicator0",
"emv_data": "emv_data0",
"pin": "pin4"
}
}
}