Overview

Create a new payment source for a customer using a token from your payment gateway. The token must be generated client-side using Stripe.js or similar.

Example: After collecting card details via Stripe Elements, pass the token to create a saved payment source for future charges.

Conditional Requirements

Condition	Required Fields
Always	`customer_id`, `object_gateway`
`object_gateway=stripe`	`object_id` (format: `src_`, `card_`, or `pm_*`)
`object_gateway=tap`	`object_id` (format: `card_`) OR `tap_token`, `properties.tap_customer_id` (format: `cus_`)
`object_gateway=vantiv`	`object_id`, `properties.exp_month`, `properties.exp_year`, `properties.last4`, `properties.card_type`
`object_gateway=cybersource`	`object_id`, `properties.exp_month`, `properties.exp_year`, `properties.last4`, `properties.card_type`
`object_gateway=braintree`	`object_id`, `properties.braintree_customer_id`
Both `customer_id` AND `customer_old_provider_id` are set	Must reference the same customer

Related Endpoints

Sources - Overview of the sources API
Customers - Customers who own sources