Sources e CustomersObsoleto
Aprenda como vincular e gerenciar fontes com objetos Customer.
Aviso
We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must migrate them to the Payment Methods API.
While we don’t plan to remove support for card payments, we recommend replacing any use of the Sources API with the PaymentMethods API, which provides access to our latest features and payment method types.
Um objeto Source pode ser de uso único ou reutilizável, como indicado por seu parâmetro usage. Enquanto fontes podem ser cobradas diretamente, fontes reutilizáveis sempre devem ser vinculadas a um objeto Customer para uso posterior. Vincular fontes reutilizáveis a objetos Customer permite que você apresente aos clientes uma lista de formas de pagamento reutilizáveis que foram usadas anteriormente com seu aplicativo ou site.
Fontes reutilizáveis
Algumas formas de pagamento (como o débito automático SEPA) aceitam fontes reutilizáveis, de modo que você pode criar pagamentos adicionais sem que o cliente passe pelo processo de pagamento novamente. Uma fonte que pode ser reutilizada tem seu parâmetro usage definido como reusable.
Vincule uma fonte reutilizável a um objeto Customer antes de fazer uma solicitação de cobrança. Se você cobrar uma fonte reutilizável sem antes vinculá-la, a fonte é consumida (o status muda de chargeable para consumed). As fontes consumidas não podem ser usadas em novos pagamentos.
Vincular uma fonte a um novo objeto Customer
Você pode criar um objeto Customer e vincular uma fonte em uma chamada de API. Isso é útil se for a primeira vez que você está vendo esse cliente.
A fonte se torna a fonte padrão, do objeto Customer, que é a primeira e única forma de pagamento do cliente. A fonte padrão é selecionada automaticamente se você fizer uma solicitação de cobrança usando o parâmetro customer sem especificar uma source.
Vincular uma Source a um objeto Customer existente
Quando atualizar um objeto Customer que tiver uma fonte padrão, isso automaticamente destaca a fonte existente e adiciona a fonte informada como o novo padrão. Para adicionar uma fonte sem substituir o padrão existente, use o método vincular, como mostrado abaixo.
Aqui, como a fonte padrão pode já existir para o objeto Customer, a fonte recém-adicionada não se torna a fonte padrão. No entanto, você pode alterar a fonte padrão, atualizando o objeto Customer e especificando a fonte como o valor para default_.
Cobrar uma fonte vinculada
É necessário especificar o objeto Customer e a fonte quando fizer uma solicitação de cobrança.
Se tentar cobrar um objeto Customer sem especificar uma fonte, a Stripe usa a fonte padrão do cliente.
Desvincular uma fonte
Se precisar remover uma fonte de um objeto Customer específico, você pode destacar a fonte. Isso altera o status da fonte para consumed, por isso ela não pode ser usada depois de ser destacada.
Fontes de uso único
As fontes de uso único devem ser criadas sempre que o cliente faz um pagamento e não podem ser reutilizadas. Por isso, não recomendamos que você as vincule de forma permanente aos clientes.
Se desejar associar um pagamento a um objeto Customer específico, você pode incluir um parâmetro customer, fazendo uma solicitação de cobrança com uma fonte, mesmo que a fonte não esteja vinculada.
O objeto Charge resultante faz referência aos objetos Customer e Source, mesmo que eles não estejam diretamente relacionados entre si.