List all payment tokens

Returns all payment tokens for a customer.

GET /v3/vault/payment-tokens

List all payment tokens

cURL

curl --request GET \
  --url https://api-m.sandbox.paypal.com/v3/vault/payment-tokens \
  --header 'Authorization: Bearer <token>'

200

{
  "customer": {
    "id": "customer_4029352050"
  },
  "payment_tokens": [
    {
      "id": "8kk8451t",
      "customer": {
        "id": "customer_4029352050"
      },
      "payment_source": {
        "card": {
          "brand": "VISA",
          "last_digits": "1111",
          "expiry": "2027-02",
          "name": "John Doe",
          "billing_address": {
            "address_line_1": "2211 N First Street",
            "address_line_2": "17.3.160",
            "admin_area_2": "San Jose",
            "admin_area_1": "CA",
            "postal_code": "95131",
            "country_code": "US"
          }
        }
      },
      "links": [
        {
          "rel": "self",
          "href": "https://api-m.paypal.com/v3/vault/payment-tokens/8kk8451t",
          "method": "GET",
          "encType": "application/json"
        },
        {
          "rel": "delete",
          "href": "https://api-m.paypal.com/v3/vault/payment-tokens/8kk8451t",
          "method": "DELETE",
          "encType": "application/json"
        }
      ]
    },
    {
      "id": "fgh6561t",
      "customer": {
        "id": "customer_4029352050"
      },
      "payment_source": {
        "paypal": {
          "description": "Description for PayPal to be shown to PayPal payer",
          "email_address": "[e-mail]",
          "account_id": "VYYFH3WJ4JPJQ",
          "shipping": {
            "name": {
              "full_name": "John Doe"
            },
            "address": {
              "address_line_1": "2211 N First Street",
              "address_line_2": "17.3.160",
              "admin_area_2": "San Jose",
              "admin_area_1": "CA",
              "postal_code": "95131",
              "country_code": "US"
            }
          },
          "usage_pattern": "IMMEDIATE",
          "usage_type": "MERCHANT",
          "customer_type": "CONSUMER",
          "name": {
            "given_name": "John",
            "surname": "Doe"
          },
          "address": {
            "address_line_1": "2211 N First Street",
            "address_line_2": "17.3.160",
            "admin_area_2": "San Jose",
            "admin_area_1": "CA",
            "postal_code": "95131",
            "country_code": "US"
          }
        }
      },
      "links": [
        {
          "rel": "self",
          "href": "https://api-m.paypal.com/v3/vault/payment-tokens/fgh6561t",
          "method": "GET",
          "encType": "application/json"
        },
        {
          "rel": "delete",
          "href": "https://api-m.paypal.com/v3/vault/payment-tokens/fgh6561t",
          "method": "DELETE",
          "encType": "application/json"
        }
      ]
    },
    {
      "id": "hg654s1t",
      "customer": {
        "id": "customer_4029352050"
      },
      "payment_source": {
        "venmo": {
          "description": "Description for Venmo to be shown to Venmo payer",
          "shipping": {
            "name": {
              "full_name": "John Doe"
            },
            "address": {
              "address_line_1": "2211 N First Street",
              "address_line_2": "17.3.160",
              "admin_area_2": "San Jose",
              "admin_area_1": "CA",
              "postal_code": "95131",
              "country_code": "US"
            }
          },
          "usage_pattern": "IMMEDIATE",
          "usage_type": "MERCHANT",
          "customer_type": "CONSUMER",
          "email_address": "[e-mail]",
          "user_name": "johndoe",
          "name": {
            "given_name": "John",
            "surname": "Doe"
          },
          "account_id": "VYYFH3WJ4JPJQ",
          "address": {
            "address_line_1": "PayPal",
            "address_line_2": "2211 North 1st Street",
            "admin_area_1": "CA",
            "admin_area_2": "San Jose",
            "postal_code": "96112",
            "country_code": "US"
          }
        }
      },
      "links": [
        {
          "rel": "self",
          "href": "https://api-m.paypal.com/v3/vault/payment-tokens/hg654s1t",
          "method": "GET",
          "encType": "application/json"
        },
        {
          "rel": "delete",
          "href": "https://api-m.paypal.com/v3/vault/payment-tokens/hg654s1t",
          "method": "DELETE",
          "encType": "application/json"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "self",
      "href": "https://api-m.paypal.com/v3/vault/payment-tokens?customer_id=customer_4029352050&page=1&page_size=5&total_required=false",
      "method": "GET",
      "encType": "application/json"
    },
    {
      "rel": "first",
      "href": "https://api-m.paypal.com/v3/vault/payment-tokens?customer_id=customer_4029352050&page=1&page_size=5&total_required=false",
      "method": "GET",
      "encType": "application/json"
    },
    {
      "rel": "last",
      "href": "https://api-m.paypal.com/v3/vault/payment-tokens?customer_id=customer_4029352050&page=1&page_size=5&total_required=false",
      "method": "GET",
      "encType": "application/json"
    }
  ]
}

Authorizations

Authorization · string · header · required

Oauth 2.0 authentication

Query Parameters

customer_id · string · required

A unique identifier representing a specific customer in merchant's/partner's system or records.

Required string length: 7 - 36

Pattern: ^[0-9a-zA-Z_-]+$

page_size · integer · default: 5

A non-negative, non-zero integer indicating the maximum number of results to return at one time.

Required range: 1 <= x <= 5

page · integer · default: 1

A non-negative, non-zero integer representing the page of the results.

Required range: 1 <= x <= 10

total_required · boolean · default: false

A boolean indicating total number of items (total_items) and pages (total_pages) are expected to be returned in the response.

Response

200

application/json

Successful execution.

Collection of payment tokens saved for a given customer.

total_items · integer

Total number of items.

Required range: 1 <= x <= 50

total_pages · integer

Total number of pages.

Required range: 1 <= x <= 10

customer · Customer Request · object

This object defines a customer in your system. Use it to manage customer profiles, save payment methods and contact details.

Show child attributes

payment_tokens · Payment Token Response · object[]

Maximum array length: 64

Show child attributes

links · Link Description · object[] · read-only

An array of related HATEOAS links.

Required array length: 1 - 32 elements

Show child attributes