Create payment token for a given payment source

Creates a Payment Token from the given payment source and adds it to the Vault of the associated customer.

POST /v3/vault/payment-tokens

Create payment token for a given payment source

cURL

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"
    }
  }
}
'

200

{
  "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

Pattern: ^.*$

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.

Show child attributes

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

Response

200

application/json

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

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

customer · Customer Request · object

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

Show child attributes

payment_source · Payment token response payment source · object

The vaulted payment method details.

Show child attributes

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

An array of related HATEOAS links.

Required array length: 1 - 32 elements

Show child attributes