PayPal · Schema

Application Context

The application context, which customizes the payer experience during the subscription approval process with PayPal.

BillingCommerceDisputesInvoicesOrdersPaymentsPayoutsSubscriptionsTokensWebhooks

Properties

Name Type Description
brand_name string The label that overrides the business name in the PayPal account on the PayPal site.
locale object 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
shipping_preference string The location from which the shipping address is derived.
user_action string Configures the label name to `Continue` or `Subscribe Now` for subscription consent experience.
payment_method object The customer and merchant payment preferences. Currently only PAYPAL payment method is supported.
return_url string The URL where the customer is redirected after the customer approves the payment.
cancel_url string The URL where the customer is redirected after the customer cancels the payment.
View JSON Schema on GitHub

JSON Schema

paypal-application-context-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/application_context",
  "title": "Application Context",
  "description": "The application context, which customizes the payer experience during the subscription approval process with PayPal.",
  "type": "object",
  "properties": {
    "brand_name": {
      "type": "string",
      "description": "The label that overrides the business name in the PayPal account on the PayPal site.",
      "minLength": 1,
      "maxLength": 127
    },
    "locale": {
      "description": "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`.",
      "$ref": "#/components/schemas/language"
    },
    "shipping_preference": {
      "type": "string",
      "description": "The location from which the shipping address is derived.",
      "minLength": 1,
      "maxLength": 24,
      "pattern": "^[A-Z_]+$",
      "default": "GET_FROM_FILE",
      "enum": [
        "GET_FROM_FILE",
        "NO_SHIPPING",
        "SET_PROVIDED_ADDRESS"
      ]
    },
    "user_action": {
      "type": "string",
      "description": "Configures the label name to `Continue` or `Subscribe Now` for subscription consent experience.",
      "minLength": 1,
      "maxLength": 24,
      "pattern": "^[A-Z_]+$",
      "default": "SUBSCRIBE_NOW",
      "enum": [
        "CONTINUE",
        "SUBSCRIBE_NOW"
      ]
    },
    "payment_method": {
      "description": "The customer and merchant payment preferences. Currently only PAYPAL payment method is supported.",
      "$ref": "#/components/schemas/payment_method"
    },
    "return_url": {
      "type": "string",
      "format": "uri",
      "description": "The URL where the customer is redirected after the customer approves the payment.",
      "minLength": 10,
      "maxLength": 4000
    },
    "cancel_url": {
      "type": "string",
      "format": "uri",
      "description": "The URL where the customer is redirected after the customer cancels the payment.",
      "minLength": 10,
      "maxLength": 4000
    }
  },
  "required": [
    "return_url",
    "cancel_url"
  ]
}