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
- {protocol}://{site}.{environment}:{port}/api/v2
- {protocol}://{site}-test.{environment}:{port}/api/v2
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:
|
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:
|
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-event-email |
String | No |
skip only emails Possible values:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
credit_note.type.is |
String | No |
* `adjustment` - Adjustment Credit Note * `refundable` - Refundable Credit Note * `store` - Store Credit Note Possible values:
|
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:
|
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.