PayPal · Schema

Customer

The customer who approves and pays for the order. The customer is also known as the payer.

BillingCommerceDisputesInvoicesOrderPaymentsPayoutsSubscriptionTokensWebhook
View JSON Schema on GitHub

JSON Schema

paypal-payer-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/payer",
  "title": "Customer",
  "type": "object",
  "description": "The customer who approves and pays for the order. The customer is also known as the payer.",
  "format": "payer_v1",
  "allOf": [
    {
      "$ref": "#/components/schemas/payer_base"
    },
    {
      "properties": {
        "name": {
          "description": "The name of the payer. Supports only the `given_name` and `surname` properties.",
          "$ref": "#/components/schemas/name"
        },
        "phone": {
          "description": "The phone number of the customer. Available only when you enable the **Contact Telephone Number** option in the <a href=\"https://www.paypal.com/cgi-bin/customerprofileweb?cmd=_profile-website-payments\">**Profile & Settings**</a> for the merchant's PayPal account. The `phone.phone_number` supports only `national_number`.",
          "$ref": "#/components/schemas/phone_with_type"
        },
        "birth_date": {
          "description": "The birth date of the payer in `YYYY-MM-DD` format.",
          "$ref": "#/components/schemas/date_no_time"
        },
        "tax_info": {
          "description": "The tax information of the payer. Required only for Brazilian payer's. Both `tax_id` and `tax_id_type` are required.",
          "$ref": "#/components/schemas/tax_info"
        },
        "address": {
          "description": "The address of the payer. Supports only the `address_line_1`, `address_line_2`, `admin_area_1`, `admin_area_2`, `postal_code`, and `country_code` properties. Also referred to as the billing address of the customer.",
          "$ref": "#/components/schemas/address_portable"
        }
      }
    }
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/paypal-payer"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.