POST
/
customers
/
{customer_id}
/
credits
/
ledger_entry
curl --request POST \
  --url https://api.withorb.com/v1/customers/{customer_id}/credits/ledger_entry \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "metadata": {},
  "currency": "<string>",
  "description": "<string>",
  "entry_type": "increment",
  "amount": 123,
  "expiry_date": "2023-12-25",
  "effective_date": "2023-12-25",
  "per_unit_cost_basis": "<string>",
  "invoice_settings": {
    "auto_collection": true,
    "net_terms": 123,
    "memo": "<string>",
    "require_successful_payment": false
  }
}'
{
  "metadata": {},
  "id": "<string>",
  "ledger_sequence_number": 123,
  "entry_status": "committed",
  "customer": {
    "id": "<string>",
    "external_customer_id": "<string>"
  },
  "starting_balance": 123,
  "ending_balance": 123,
  "amount": 123,
  "currency": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "credit_block": {
    "id": "<string>",
    "expiry_date": "2023-11-07T05:31:56Z",
    "per_unit_cost_basis": "<string>"
  },
  "entry_type": "increment",
  "created_invoices": [
    {
      "metadata": {},
      "voided_at": "2023-11-07T05:31:56Z",
      "paid_at": "2023-11-07T05:31:56Z",
      "issued_at": "2023-11-07T05:31:56Z",
      "scheduled_issue_at": "2023-11-07T05:31:56Z",
      "auto_collection": {
        "next_attempt_at": "2023-11-07T05:31:56Z",
        "previously_attempted_at": "2023-11-07T05:31:56Z",
        "enabled": true,
        "num_attempts": 123
      },
      "issue_failed_at": "2023-11-07T05:31:56Z",
      "sync_failed_at": "2023-11-07T05:31:56Z",
      "payment_failed_at": "2023-11-07T05:31:56Z",
      "payment_started_at": "2023-11-07T05:31:56Z",
      "amount_due": "8.00",
      "created_at": "2022-05-01T07:01:31+00:00",
      "currency": "USD",
      "customer": {
        "id": "<string>",
        "external_customer_id": "<string>"
      },
      "discount": "<any>",
      "discounts": [
        {
          "discount_type": "percentage",
          "applies_to_price_ids": [
            "h74gfhdjvn7ujokd",
            "7hfgtgjnbvc3ujkl"
          ],
          "reason": "<string>",
          "percentage_discount": 0.15
        }
      ],
      "due_date": "2022-05-30T07:00:00+00:00",
      "id": "<string>",
      "invoice_pdf": "https://assets.withorb.com/invoice/rUHdhmg45vY45DX/qEAeuYePaphGMdFb",
      "invoice_number": "JYEFHK-00001",
      "minimum": {
        "minimum_amount": "<string>",
        "filters": [
          {
            "field": "price_id",
            "operator": "includes",
            "values": [
              "<string>"
            ]
          }
        ]
      },
      "minimum_amount": "<string>",
      "maximum": {
        "maximum_amount": "<string>",
        "filters": [
          {
            "field": "price_id",
            "operator": "includes",
            "values": [
              "<string>"
            ]
          }
        ]
      },
      "maximum_amount": "<string>",
      "line_items": [
        {
          "amount": "7.00",
          "discount": {
            "discount_type": "percentage",
            "applies_to_price_ids": [
              "h74gfhdjvn7ujokd",
              "7hfgtgjnbvc3ujkl"
            ],
            "reason": "<string>",
            "percentage_discount": 0.15
          },
          "end_date": "2022-02-01T08:00:00+00:00",
          "grouping": "<string>",
          "minimum": {
            "minimum_amount": "<string>",
            "filters": [
              {
                "field": "price_id",
                "operator": "includes",
                "values": [
                  "<string>"
                ]
              }
            ]
          },
          "minimum_amount": "<string>",
          "maximum": {
            "maximum_amount": "<string>",
            "filters": [
              {
                "field": "price_id",
                "operator": "includes",
                "values": [
                  "<string>"
                ]
              }
            ]
          },
          "maximum_amount": "<string>",
          "adjustments": [
            {
              "id": "<string>",
              "is_invoice_level": true,
              "filters": [
                {
                  "field": "price_id",
                  "operator": "includes",
                  "values": [
                    "<string>"
                  ]
                }
              ],
              "reason": "<string>",
              "adjustment_type": "usage_discount",
              "usage_discount": 123,
              "amount": "<string>"
            }
          ],
          "name": "Fixed Fee",
          "quantity": 1,
          "start_date": "2022-02-01T08:00:00+00:00",
          "subtotal": "9.00",
          "adjusted_subtotal": "5.00",
          "credits_applied": "6.00",
          "partially_invoiced_amount": "4.00",
          "sub_line_items": [
            {
              "amount": "9.00",
              "name": "Tier One",
              "quantity": 5,
              "grouping": {
                "key": "region",
                "value": "west"
              },
              "type": "matrix",
              "matrix_config": {
                "dimension_values": [
                  "<string>"
                ]
              }
            }
          ],
          "tax_amounts": [
            {
              "tax_rate_description": "<string>",
              "tax_rate_percentage": "<string>",
              "amount": "<string>"
            }
          ],
          "id": "<string>",
          "price": {
            "metadata": {},
            "id": "<string>",
            "name": "<string>",
            "external_price_id": "<string>",
            "price_type": "usage_price",
            "model_type": "unit",
            "created_at": "2023-11-07T05:31:56Z",
            "cadence": "one_time",
            "billing_cycle_configuration": {
              "duration": 123,
              "duration_unit": "day"
            },
            "invoicing_cycle_configuration": {
              "duration": 123,
              "duration_unit": "day"
            },
            "billable_metric": {
              "id": "<string>"
            },
            "dimensional_price_configuration": {
              "dimensional_price_group_id": "<string>",
              "dimension_values": [
                "<string>"
              ]
            },
            "fixed_price_quantity": 123,
            "plan_phase_order": 123,
            "currency": "<string>",
            "conversion_rate": 123,
            "item": {
              "id": "<string>",
              "name": "<string>"
            },
            "credit_allocation": {
              "currency": "<string>",
              "allows_rollover": true
            },
            "discount": {
              "discount_type": "percentage",
              "applies_to_price_ids": [
                "h74gfhdjvn7ujokd",
                "7hfgtgjnbvc3ujkl"
              ],
              "reason": "<string>",
              "percentage_discount": 0.15
            },
            "minimum": {
              "minimum_amount": "<string>",
              "filters": [
                {
                  "field": "price_id",
                  "operator": "includes",
                  "values": [
                    "<string>"
                  ]
                }
              ]
            },
            "minimum_amount": "<string>",
            "maximum": {
              "maximum_amount": "<string>",
              "filters": [
                {
                  "field": "price_id",
                  "operator": "includes",
                  "values": [
                    "<string>"
                  ]
                }
              ]
            },
            "maximum_amount": "<string>",
            "unit_config": {
              "unit_amount": "<string>"
            }
          },
          "usage_customer_ids": [
            "<string>"
          ],
          "filter": "<string>"
        }
      ],
      "subscription": {
        "id": "VDGsT23osdLb84KD"
      },
      "subtotal": "8.00",
      "total": "8.00",
      "customer_balance_transactions": [
        {
          "id": "cgZa3SXcsPTVyC4Y",
          "created_at": "2022-05-01T07:01:31+00:00",
          "starting_balance": "33.00",
          "ending_balance": "22.00",
          "amount": "11.00",
          "action": "applied_to_invoice",
          "description": "An optional description",
          "invoice": {
            "id": "gXcsPTVyC4YZa3Sc"
          },
          "type": "increment",
          "credit_note": {
            "id": "<string>"
          }
        }
      ],
      "status": "issued",
      "invoice_source": "subscription",
      "shipping_address": {
        "line1": "<string>",
        "line2": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "country": "<string>"
      },
      "billing_address": {
        "line1": "<string>",
        "line2": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "country": "<string>"
      },
      "hosted_invoice_url": "<string>",
      "will_auto_issue": true,
      "eligible_to_issue_at": "2023-11-07T05:31:56Z",
      "customer_tax_id": {
        "country": "AD",
        "type": "ad_nrt",
        "value": "<string>"
      },
      "memo": "<string>",
      "credit_notes": [
        {
          "id": "<string>",
          "credit_note_number": "<string>",
          "reason": "<string>",
          "total": "<string>",
          "voided_at": "2022-05-01T07:01:31+00:00",
          "type": "<string>",
          "memo": "<string>"
        }
      ],
      "payment_attempts": [
        {
          "id": "<string>",
          "payment_provider": "stripe",
          "payment_provider_id": "<string>",
          "amount": "<string>",
          "succeeded": true,
          "created_at": "2023-11-07T05:31:56Z"
        }
      ],
      "invoice_date": "2022-05-01T07:00:00+00:00"
    }
  ]
}

Authorizations

Authorization
string
header
required

API Keys can be issued in the Orb's web application.

Path Parameters

customer_id
string | null
required

Body

application/json

Response

201
application/json
Created

The Credit Ledger Entry resource models prepaid credits within Orb.