Skip to main content
POST
/
v3
/
vault
/
payment-tokens
Create payment token for a given payment source
curl --request POST \
  --url https://api-m.sandbox.paypal.com/v3/vault/payment-tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment_source": {
    "token": {
      "id": "5C991763VB2781612",
      "type": "BILLING_AGREEMENT"
    }
  }
}
'
{
  "id": "8kk8451t",
  "customer": {
    "id": "customer_4029352050"
  },
  "payment_source": {
    "card": {
      "last_digits": "1111",
      "expiry": "2027-02",
      "brand": "VISA",
      "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"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Oauth 2.0 authentication

Headers

​
PayPal-Request-Id
string

The server stores keys for 3 hours.

Required string length: 1 - 10000

Body

application/json

Payment Token creation with a financial instrument and an optional customer_id.

Payment Token Request where the source defines the type of instrument to be stored.

​
payment_source
Payment source request · object
required

The payment method to vault with the instrument details.

​
customer
Customer Request · object

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

Response

Idempotent response for a successful creation of payment token.

Full representation of a saved payment token.

​
id
string

The PayPal-generated ID for the vault token.

Required string length: 1 - 36
​
customer
Customer Request · object

Customer in merchant's or partner's system of records.

​
payment_source
Payment token response payment source · object

The vaulted payment method details.

​
links
Link Description · object[]

An array of related HATEOAS links.

Required array length: 1 - 32 elements