PayPal-PHP-Server-SDK/doc/models/order-application-context.md

Order Application Context

Customizes the payer experience during the approval process for the payment with PayPal. Note: Partners and Marketplaces might configure brand_name and shipping_preference during partner account setup, which overrides the request values.

Structure

OrderApplicationContext

Fields

Name	Type	Tags	Description	Getter	Setter
brandName	?string	Optional	DEPRECATED. The label that overrides the business name in the PayPal account on the PayPal site. The fields in application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.brand_name). Please specify this field in the experience_context object instead of the application_context object. Constraints: Minimum Length: 1, Maximum Length: 127	getBrandName(): ?string	setBrandName(?string brandName): void
locale	?string	Optional	DEPRECATED. The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, or zh-TW. The fields in application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.locale). Please specify this field in the experience_context object instead of the application_context object. Constraints: Minimum Length: 2, Maximum Length: 10, Pattern: ^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?$	getLocale(): ?string	setLocale(?string locale): void
landingPage	?string(OrderApplicationContextLandingPage)	Optional	DEPRECATED. DEPRECATED. The type of landing page to show on the PayPal site for customer checkout. The fields in application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.landing_page). Please specify this field in the experience_context object instead of the application_context object. Default: OrderApplicationContextLandingPage::NO_PREFERENCE Constraints: Minimum Length: 1, Maximum Length: 13, Pattern: ^[0-9A-Z_]+$	getLandingPage(): ?string	setLandingPage(?string landingPage): void
shippingPreference	?string(OrderApplicationContextShippingPreference)	Optional	DEPRECATED. DEPRECATED. The shipping preference: Displays the shipping address to the customer. Enables the customer to choose an address on the PayPal site. Restricts the customer from changing the address during the payment-approval process. . The fields in application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.shipping_preference). Please specify this field in the experience_context object instead of the application_context object. Default: OrderApplicationContextShippingPreference::GET_FROM_FILE Constraints: Minimum Length: 1, Maximum Length: 20, Pattern: ^[0-9A-Z_]+$	getShippingPreference(): ?string	setShippingPreference(?string shippingPreference): void
userAction	?string(OrderApplicationContextUserAction)	Optional	DEPRECATED. Configures a Continue or Pay Now checkout flow. The fields in application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.user_action). Please specify this field in the experience_context object instead of the application_context object. Default: OrderApplicationContextUserAction::CONTINUE_ Constraints: Minimum Length: 1, Maximum Length: 8, Pattern: ^[0-9A-Z_]+$	getUserAction(): ?string	setUserAction(?string userAction): void
paymentMethod	?PaymentMethodPreference	Optional	DEPRECATED. The customer and merchant payment preferences. The fields in application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.payment_method_selected). Please specify this field in the experience_context object instead of the application_context object..	getPaymentMethod(): ?PaymentMethodPreference	setPaymentMethod(?PaymentMethodPreference paymentMethod): void
returnUrl	?string	Optional	DEPRECATED. The URL where the customer is redirected after the customer approves the payment. The fields in application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.return_url). Please specify this field in the experience_context object instead of the application_context object.	getReturnUrl(): ?string	setReturnUrl(?string returnUrl): void
cancelUrl	?string	Optional	DEPRECATED. The URL where the customer is redirected after the customer cancels the payment. The fields in application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.cancel_url). Please specify this field in the experience_context object instead of the application_context object.	getCancelUrl(): ?string	setCancelUrl(?string cancelUrl): void
storedPaymentSource	?StoredPaymentSource	Optional	DEPRECATED. Provides additional details to process a payment using a payment_source 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. . The fields in stored_payment_source are now available in the stored_credential object under the payment_source which supports them (eg. payment_source.card.stored_credential.payment_initiator). Please specify this field in the payment_source object instead of the application_context object.	getStoredPaymentSource(): ?StoredPaymentSource	setStoredPaymentSource(?StoredPaymentSource storedPaymentSource): void

Example (as JSON)

{
  "landing_page": "NO_PREFERENCE",
  "shipping_preference": "GET_FROM_FILE",
  "user_action": "CONTINUE",
  "brand_name": "brand_name2",
  "locale": "locale6"
}