POST /exports/credit_notes

This API triggers export of credit note data. The exported zip file contains CSV files with credit note-related data.

Servers

Request headers

Name Type Required Description
chargebee-request-origin-device String No

The device from which the customer has made the request

Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

chargebee-event-webhook String No

skip only webhooks

Possible values:

  • "all-disabled"
chargebee-business-entity-id String No

If the site has multiple business entities, you can use this custom HTTP header to specify the business entity for which Chargebee should perform the operation.

chargebee-event-actions String No

skip all actions to be done on the events

Possible values:

  • "all-disabled"
chargebee-request-origin-user String No

The email address of your customer/user. Use this when the email address has only ASCII characters.

chargebee-request-origin-ip String No

The IP address of the customer where the request originated

chargebee-request-origin-user-encoded String No

The Base64-encoded email address of your customer/user. Use this if the email address has UTF-8 characters. When this header is provided, the header chargebee-request-origin-user is ignored.

chargebee-event-email String No

skip only emails

Possible values:

  • "all-disabled"

Request body fields

Name Type Required Description
credit_note Object No

Parameters for credit_note

credit_note.amount_available Object No

The yet to be used credits of this Credit Note.

credit_note.amount_available.gt String No
credit_note.amount_available.lte String No
credit_note.amount_available.between String No
credit_note.amount_available.gte String No
credit_note.amount_available.is_not String No
credit_note.amount_available.lt String No
credit_note.amount_available.is String No
credit_note.amount_refunded Object No

The refunds issued from this Credit Note.

credit_note.amount_refunded.gt String No
credit_note.amount_refunded.lte String No
credit_note.amount_refunded.between String No
credit_note.amount_refunded.gte String No
credit_note.amount_refunded.is_not String No
credit_note.amount_refunded.lt String No
credit_note.amount_refunded.is String No
credit_note.reference_invoice_id Object No

The identifier of the invoice against which this Credit Note is issued

credit_note.reference_invoice_id.not_in String No
credit_note.reference_invoice_id.starts_with String No
credit_note.reference_invoice_id.in String No
credit_note.reference_invoice_id.is_not String No
credit_note.reference_invoice_id.is String No
credit_note.reference_invoice_id.is_present String No

Possible values:

  • "false"
  • "true"
credit_note.reason_code Object No

The reason for issuing this Credit Note. The following reason codes are supported now\[Deprecated; use the [create_reason_code](/docs/api/credit_notes#credit_note_create_reason_code) parameter instead\]

credit_note.reason_code.not_in String No
credit_note.reason_code.in String No
credit_note.reason_code.is_not String No

* `write_off` - This reason will be set automatically for the Credit Notes created during invoice Write Off operation. * `subscription_change` - This reason will be set automatically for Credit Notes created during Change Subscription operation when proration is enabled * `subscription_cancellation` - This reason will be set automatically for Credit Notes created during cancel subscription operation * `subscription_pause` - This reason will be automatically set to credit notes created during pause/resume subscription operation. * `chargeback` - Can be set when you are recording your customer Chargebacks * `product_unsatisfactory` - Product Unsatisfactory * `service_unsatisfactory` - Service Unsatisfactory * `order_change` - Order Change * `order_cancellation` - Order Cancellation * `waiver` - Waiver * `other` - Can be set when none of the above reason codes are applicable * `fraudulent` - FRAUDULENT

Possible values:

  • "service_unsatisfactory"
  • "chargeback"
  • "other"
  • "write_off"
  • "product_unsatisfactory"
  • "fraudulent"
  • "subscription_change"
  • "subscription_cancellation"
  • "order_change"
  • "subscription_pause"
  • "order_cancellation"
  • "waiver"
credit_note.reason_code.is String No

* `write_off` - This reason will be set automatically for the Credit Notes created during invoice Write Off operation. * `subscription_change` - This reason will be set automatically for Credit Notes created during Change Subscription operation when proration is enabled * `subscription_cancellation` - This reason will be set automatically for Credit Notes created during cancel subscription operation * `subscription_pause` - This reason will be automatically set to credit notes created during pause/resume subscription operation. * `chargeback` - Can be set when you are recording your customer Chargebacks * `product_unsatisfactory` - Product Unsatisfactory * `service_unsatisfactory` - Service Unsatisfactory * `order_change` - Order Change * `order_cancellation` - Order Cancellation * `waiver` - Waiver * `other` - Can be set when none of the above reason codes are applicable * `fraudulent` - FRAUDULENT

Possible values:

  • "service_unsatisfactory"
  • "chargeback"
  • "other"
  • "write_off"
  • "product_unsatisfactory"
  • "fraudulent"
  • "subscription_change"
  • "subscription_cancellation"
  • "order_change"
  • "subscription_pause"
  • "order_cancellation"
  • "waiver"
credit_note.status Object No

The credit note status.

credit_note.status.not_in String No
credit_note.status.in String No
credit_note.status.is_not String No

* `adjusted` - When the Credit Note has been adjusted against an invoice. * `refunded` - When the entire credits (Credit Note amount) have been used (i.e either allocated to invoices or refunded). * `refund_due` - When the credits are yet to be used, or have been partially used. * `voided` - When the Credit Note has been cancelled.

Possible values:

  • "refund_due"
  • "adjusted"
  • "refunded"
  • "voided"
credit_note.status.is String No

* `adjusted` - When the Credit Note has been adjusted against an invoice. * `refunded` - When the entire credits (Credit Note amount) have been used (i.e either allocated to invoices or refunded). * `refund_due` - When the credits are yet to be used, or have been partially used. * `voided` - When the Credit Note has been cancelled.

Possible values:

  • "refund_due"
  • "adjusted"
  • "refunded"
  • "voided"
credit_note.voided_at Object No

Timestamp indicating the date and time this Credit Note gets voided.

credit_note.voided_at.on String No
credit_note.voided_at.after String No
credit_note.voided_at.between String No
credit_note.voided_at.before String No
credit_note.price_type Object No

The price type of the Credit Note.

credit_note.price_type.not_in String No
credit_note.price_type.in String No
credit_note.price_type.is_not String No

* `tax_exclusive` - All amounts in the document are exclusive of tax. * `tax_inclusive` - All amounts in the document are inclusive of tax.

Possible values:

  • "tax_exclusive"
  • "tax_inclusive"
credit_note.price_type.is String No

* `tax_exclusive` - All amounts in the document are exclusive of tax. * `tax_inclusive` - All amounts in the document are inclusive of tax.

Possible values:

  • "tax_exclusive"
  • "tax_inclusive"
credit_note.date Object No

The date the Credit Note is issued.

credit_note.date.on String No
credit_note.date.after String No
credit_note.date.between String No
credit_note.date.before String No
credit_note.create_reason_code Object No

Reason code for creating the credit note. Must be one from a list of reason codes set in the Chargebee app in **Settings \> Configure Chargebee \> Reason Codes \> Credit Notes \> Create Credit Note**. Must be passed if set as mandatory in the app. The codes are case-sensitive

credit_note.create_reason_code.not_in String No
credit_note.create_reason_code.starts_with String No
credit_note.create_reason_code.in String No
credit_note.create_reason_code.is_not String No
credit_note.create_reason_code.is String No
credit_note.total Object No

Credit Note amount in cents.

credit_note.total.gt String No
credit_note.total.lte String No
credit_note.total.between String No
credit_note.total.gte String No
credit_note.total.is_not String No
credit_note.total.lt String No
credit_note.total.is String No
credit_note.updated_at Object No

To filter based on updated at. This attribute will be present only if the resource has been updated after 2016-09-28.

credit_note.updated_at.on String No
credit_note.updated_at.after String No
credit_note.updated_at.between String No
credit_note.updated_at.before String No
credit_note.id Object No

Credit-note id.

credit_note.id.not_in String No
credit_note.id.starts_with String No
credit_note.id.in String No
credit_note.id.is_not String No
credit_note.id.is String No
credit_note.customer_id Object No

The identifier of the customer this Credit Note belongs to.

credit_note.customer_id.not_in String No
credit_note.customer_id.starts_with String No
credit_note.customer_id.in String No
credit_note.customer_id.is_not String No
credit_note.customer_id.is String No
credit_note.channel Object No

The subscription channel this object originated from and is maintained in.

credit_note.channel.not_in String No
credit_note.channel.in String No
credit_note.channel.is_not String No

* `web` - The object was created (and is maintained) for the web channel directly in Chargebee via API or UI. * `app_store` - The object data is synchronized with data from in-app subscription(s) created in Apple App Store. Direct manipulation of this object via UI or API is disallowed. * `play_store` - The object data is synchronized with data from in-app subscription(s) created in Google Play Store. Direct manipulation of this object via UI or API is disallowed.

In-App Subscriptions is currently in early access. Contact eap@chargebee.com for more information.

Possible values:

  • "web"
  • "play_store"
  • "app_store"
credit_note.channel.is String No

* `web` - The object was created (and is maintained) for the web channel directly in Chargebee via API or UI. * `app_store` - The object data is synchronized with data from in-app subscription(s) created in Apple App Store. Direct manipulation of this object via UI or API is disallowed. * `play_store` - The object data is synchronized with data from in-app subscription(s) created in Google Play Store. Direct manipulation of this object via UI or API is disallowed.

In-App Subscriptions is currently in early access. Contact eap@chargebee.com for more information.

Possible values:

  • "web"
  • "play_store"
  • "app_store"
credit_note.amount_allocated Object No

The amount allocated to the invoices.

credit_note.amount_allocated.gt String No
credit_note.amount_allocated.lte String No
credit_note.amount_allocated.between String No
credit_note.amount_allocated.gte String No
credit_note.amount_allocated.is_not String No
credit_note.amount_allocated.lt String No
credit_note.amount_allocated.is String No
credit_note.type Object No

The credit note type. [Learn more](credit_notes?lang=curl#credit_note_types) about credit note types.

credit_note.type.not_in String No
credit_note.type.in String No
credit_note.type.is_not String No

* `adjustment` - Adjustment Credit Note * `refundable` - Refundable Credit Note * `store` - Store Credit Note

Possible values:

  • "refundable"
  • "store"
  • "adjustment"
credit_note.type.is String No

* `adjustment` - Adjustment Credit Note * `refundable` - Refundable Credit Note * `store` - Store Credit Note

Possible values:

  • "refundable"
  • "store"
  • "adjustment"
credit_note.subscription_id Object No

To filter based on subscription_id. NOTE: Not to be used if *consolidated invoicing* feature is enabled.

credit_note.subscription_id.not_in String No
credit_note.subscription_id.starts_with String No
credit_note.subscription_id.in String No
credit_note.subscription_id.is_not String No
credit_note.subscription_id.is String No
credit_note.subscription_id.is_present String No

Possible values:

  • "false"
  • "true"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.