Any way to record externally made payments?

209 views
Skip to first unread message

gpre...@womply.com

unread,
May 29, 2018, 6:02:49 PM5/29/18
to Kill Bill users mailing-list
Howdy,

Is there a way by which we can apply an "external charge" to an invoice in KillBill? For example, if someone mailed in a check or paid by cash, and we needed to manually apply that to their account, and preferably to a specific invoice.

Thanks.

-Greg

zeroco...@gmail.com

unread,
May 30, 2018, 7:14:12 AM5/30/18
to Kill Bill users mailing-list

stephane brossier

unread,
May 30, 2018, 12:03:57 PM5/30/18
to zeroco...@gmail.com, Kill Bill users mailing-list
Greg,


You can apply an external charge to a particular invoice by specifying the invoiceId in the json. However, we used to allow that on any invoice, regardless of its state, and we have changed the behavior to only allow that on DRAFT invoices -- as opposed to COMMITTED invoices. The rationale is that once an invoice has been committed, it can be seen by customers, payments may have occurred against the invoice, ... and so it makes sense to keep it immutable at this point.

Stéphane


--
You received this message because you are subscribed to the Google Groups "Kill Bill users mailing-list" group.
To unsubscribe from this group and stop receiving emails from it, send an email to killbilling-users+unsubscribe@googlegroups.com.
To post to this group, send email to killbilling-users@googlegroups.com.
Visit this group at https://groups.google.com/group/killbilling-users.
To view this discussion on the web visit https://groups.google.com/d/msgid/killbilling-users/7114a91b-dd85-4e38-a771-cc37bc196a4e%40googlegroups.com.

For more options, visit https://groups.google.com/d/optout.

gpre...@womply.com

unread,
May 30, 2018, 12:27:33 PM5/30/18
to Kill Bill users mailing-list
Stéphane,

Thanks for the response. Can you get a little more specific on which api I should use for this?

> when you receive the money, simply let Kill Bill know about it (either via our administrative UI or our APIs).

That's not a lot of detail to go off of, and the API has a ton of payment related endpoints/calls. If we can do it via KAUI, even better, but I wasn't able to discover anything there that looked relevant.

Thanks,

-Greg


On Wednesday, May 30, 2018 at 9:03:57 AM UTC-7, stephane brossier wrote:
> Greg,
>
>
>
>
> You can apply an external charge to a particular invoice by specifying the invoiceId in the json. However, we used to allow that on any invoice, regardless of its state, and we have changed the behavior to only allow that on DRAFT invoices -- as opposed to COMMITTED invoices. The rationale is that once an invoice has been committed, it can be seen by customers, payments may have occurred against the invoice, ... and so it makes sense to keep it immutable at this point.
>
>
> Stéphane
>
>
>
>
> On Wed, May 30, 2018 at 4:14 AM, <zeroco...@gmail.com> wrote:
>
>
> It seems possible:http://docs.killbill.io/latest/faq.html#_what_are_the_types_of_payment_methods_supported
>
> On Tuesday, 29 May 2018 22:02:49 UTC, gpre...@womply.com wrote:Howdy,
> Is there a way by which we can apply an "external charge" to an invoice in KillBill?  For example, if someone mailed in a check or paid by cash, and we needed to manually apply that to their account, and preferably to a specific invoice.
> Thanks.
> -Greg
>
>
>
>
>
>
> --
>
> You received this message because you are subscribed to the Google Groups "Kill Bill users mailing-list" group.
>
> To unsubscribe from this group and stop receiving emails from it, send an email to killbilling-us...@googlegroups.com.
>
> To post to this group, send email to killbill...@googlegroups.com.

zeroco...@gmail.com

unread,
May 30, 2018, 12:59:49 PM5/30/18
to Kill Bill users mailing-list

Greg Preston

unread,
May 30, 2018, 2:26:04 PM5/30/18
to stephane brossier, Kill Bill users mailing-list
So, using KAUI we try to "Make Payment" and check the "external?" box like so


This leads to:
"Error while communicating with the Kill Bill server: Error 400: InvoicePaymentJson should not contain a paymentMethodId when this is an external payment"

I'm leaving the Payment Method box blank as pictured.

I was  able to modify the form params being sent with the request, and removed the paymentMethodId param, and that seems to have worked.

If we didn't have to edit the form params manually, I think this flow would solve our current need.   We've only got a handful we need to do, so we may end up manually editing each one.


-Greg

--
You received this message because you are subscribed to a topic in the Google Groups "Kill Bill users mailing-list" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/killbilling-users/HhWWEQYYLAM/unsubscribe.
To unsubscribe from this group and all its topics, send an email to killbilling-users+unsubscribe@googlegroups.com.

To post to this group, send email to killbilling-users@googlegroups.com.
Visit this group at https://groups.google.com/group/killbilling-users.

stephane brossier

unread,
May 31, 2018, 1:39:45 PM5/31/18
to Greg Preston, Kill Bill users mailing-list
Greg,

Here is a pointer the api to create external charges. You can also find code examples -- e.g here on how to use it.

Also, the screen you were using on KAUI, is unrelated to creating external charges - it is about creating a payment.

Stéphane

Greg Preston

unread,
May 31, 2018, 4:17:00 PM5/31/18
to stephane brossier, Kill Bill users mailing-list
Sorry, I think I was unclear in my original post.  I'm trying to log an external payment, not an external charge.

For example, say we generate an invoice for someone, try to charge their card and it gets declined.  Then as a one-off solution they mail us a check and we cash it.

Now we need to record that payment via check someone within killbill so the system knows they've paid their invoice via some mechanism external to killbill.

If this was a commonly recurring thing for us, we might look into a new payments plugin to handle that payment type, but in reality we've only got a handful of these we want to record in the system.

-Greg

stephane brossier

unread,
May 31, 2018, 4:43:06 PM5/31/18
to Greg Preston, Kill Bill users mailing-list
Ah... ok, different then.

You need to use the following endpoint, example [here].

S.

Greg Preston

unread,
May 31, 2018, 4:47:37 PM5/31/18
to stephane brossier, Kill Bill users mailing-list
This looks like exactly what we need.  Thank you!

-Greg
Reply all
Reply to author
Forward
0 new messages