Create invoice item

docs/reference/webhooks.md

@@ -112,6 +112,10 @@ details on how to wire those up.
 * `recipient.created` - Occurs whenever a recipient is created.
 * `recipient.deleted` - Occurs whenever a recipient is deleted.
 * `recipient.updated` - Occurs whenever a recipient is updated.
+* `source.chargeable` - A Source object becomes chargeable after a customer has authenticated and verified a payment
+* `source.canceled` - A Source object expired and cannot be used to create a charge
+* `source.consumed` - A Source object that was single-use has already been charged
+* `source.failed` - A Source object failed to become chargeable as your customer declined to authenticate the payment
 * `sku.created` - Occurs whenever a SKU is created.
 * `sku.updated` - Occurs whenever a SKU is updated.
 * `transfer.created` - Occurs whenever a new transfer is created.

pinax/stripe/actions/customers.py

@@ -50,7 +50,6 @@ def create(user, card=None, plan=settings.PINAX_STRIPE_DEFAULT_PLAN, charge_imme
  email=user.email,
  source=card,
  plan=plan,
- quantity=quantity,
  trial_end=trial_end
  )
  try:
@@ -145,7 +144,7 @@ def set_default_source(customer, source):
 
 def sync_customer(customer, cu=None):
  """
- Syncronizes a local Customer object with details from the Stripe API
+ Synchronizes a local Customer object with details from the Stripe API
 
  Args:
  customer: a Customer object

pinax/stripe/actions/sources.py

@@ -106,6 +106,45 @@ def sync_bitcoin(customer, source):
  return utils.update_with_defaults(receiver, defaults, created)
 
 
+def sync_ideal(customer, source):
+ """
+ Syncronizes the data for an ideal source locally for a given customer
+
+ This is required since payment through ideal involves additional steps to be taken by the customer (select bank, enter codes, confirm, ...), updates will be made
+ available through webhooks or the return url and we then need to relate the payment to an instance of a source locally in order to process it further.
+
+ Args:
+ customer: the customer to create or update the source for
+ source: data reprenting the source from the Stripe API
+ """
+ defaults = dict(
+ customer=customer,
+ status = source["status"] or "",
+ type = source["type"] or "",
+ usage = source["usage"] or "",
+ amount = utils.convert_amount_for_db(source["amount"], source["currency"]), # currency is in but in fact it's always eur
+ flow = source["flow"] or "",
+ livemode = source["livemode"],
+ owner_address = source["owner"]["address"] or "",
+ owner_email = source["owner"]["email"] or "",
+ owner_name = source["owner"]["name"] or "",
+ owner_phone = source["owner"]["phone"] or "",
+ owner_verified_address = source["owner"]["verified_address"] or "",
+ owner_verified_email = source["owner"]["verified_email"] or "",
+ owner_verified_name = source["owner"]["verified_name"] or "",
+ owner_verified_phone = source["owner"]["verified_phone"] or "",
+ redirect_return_url = source["redirect"]["return_url"] or "",
+ redirect_status = source["redirect"]["status"] or "",
+ redirect_url = source["redirect"]["url"] or "",
+ ideal_bank = source["ideal"]["bank"] or "",
+ )
+ o, created = models.Ideal.objects.get_or_create(
+ stripe_id=source["id"],
+ defaults=defaults
+ )
+ return utils.update_with_defaults(o, defaults, created)
+
+
 def sync_payment_source_from_stripe_data(customer, source):
  """
  Syncronizes the data for a payment source locally for a given customer
@@ -116,6 +155,9 @@ def sync_payment_source_from_stripe_data(customer, source):
  """
  if source["id"].startswith("card_"):
  return sync_card(customer, source)
+ elif source.get("type", None) == "ideal":
+ # ideal is created using Sources, only then will it have a type attribute
+ return sync_ideal(customer, source)
  else:
  return sync_bitcoin(customer, source)
 
@@ -140,3 +182,15 @@ def update_card(customer, source, name=None, exp_month=None, exp_year=None):
  stripe_source.exp_year = exp_year
  s = stripe_source.save()
  return sync_payment_source_from_stripe_data(customer, s)
+
+
+def create_ideal(customer, token):
+ """
+ Attaches an ideal source to a customer
+
+ Args:
+ customer: the customer to create the source for
+ token: the token created from Stripe.js
+ """
+ source = customer.stripe_customer.sources.create(source=token)
+ return sync_payment_source_from_stripe_data(customer, source)

pinax/stripe/actions/subscriptions.py

@@ -171,14 +171,18 @@ def sync_subscription_from_stripe_data(customer, subscription):
  return sub
 
 
-def update(subscription, plan=None, quantity=None, prorate=True, coupon=None, charge_immediately=False):
+def update(subscription, plan=None, quantity=None, token=None, prorate=True, coupon=None, charge_immediately=False):
  """
  Updates a subscription
 
  Args:
  subscription: the subscription to update
  plan: optionally, the plan to change the subscription to
  quantity: optionally, the quantiy of the subscription to change
+ token: if provided, a token from Stripe.js that will be used as the
+ payment source for the subscription and set as the default
+ source for the customer, otherwise the current default source
+ will be used
  prorate: optionally, if the subscription should be prorated or not
  coupon: optionally, a coupon to apply to the subscription
  charge_immediately: optionally, whether or not to charge immediately
@@ -188,6 +192,8 @@ def update(subscription, plan=None, quantity=None, prorate=True, coupon=None, ch
  stripe_subscription.plan = plan
  if quantity:
  stripe_subscription.quantity = quantity
+ if token:
+ stripe_subscription.token = token
  if not prorate:
  stripe_subscription.prorate = False
  if coupon:

pinax/stripe/admin.py

@@ -7,6 +7,7 @@
  Subscription,
  Card,
  BitcoinReceiver,
+ Ideal,
  Customer,
  Event,
  EventProcessingException,
@@ -195,6 +196,12 @@ class BitcoinReceiverInline(admin.TabularInline):
  max_num = 0
 
 
+class IdealInline(admin.TabularInline):
+ model = Ideal
+ extra = 0
+ max_num = 0
+
+
 def subscription_status(obj):
  return ", ".join([subscription.status for subscription in obj.subscription_set.all()])
 subscription_status.short_description = "Subscription Status"
@@ -224,7 +231,8 @@ def subscription_status(obj):
  inlines=[
  SubscriptionInline,
  CardInline,
- BitcoinReceiverInline
+ BitcoinReceiverInline,
+ IdealInline,
  ]
 )
 

pinax/stripe/migrations/0008_ideal.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.10 on 2017-04-20 13:25
+from __future__ import unicode_literals
+
+from django.db import migrations, models
+import django.db.models.deletion
+import django.utils.timezone
+
+
+class Migration(migrations.Migration):
+
+ dependencies = [
+ ('pinax_stripe', '0007_auto_20170108_1202'),
+ ]
+
+ operations = [
+ migrations.CreateModel(
+ name='Ideal',
+ fields=[
+ ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+ ('stripe_id', models.CharField(max_length=255, unique=True)),
+ ('created_at', models.DateTimeField(default=django.utils.timezone.now)),
+ ('status', models.CharField(blank=True, max_length=32)),
+ ('type', models.CharField(blank=True, max_length=32)),
+ ('usage', models.CharField(blank=True, max_length=32)),
+ ('amount', models.DecimalField(decimal_places=2, max_digits=9, null=True)),
+ ('flow', models.CharField(max_length=32)),
+ ('livemode', models.BooleanField(default=False)),
+ ('owner_address', models.TextField(blank=True)),
+ ('owner_email', models.EmailField(blank=True, max_length=254)),
+ ('owner_name', models.TextField(blank=True)),
+ ('owner_phone', models.TextField(blank=True)),
+ ('owner_verified_address', models.TextField(blank=True)),
+ ('owner_verified_email', models.EmailField(blank=True, max_length=254)),
+ ('owner_verified_name', models.TextField(blank=True)),
+ ('owner_verified_phone', models.TextField(blank=True)),
+ ('redirect_return_url', models.URLField(max_length=1024)),
+ ('redirect_status', models.TextField(blank=True)),
+ ('redirect_url', models.URLField(max_length=1024)),
+ ('ideal_bank', models.TextField(blank=True)),
+ ('customer', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='pinax_stripe.Customer')),
+ ],
+ options={
+ 'abstract': False,
+ },
+ ),
+ ]

pinax/stripe/models.py

@@ -182,6 +182,29 @@ class BitcoinReceiver(StripeObject):
  used_for_payment = models.BooleanField(default=False)
 
 
+class Ideal(StripeObject):
+
+ customer = models.ForeignKey(Customer, on_delete=models.CASCADE)
+ status = models.CharField(max_length=32, blank=True)
+ type = models.CharField(max_length=32, blank=True)
+ usage = models.CharField(max_length=32, blank=True)
+ amount = models.DecimalField(decimal_places=2, max_digits=9, null=True)
+ flow = models.CharField(max_length=32)
+ livemode = models.BooleanField(default=False)
+ owner_address = models.TextField(blank=True)
+ owner_email = models.EmailField(blank=True)
+ owner_name = models.TextField(blank=True)
+ owner_phone = models.TextField(blank=True)
+ owner_verified_address = models.TextField(blank=True)
+ owner_verified_email = models.EmailField(blank=True)
+ owner_verified_name = models.TextField(blank=True)
+ owner_verified_phone = models.TextField(blank=True)
+ redirect_return_url = models.URLField(max_length=1024)
+ redirect_status = models.TextField(blank=True)
+ redirect_url = models.URLField(max_length=1024)
+ ideal_bank = models.TextField(blank=True)
+
+
 class Subscription(StripeObject):
 
  customer = models.ForeignKey(Customer, on_delete=models.CASCADE)

pinax/stripe/webhooks.py

@@ -447,6 +447,35 @@ class SKUUpdatedWebhook(Webhook):
  description = "Occurs whenever a SKU is updated."
 
 
+class SourceWebhook(Webhook):
+
+ def process_webhook(self):
+ sources.sync_payment_source_from_stripe_data(
+ self.event.customer,
+ self.event.validated_message["data"]["object"]
+ )
+
+
+class SourceChargeableWebhook(SourceWebhook):
+ name = "source.chargeable"
+ description = "A Source object becomes chargeable after a customer has authenticated and verified a payment."
+
+
+class SourceCanceledWebhook(SourceWebhook):
+ name = "source.canceled"
+ description = "A Source object expired and cannot be used to create a charge."
+
+
+class SourceConsumedWebhook(SourceWebhook):
+ name = "source.consumed"
+ description = "A Source object that was single-use has already been charged."
+
+
+class SourceFailedWebhook(SourceWebhook):
+ name = "source.failed"
+ description = "A Source object failed to become chargeable as your customer declined to authenticate the payment."
+
+
 class TransferWebhook(Webhook):
 
  def process_webhook(self):