1
0
Files
PayPal-PHP-Server-SDK/doc/models/apple-pay-request.md
Dani Kirby 6b43a4225b Beta Release 0.5.0 (#3)
* Automated commit message

* Automated commit message

* Automated commit message

* Automated commit message

---------

Co-authored-by: PayPalServerSDKs <server-sdks@paypal.com>
2024-09-09 12:10:34 -05:00

4.5 KiB

Apple Pay Request

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: ^.*$
getId(): ?string setId(?string id): void
name ?string Optional The full name representation like Mr J Smith.
Constraints: Minimum Length: 3, Maximum Length: 300
getName(): ?string setName(?string name): void
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])+)\])$
getEmailAddress(): ?string setEmailAddress(?string emailAddress): void
phoneNumber ?PhoneNumber Optional The phone number in its canonical international E.164 numbering plan format. getPhoneNumber(): ?PhoneNumber setPhoneNumber(?PhoneNumber phoneNumber): void
decryptedToken ?ApplePayDecryptedTokenData Optional Information about the Payment data obtained by decrypting Apple Pay token. getDecryptedToken(): ?ApplePayDecryptedTokenData setDecryptedToken(?ApplePayDecryptedTokenData decryptedToken): void
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.
getStoredCredential(): ?CardStoredCredential setStoredCredential(?CardStoredCredential storedCredential): void
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_-]+$
getVaultId(): ?string setVaultId(?string vaultId): void
attributes ?ApplePayAttributes Optional Additional attributes associated with apple pay. getAttributes(): ?ApplePayAttributes setAttributes(?ApplePayAttributes attributes): void

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": "CB_NATIONALE",
      "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"
    }
  }
}