Hey! These docs are for version 1.0, which is no longer officially supported. Click here for the latest version, 5.0!


The base of a subscription

Customers are of course your most valuable asset. In Upodi, Customers have a profile which contains information on the customer and associated payment methods, i.e. a credit card, in order to charge the customer for their subscriptions.

A customer holds information such as contact details, addresses and currency. These informations are passed around the billing of subscriptions, and will be included on the final invoice of a billing cycle.

Using the API

curl -X POST https://api.upodi.io/v2/customers/
-H 'Content-type: application/json'
-H "Authorization: Bearer Zjc0YjNjMTMtNWIwNi00MGMxLTljMjctMzhiM2EzZmE5NGRk;" 
-d '{ ' \
-d ' "accountnumber" : "CU-000120", ' \
-d ' "currencycode" : "EUR", ' \
-d ' "autobill" : true, ' \
-d ' "fullname" : "Sample Customer" ' \
-d '}'
UpodiService upodi = new UpodiService("aab31984-0256-4d10-afe2-c6a4f35bcf40");
var customerId = upodi.Customers.Create("CU-0020", "Customer Account", "EUR");

Preferrence currency
A customer will have a preferred currency or the default currency. This states in which currency the customer will be billed. Upon a billing cycle Upodi will try to fulfill this preferrence by matching the customer currency with the product plan currencies available. Should a match exist, the subscription and following invoices, will be in the matching currency. If no match is found, the product plan default currency superseeds the decision.


Currency calculations

Upodi does not calculate pricing on currencies. We merely pass on the currency between states of subscriptions and match these with the proper payment.

What's Next


We're always happy to help with code or other questions you might have! Search our documentation or contact helpdesk. You can also chat live with us using the Intercom icon.