# Payment Method Tokens API

> Payment Method Tokens API on Apizie: 6 endpoints (List all payment tokens, Create payment token for a given payment source, Retrieve a payment token, Delete payment token, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/payments:paypal-vault/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `payments:paypal-vault`
- Category: Payments
- Status: byok
- Source: https://paypal
- Page: https://apizie.tech/api/payments/paypal-vault
- OpenAPI: https://apizie.tech/api/payments/paypal-vault/openapi.json

The Payment Method Tokens API saves payment methods so payers don't have to enter details for future transactions. Payers can check out faster or pay without being present after they agree to save a payment method. The…

## Endpoints

### List all payment tokens
`GET https://apizie.tech/v1/payments:paypal-vault/customer-payment-tokens-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| customer_id | string | yes | A unique identifier representing a specific customer in merchant's/partner's system or records. |
| page_size | integer | no | A non-negative, non-zero integer indicating the maximum number of results to return at one time. |
| page | integer | no | A non-negative, non-zero integer representing the page of the results. |
| total_required | boolean | no | A boolean indicating total number of items (total_items) and pages (total_pages) are expected to be returned in the response. |

### Create payment token for a given payment source
`POST https://apizie.tech/v1/payments:paypal-vault/payment-tokens-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PayPal-Request-Id | string | no | The server stores keys for 3 hours. |
| body | object | yes | JSON request body |

### Retrieve a payment token
`GET https://apizie.tech/v1/payments:paypal-vault/payment-tokens-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | ID of the setup token. |

### Delete payment token
`POST https://apizie.tech/v1/payments:paypal-vault/payment-tokens-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | ID of the setup token. |

### Create a setup token
`POST https://apizie.tech/v1/payments:paypal-vault/setup-tokens-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PayPal-Request-Id | string | no | The server stores keys for 3 hours. |
| body | object | yes | JSON request body |

### Retrieve a setup token
`GET https://apizie.tech/v1/payments:paypal-vault/setup-tokens-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | ID of the setup token. |

## Example
```
curl "https://apizie.tech/v1/payments:paypal-vault/customer-payment-tokens-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Payment Method Tokens API?
Create a free Apizie key, then send GET https://apizie.tech/v1/payments:paypal-vault/customer-payment-tokens-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Payment Method Tokens API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Payment Method Tokens itself also needs your own key from paypal.

### Can AI agents use the Payment Method Tokens API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key payments:paypal-vault.

### What is the status of the Payment Method Tokens API?
Needs your own provider key (bring your own key)