An overview of the Stalls Billing API.
Use cases
The Billing API lets you perform all billing actions on your account.
- Checking how much money is available in a balance
- Topping up a balance prior to creating a delivery
You do not need the Billing APIs to successfully request a delivery.
Objects
Balances
Balances are how much money you have in a currency. Think of it as a virtual bank account, but without the account number or bank. Balances always have 2 amounts (pending and available). You can make payments from the available amount but not the pending amount. The pending amount is the total sum that is currently being processed.
Supported actions for balances
- View your balances and data about them
- Top-up a balance with any amount of a supported currency
- Create a new balance of a currency you don't have
- Deactivate any of the already existing balances ones
Payment tokens
Payment tokens are pre-authorized payment methods you can use to make future payments without entering details of the payment method or going through the authorization process again with your issuer or bank. This means that you just make a payment once with your payment method (while specifying you want it saved) and it will be saved for later use.
We support tokenizing the following payment methods
- Debit and credit cards (VISA, Mastercard, Amex, UnionPay, JCB, Discover)
- SEPA direct debit
- ACH debit
Payment method data encryption
Our payment processing partners encrypt and store your payment method's data securely.
Supported actions for payment tokens
- View saved payment tokens and data about them
- Deactivate a saved payment token
Once a payment token has been deactivated, it cannot be reactivated again without reauthorization.
Payments
Payments are all transactions that occur on your balances. These can be directly from a payment method or from a tokenized (saved) payment method for automated payments.
Supported actions for payment tokens
- View payments made previously and data about them