1
0
Files
PayPal-PHP-Server-SDK/doc/models/paypal-wallet-vault-instruction.md
Patrick Powers 1fc2cf1e07 2.0.0 Release (#58)
* Automated commit message

* Automated commit message

* add changelog

---------

Co-authored-by: PayPalServerSDKs <server-sdks@paypal.com>
2025-11-13 16:32:53 -06:00

2.7 KiB

Paypal Wallet Vault Instruction

Resource consolidating common request and response attributes for vaulting PayPal Wallet.

Structure

PaypalWalletVaultInstruction

Fields

Name Type Tags Description Getter Setter
description ?string Optional The description displayed to PayPal consumer on the approval flow for PayPal, as well as on the PayPal payment token management experience on PayPal.com.

Constraints: Minimum Length: 1, Maximum Length: 128
getDescription(): ?string setDescription(?string description): void
usagePattern ?string(UsagePattern) Optional Expected business/pricing model for the billing agreement.

Constraints: Minimum Length: 1, Maximum Length: 30
getUsagePattern(): ?string setUsagePattern(?string usagePattern): void
usageType string(PaypalPaymentTokenUsageType) Required The usage type associated with the PayPal payment token.

Constraints: Minimum Length: 1, Maximum Length: 255, Pattern: ^[0-9A-Z_]+$
getUsageType(): string setUsageType(string usageType): void
customerType ?string(PaypalPaymentTokenCustomerType) Optional The customer type associated with the PayPal payment token. This is to indicate whether the customer acting on the merchant / platform is either a business or a consumer.

Default: PaypalPaymentTokenCustomerType::CONSUMER

Constraints: Minimum Length: 1, Maximum Length: 255, Pattern: ^[0-9A-Z_]+$
getCustomerType(): ?string setCustomerType(?string customerType): void
permitMultiplePaymentTokens ?bool Optional Create multiple payment tokens for the same payer, merchant/platform combination. Use this when the customer has not logged in at merchant/platform. The payment token thus generated, can then also be used to create the customer account at merchant/platform. Use this also when multiple payment tokens are required for the same payer, different customer at merchant/platform. This helps to identify customers distinctly even though they may share the same PayPal account. This only applies to PayPal payment source.

Default: false
getPermitMultiplePaymentTokens(): ?bool setPermitMultiplePaymentTokens(?bool permitMultiplePaymentTokens): void

Example (as JSON)

{
  "usage_type": "MERCHANT",
  "customer_type": "CONSUMER",
  "permit_multiple_payment_tokens": false,
  "description": "description4",
  "usage_pattern": "UNSCHEDULED_PREPAID"
}