Menu
List Vouchers For A Customer
List vouchers for a customer
/customers/{customer-id}/payment_vouchersUse it in a workflow
- Add a step and choose the Chargebee connector.
- Pick the List Vouchers For A Customer action (under Chargebee API).
- Fill in the fields below, then reference the result from later steps as
{{listVouchersForACustomer.response.data}}.
Request
Path parameters
customer-idstringrequiredQuery parameters
limitinteger (int32)The number of resources to be returned.
Default 10
offsetstring<p class="mb-2">Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">offset</code> to the value of <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">next_offset</code> obtained in the previous iteration of the API call.</p>
statusobjectoptional, enumerated string filter Current status of Payment Voucher. Possible values are : active, consumed, expired, failure. **Supported operators :** is, is_not, in, not_in, in, not_in **Example →** *status\[is\] = "active, consumed, expired"*
isstring\* \`active\` - Active and ready to be consumed \* \`consumed\` - Consumed for a transaction and cannot be used again \* \`expired\` - Expired before consumed and cannot be used again \* \`failure\` - Failed to create the voucher due to gateway rejection
One ofactiveconsumedexpiredfailure
is_notstring\* \`active\` - Active and ready to be consumed \* \`consumed\` - Consumed for a transaction and cannot be used again \* \`expired\` - Expired before consumed and cannot be used again \* \`failure\` - Failed to create the voucher due to gateway rejection
One ofactiveconsumedexpiredfailure
instring\* \`active\` - Active and ready to be consumed \* \`consumed\` - Consumed for a transaction and cannot be used again \* \`expired\` - Expired before consumed and cannot be used again \* \`failure\` - Failed to create the voucher due to gateway rejection
One ofactiveconsumedexpiredfailure
not_instring\* \`active\` - Active and ready to be consumed \* \`consumed\` - Consumed for a transaction and cannot be used again \* \`expired\` - Expired before consumed and cannot be used again \* \`failure\` - Failed to create the voucher due to gateway rejection
One ofactiveconsumedexpiredfailure
sort_byobjectoptional, string filter Sorts based on the specified attribute. **Supported attributes :** date, updated_at **Supported sort-orders :** asc, desc **Example →** *sort_by\[asc\] = "date"* This will sort the result based on the 'date' attribute in ascending(earliest first) order.
ascstringOne ofdateupdated_at
descstringOne ofdateupdated_at
Headers
chargebee-request-origin-devicestringThe device from which the customer has made the request
chargebee-request-origin-userstring (email)The email address of your customer/user. Use this when the email address has only ASCII characters.
chargebee-request-origin-user-encodedstring (email)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-request-origin-ipstringThe IP address of the customer where the request originated
chargebee-business-entity-idstringIf 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.
Response
Returns 200 with an object. Read it in later steps with {{listVouchersForACustomer.response.data.<field>}}.
listarray<object>payment_voucherobjectrequired20 fieldsThe Payment Voucher resource represents a voucher that has been created for a customer to initiate voucher-based payment. This resource contains relevant details such as the voucher URL, the amount of the voucher, the status of the voucher, and more. Currently, the only supported voucher-based payment source is Boleto. Boleto is a payment method in Brazil that is regulated by the Central Bank of Brazil and is considered an official form of payment. This is also a popular voucher-based payment method in Brazil. **Note:** This resource can be extended in the future to support other types of payment sources for vouchers.
next_offsetstring<p class="mb-2">This attribute is returned only if more resources are present. To fetch the next set of resources use this value for the input parameter <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">offset</code>.</p>
{
"list": null,
"next_offset": null
}
Need more? See the Chargebee guide for connection setup and behaviour shared by every action.