POST /exports/transactions
This API triggers export of transaction data. The exported zip file contains CSV files with transaction-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 Valid 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 Valid 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-request-origin-user is ignored. |
chargebee-event-email |
String | No |
skip only emails Valid values:
|
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
transaction |
Object | No |
Parameters for transaction |
transaction.reference_number |
Object | No |
The reference number for this transaction. For example, the check number when |
transaction.reference_number.starts_with |
String | No | |
transaction.reference_number.is_not |
String | No | |
transaction.reference_number.is |
String | No | |
transaction.reference_number.is_present |
String | No |
Valid values:
|
transaction.gateway |
Object | No |
Gateway through which this transaction was done. Applicable only for 'Card' Payment Method |
transaction.gateway.not_in |
String | No | |
transaction.gateway.in |
String | No | |
transaction.gateway.is_not |
String | No |
Valid values:
|
transaction.gateway.is |
String | No |
Valid values:
|
transaction.status |
Object | No |
The status of this transaction. |
transaction.status.not_in |
String | No | |
transaction.status.in |
String | No | |
transaction.status.is_not |
String | No |
* `in_progress` - Transaction is being processed by the gateway. This typically happens for direct debit transactions or, in case of cards, refund transactions. Such transactions can take 2-7 days to complete, depending on the gateway and payment method. * `success` - The transaction is successful. * `voided` - The transaction got voided or authorization expired at gateway. * `failure` - Transaction failed. Refer the 'error_code' and 'error_text' fields to know the reason for failure * `timeout` - Transaction failed because of Gateway not accepting the connection. * `needs_attention` - Connection with Gateway got terminated abruptly. So, status of this transaction needs to be resolved manually * `late_failure` - This status indicates that late failure has been recorded for the transaction that has encountered success state in the previous stage. Valid values:
|
transaction.status.is |
String | No |
* `in_progress` - Transaction is being processed by the gateway. This typically happens for direct debit transactions or, in case of cards, refund transactions. Such transactions can take 2-7 days to complete, depending on the gateway and payment method. * `success` - The transaction is successful. * `voided` - The transaction got voided or authorization expired at gateway. * `failure` - Transaction failed. Refer the 'error_code' and 'error_text' fields to know the reason for failure * `timeout` - Transaction failed because of Gateway not accepting the connection. * `needs_attention` - Connection with Gateway got terminated abruptly. So, status of this transaction needs to be resolved manually * `late_failure` - This status indicates that late failure has been recorded for the transaction that has encountered success state in the previous stage. Valid values:
|
transaction.payment_method |
Object | No |
The payment method of this transaction |
transaction.payment_method.not_in |
String | No | |
transaction.payment_method.in |
String | No | |
transaction.payment_method.is_not |
String | No |
Valid values:
|
transaction.payment_method.is |
String | No |
Valid values:
|
transaction.date |
Object | No |
Indicates when this transaction occurred. |
transaction.date.on |
String | No | |
transaction.date.after |
String | No | |
transaction.date.between |
String | No | |
transaction.date.before |
String | No | |
transaction.updated_at |
Object | No |
To filter based on |
transaction.updated_at.on |
String | No | |
transaction.updated_at.after |
String | No | |
transaction.updated_at.between |
String | No | |
transaction.updated_at.before |
String | No | |
transaction.id |
Object | No |
Uniquely identifies the transaction. |
transaction.id.not_in |
String | No | |
transaction.id.starts_with |
String | No | |
transaction.id.in |
String | No | |
transaction.id.is_not |
String | No | |
transaction.id.is |
String | No | |
transaction.customer_id |
Object | No |
Identifier of the customer for which this transaction is made |
transaction.customer_id.not_in |
String | No | |
transaction.customer_id.starts_with |
String | No | |
transaction.customer_id.in |
String | No | |
transaction.customer_id.is_not |
String | No | |
transaction.customer_id.is |
String | No | |
transaction.customer_id.is_present |
String | No |
Valid values:
|
transaction.id_at_gateway |
Object | No |
The id with which this transaction is referred in gateway. |
transaction.id_at_gateway.starts_with |
String | No | |
transaction.id_at_gateway.is_not |
String | No | |
transaction.id_at_gateway.is |
String | No | |
transaction.gateway_account_id |
Object | No |
The gateway account used for this transaction |
transaction.gateway_account_id.not_in |
String | No | |
transaction.gateway_account_id.starts_with |
String | No | |
transaction.gateway_account_id.in |
String | No | |
transaction.gateway_account_id.is_not |
String | No | |
transaction.gateway_account_id.is |
String | No | |
transaction.amount |
Object | No |
Amount for this transaction. |
transaction.amount.gt |
String | No | |
transaction.amount.lte |
String | No | |
transaction.amount.between |
String | No | |
transaction.amount.gte |
String | No | |
transaction.amount.is_not |
String | No | |
transaction.amount.lt |
String | No | |
transaction.amount.is |
String | No | |
transaction.type |
Object | No |
Type of the transaction. |
transaction.type.not_in |
String | No | |
transaction.type.in |
String | No | |
transaction.type.is_not |
String | No |
Valid values:
|
transaction.type.is |
String | No |
Valid values:
|
transaction.payment_source_id |
Object | No |
To filter based on Transaction payment source id. |
transaction.payment_source_id.not_in |
String | No | |
transaction.payment_source_id.starts_with |
String | No | |
transaction.payment_source_id.in |
String | No | |
transaction.payment_source_id.is_not |
String | No | |
transaction.payment_source_id.is |
String | No | |
transaction.payment_source_id.is_present |
String | No |
Valid values:
|
transaction.amount_capturable |
Object | No |
To filter based on transaction's unused authorized/blocked amount. |
transaction.amount_capturable.gt |
String | No | |
transaction.amount_capturable.lte |
String | No | |
transaction.amount_capturable.between |
String | No | |
transaction.amount_capturable.gte |
String | No | |
transaction.amount_capturable.is_not |
String | No | |
transaction.amount_capturable.lt |
String | No | |
transaction.amount_capturable.is |
String | No | |
transaction.subscription_id |
Object | No |
Identifier of the subscription for which this transaction is made. |
transaction.subscription_id.not_in |
String | No | |
transaction.subscription_id.starts_with |
String | No | |
transaction.subscription_id.in |
String | No | |
transaction.subscription_id.is_not |
String | No | |
transaction.subscription_id.is |
String | No | |
transaction.subscription_id.is_present |
String | No |
Valid 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.