This documentation site is deprecated. The latest up-to-date API reference is available at
This site will remain available for historical reference until June 1, 2017

API: Invoices - Payments

Adding Payments to Invoices

Use this endpoint to record payments on an existing invoice.

  • amount The amount represented as a string. E.g. if the payment was for $14.50, you would pass 14.50
  • amount_in_cents The amount represented as a string in cents. E.g. if the payment was for $14.50, you would pass 1450
  • memo Typically the description of why the payment occured


format may be either ‘xml’ or ‘json’.


URL: https://<subdomain><invoice_id>/payments.<format>
Method: POST
Required Parameters: XML or JSON data, as specified by the input attributes
Response: The created payment

Here is a sample JSON document that you might POST to https://<subdomain><invoice_id>/payments.json

  "payment": {
    "amount": 10.00,
    "memo": "Lorem ipsum"

or if you wish to work in cents the amount_in_cents field can be used:

  "payment": {
    "amount_in_cents": 1000,
    "memo": "Lorem ipsum"

Here is a sample of a JSON response:

  "payment": {
     "amount_in_cents": 10000,
     "created_at": "2015-05-05T23:14:00-04:00",
     "ending_balance_in_cents": -10000,
     "id": 3,
     "kind": nil,
     "memo": "lorem ipsum",
     "payment_id": null,
     "product_id": 1,
     "starting_balance_in_cents": 0,
     "subscription_id": 99,
     "success": true,
     "type": "Payment",
     "transaction_type": "payment",
     "gateway_transaction_id": null