Sources e CustomersObsoleto

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 um pedido de cobrança. Se cobrar uma fonte reutilizável sem antes vinculá-la, a fonte é consumida (o status muda de chargeable para consumed). Fontes consumidas não podem ser usadas para 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.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  --data-urlencode email="paying.user@example.com" \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

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.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs/sources \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "source"="src_18eYalAHEMiOZZp1l9ZTjSU0"

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_source.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d default_source=src_18eYalAHEMiOZZp1l9ZTjSU0

Cobrar uma fonte vinculada

É necessário especificar o objeto Customer e a fonte quando fizer uma solicitação de cobrança.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount="1099" \
  -d currency="eur" \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

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. Fazer isso altera o status da fonte para consumed, por isso, não pode ser usada após ser destacada.

Fontes de uso único

Fontes de uso único devem ser criadas sempre que o cliente fizer 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.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount="1099" \
  -d currency="eur" \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

O objeto Charge resultante referencia os objetos Customer e Source, mesmo que não estejam diretamente relacionados entre si.