Void

This event has more than one version. Click the tab for the version you want to view.


Version 1

Supported Formats: URL Encoded

Variable Name Description Data Type
(Max Length)		 Example Value
transactionId Transaction identification number. string 0912191101000000159
subscriptionId Subscription ID Number (Approval Post URL only). bigint(20) unsigned 1000000000
clientAccnum CCBill Merchant main account number. mediumint(6)
unsigned
 900100
clientSubacc CCBill Merchant Sub Account Number. smallint(4)
unsigned
zerofill		 0000
timestamp Time the event occurred. date 2012‐08‐05 15:18:17
amount The amount of the voided transaction. string 4.95
currency String Representation of currencyCode Varchar(3) USD, EUR, GBP, CAD
currencyCode The three‐digit currency corresponding to the voided transaction. int(3) 978
(see Appendix A for a list of Currency Codes.)
accountingAmount The price, in USD, of the voided transaction. string 9.95
accountingCurrency String Representation of accountingCurrencyCode Varchar(3) USD, EUR, GBP, CAD
accountingCurrencyCode Three‐digit currency code for the accounting amount. int(3) 840
(see Appendix A for a list of Currency Codes.)
reason The Reason given for a cancellation, chargeback, refund, or void, if any. string Customer Refunded, Proof of cancel, Webmaster, Billed cancel.

Version 2

Supported Formats: URL Encoded

The changes to Void in version 2 contain all of the previous parameters for version 1, with the addition of two new variables last4 and expDate.

Variable Name Description Data Type
(Max Length)		 Example Value
transactionId Transaction identification number. string 0912191101000000159
subscriptionId Subscription ID Number (Approval Post URL only). bigint(20) unsigned 1000000000
clientAccnum CCBill Merchant main account number. mediumint(6)
unsigned
 900100
clientSubacc CCBill Merchant Sub Account Number. smallint(4)
unsigned
zerofill		 0000
timestamp Time the event occurred. date 2012‐08‐05 15:18:17
amount The amount of the voided transaction. string 4.95
currency String Representation of currencyCode Varchar(3) USD, EUR, GBP, CAD
currencyCode The three‐digit currency corresponding to the voided transaction. int(3) 978
(see Appendix A for a list of Currency Codes.)
accountingAmount The price, in USD, of the voided transaction. string 9.95
accountingCurrency String Representation of accountingCurrencyCode Varchar(3) USD, EUR, GBP, CAD
accountingCurrencyCode Three‐digit currency code for the accounting amount. int(3) 840
(see Appendix A for a list of Currency Codes.)
last4 Last 4 digits of the Credit Card number or Banking Account number. smallint(4) unsigned zerofill 5100
expDate Expiration Date for Credit Card or Payment Card provided. smallint(4) unsigned zerofill 0217
(MMYY)
reason The Reason given for a cancellation, chargeback, refund, or void, if any. string Customer Refunded, Proof of cancel, Webmaster, Billed cancel.

Version 3

Supported Formats: URL Encoded

The changes to Void in version 3 contain all of the previous parameters for version 2, with the addition of the variables cardType and paymentType.

Variable Name Description Data Type
(Max Length)		 Example Value
transactionId Transaction identification number. string 0912191101000000159
subscriptionId Subscription ID Number (Approval Post URL only). bigint(20) unsigned 1000000000
clientAccnum CCBill Merchant main account number. mediumint(6)
unsigned
 900100
clientSubacc CCBill Merchant Sub Account Number. smallint(4)
unsigned
zerofill		 0000
timestamp Time the event occurred. date 2012‐08‐05 15:18:17
amount The amount of the voided transaction. string 4.95
currency String Representation of currencyCode Varchar(3) USD, EUR, GBP, CAD
currencyCode The three‐digit currency corresponding to the voided transaction. int(3) 978
(see Appendix A for a list of Currency Codes.)
accountingAmount The price, in USD, of the voided transaction. string 9.95
accountingCurrency String Representation of accountingCurrencyCode Varchar(3) USD, EUR, GBP, CAD
accountingCurrencyCode Three-digit currency code for the accounting amount. int(3) 840
(see Appendix A for a list of Currency Codes.)
cardType The type of Credit Card used varchar(20) VISA
paymentType The type of payment varchar(10) CREDIT
last4 Last 4 digits of the Credit Card number or Banking Account number. smallint(4) unsigned zerofill 5100
expDate Expiration Date for Credit Card or Payment Card provided. smallint(4) unsigned zerofill 0217
(MMYY)
reason The Reason given for a cancellation, chargeback, refund, or void, if any. string Customer Refunded, Proof of cancel, Webmaster, Billed cancel.

Version 4

Supported Formats: URL Encoded, JSON

The changes to Void in version 4 contain all of the previous parameters for version 3, with the addition of the paymentAccount variable.

Variable Name Description Data Type
(Max Length)		 Example Value
transactionId Transaction identification number. string 0912191101000000159
subscriptionId Subscription ID Number (Approval Post URL only). bigint(20) unsigned 1000000000
clientAccnum CCBill Merchant main account number. mediumint(6)
unsigned
 900100
clientSubacc CCBill Merchant Sub Account Number. smallint(4)
unsigned
zerofill		 0000
timestamp Time the event occurred. date 2012‐08‐05 15:18:17
amount The amount of the voided transaction. string 4.95
currency String Representation of currencyCode Varchar(3) USD, EUR, GBP, CAD
currencyCode The three‐digit currency corresponding to the voided transaction. int(3) 978
(see Appendix A for a list of Currency Codes.)
accountingAmount The price, in USD, of the voided transaction. string 9.95
accountingCurrency String Representation of accountingCurrencyCode Varchar(3) USD, EUR, GBP, CAD
accountingCurrencyCode Three‐digit currency code for the accounting amount. int(3) 840
(see Appendix A for a list of Currency Codes.)
cardType The type of Credit Card used varchar(20) VISA
paymentAccount Field must be configured by CCBill for data to be sent. alpha-numeric hash 57bc7327b5d721d7d20b240c0357e6ed
paymentType The type of payment varchar(10) CREDIT
last4 Last 4 digits of the Credit Card number or Banking Account number. smallint(4) unsigned zerofill 5100
expDate Expiration Date for Credit Card or Payment Card provided. smallint(4) unsigned zerofill 0217
(MMYY)
reason The Reason given for a cancellation, chargeback, refund, or void, if any. string Customer Refunded, Proof of cancel, Webmaster, Billed cancel.

Version 5

Supported Formats: URL Encoded, JSON

Version 5, released on 2025-02-17 includes optimizations and improvements to webhook event message processing. No new parameters have been introduced in this release.

Variable Name Description Data Type
(Max Length)		 Example Value
transactionId Transaction identification number. string 0912191101000000159
subscriptionId Subscription ID Number (Approval Post URL only). bigint(20) unsigned 1000000000
clientAccnum CCBill Merchant main account number. mediumint(6)
unsigned
 900100
clientSubacc CCBill Merchant Sub Account Number. smallint(4)
unsigned
zerofill		 0000
timestamp Time the event occurred. date 2012‐08‐05 15:18:17
amount The amount of the voided transaction. string 4.95
currency String Representation of currencyCode Varchar(3) USD, EUR, GBP, CAD
currencyCode The three‐digit currency corresponding to the voided transaction. int(3) 978
(see Appendix A for a list of Currency Codes.)
accountingAmount The price, in USD, of the voided transaction. string 9.95
accountingCurrency String Representation of accountingCurrencyCode Varchar(3) USD, EUR, GBP, CAD
accountingCurrencyCode Three‐digit currency code for the accounting amount. int(3) 840
(see Appendix A for a list of Currency Codes.)
cardType The type of Credit Card used varchar(20) VISA
paymentAccount Field must be configured by CCBill for data to be sent. alpha-numeric hash 57bc7327b5d721d7d20b240c0357e6ed
paymentType The type of payment varchar(10) CREDIT
last4 Last 4 digits of the Credit Card number or Banking Account number. smallint(4) unsigned zerofill 5100
expDate Expiration Date for Credit Card or Payment Card provided. smallint(4) unsigned zerofill 0217
(MMYY)
reason The Reason given for a cancellation, chargeback, refund, or void, if any. string Customer Refunded, Proof of cancel, Webmaster, Billed cancel.

Appendix A: Currency Codes

Currency Numeric CodeCurrency Letter CodeCurrency Name
036AUDAustralian Dollar
124CADCanadian Dollar
392JPYJapanese Yen
826GBPUnited Kingdom Pound
840USDUnited States Dollar
978EUREuro Member Countries

Appendix B: Decline Codes

Decline CodeDecline Text
1Website is not available for signup
2Unable to determine website signup requirements
3Your card type is not accepted, please try another type of credit card
4Banking System Error
5The credit card you entered is not valid
6Please check to ensure you entered your expiration date.Used to show individual corresponding yearly, monthly or daily dates for report data. The date function's format is year-month-day; for example, 2002-01-01. correctly
7Please check to ensure you entered your bank account number correctly
8Please check to ensure you entered your bank's routing number correctly
9Banking System Error, please try again
10Website has invalid pricing
11Transaction Declined
12You currently have a subscription and are unable to signup
13You have already had a free trial
14You must enter your CVV2 number on the back of your card
15Your account is currently being processed, please check the website you are joining to see if you have access. If not, please contact support@ccbill.com
16Subscription ID Provided is invalid
17Subscription ID does not exist in system
18Previous Transaction Attempt in request was declined
19You are not authorized to signup with the provided credentials
20No Decline
21You have already had a trial, please select a normal recurring membership option
22Error contacting bank, please try again later
23Invalid Credit Card Provided
24Transaction Denied by Bank
25Bank Error
26Card Processing Setup Incorrect for Merchant
27System Error, Please Try Again
28We are unable to process your transaction at this time. Please try again at a later time
29Card Expired
30We are unable to bill the telephone number provided for this transaction. Please return to the website and choose an alternate payment method.
31Insufficient Funds
32You must provide CVV2 to complete transaction
33Unable to determine transaction type
34Error contacting bank, please try again later
35Card Declined at Pre-Auth SC
36Unable To Contact Bank
37We currently do not process for your bank's bin
38Transaction Refused by Issuing Bank
39You Have Submitted Too Many Times Today
40The Card you are using is not accepted by this Merchant
41Merchant Inactive
42Incorrect Address Provided
43We are unable to process your telephone billing transaction because your provider only allows for one charge, per telephone number, per day, and our records show that you have an existing daily charge to this telephone number. Please return to the website and choose an alternative payment method.
44We're sorry, at this time prepaid cards are not allowed. Please try a different card type.
45Transaction requires additional approval: please refer to your confirmation e-mail for further instructions.

Changelog

Release 12 - 2025-04-29

The cardSubType parameter was added to specify the card type used in the transaction.

Affected Webhooks

  • CrossSaleFailure (v5)
  • CrossSaleSuccess (v6)
  • NewSaleFailure (v5)
  • NewSaleSuccess (v8)
  • RenewalFailure (v5)
  • RenewalSuccess (v7)
  • UpgradeFailure (v4)
  • UpgradeSuccess (v5)
  • UpSaleFailure (v5)
  • UpSaleSuccess (v7)

Release 11 - 2025-02-17

Enhancements

  • Webhook event processing optimized.
  • No new parameters introduced.

Updated Event Versions

  • Void (v5)
  • BillingDateChange (v2)
  • Cancellation (v2)
  • Chargeback (v5)
  • CrossSaleFailure (v4)
  • CrossSaleSuccess (v5)
  • CustomerDataUpdate (v5)
  • Expiration (v2)
  • ManualAdd (v2)
  • NewSaleFailure (v4)
  • NewSaleSuccess (v7)
  • Refund (v5)
  • RenewalFailure (v4)
  • RenewalSuccess (v6)
  • Return (v5)
  • UpgradeFailure (v3)
  • UpgradeSuccess (v4)
  • UpSaleFailure (v4)
  • UpSaleSuccess (v6)
  • UserReactivation (v2)

Release 10 - 2022-04-21

Two new parameters were added to support 3DS authentication results.

New Parameters

  • paymentAccount
  • scaResponseStatus

Affected Webhooks

paymentAccount added to:

  • CrossSaleFailure (v3)
  • CrossSaleSuccess (v4)
  • UpSaleFailure (v3)
  • UpgradeFailure (v2)
  • UpgradeSuccess (v3)

scaResponseStatus added to:

  • CrossSaleFailure (v3)
  • CrossSaleSuccess (v4)
  • UpSaleFailure (v3)
  • UpSaleSuccess (v5)
  • UpgradeFailure (v2)
  • UpgradeSuccess (v3)

Release 9 - 2020-02-11

Added new parameter for tracking 3DS authentication results.

New Parameter

  • threeDSecure

Affected Webhooks

  • NewSaleSuccess (v6)
  • NewSaleFailure (v3)

Release 8 - 2019-07-23

New Parameters

  • expDate
  • last4
  • paymentAccount

Affected Webhooks

  • UpSaleSuccess (v4)

Release 7 - 2017-7-19

New Feature

Webhook delivery now supports JSON format in addition to URL Encoded.

Release 6 - 2017-06-01

New Parameters

  • paymentAccount
  • accountingCurrency
  • currency
  • billedCurrency

Affected Webhooks

paymentAccount added to:

  • CustomerDataUpdate (v4)
  • Chargeback (v4)
  • Refund (v4)
  • Return (v4)
  • RenewalSuccess (v5)
  • Void (v4)

accountingCurrency added to:

  • Chargeback (all versions)
  • Refund (all versions)
  • RenewalSuccess (all versions)
  • Void (all versions)

currency added to:

  • Chargeback (all versions)
  • Refund (all versions)
  • Void (all versions)

billedCurrency added to:

  • RenewalSuccess (all versions)

Release 5 - 2017-05-11

Three new parameters were added to enable merchants to track the card BIN, payment method, and type of card used.

New Parameters

  • bin
  • paymentType
  • cardType

Affected Webhooks

bin added to:

  • NewSaleSuccess (v5)
  • UpgradeSuccess (v2)
  • UpSaleSuccess (v3)
  • CrossSaleSuccess (v3)
  • CustomerDataUpdate (v3)
  • Chargeback (v3)

paymentType added to:

  • Chargeback (v3)
  • Return (v3)
  • Refund (v3)
  • RenewalSuccess (v4)
  • RenewalFailure (v3)
  • Void (v3)

cardType added to:

  • Chargeback (v3)
  • Refund (v3)
  • RenewalSuccess (v4)
  • RenewalFailure (v3)
  • Void (v3)

Release 4 - 2017-04-13

Security Enhancement

TLS 1.2 support added for secure transmission.

New Parameters

  • expDate Provides card expiration date.
  • last4 Returns last 4 digits of card/bank account.

Affected Webhooks

  • NewSaleSuccess (v4)
  • CustomerDataUpdate (v2)
  • Chargeback (v2)
  • Refund (v2)
  • RenewalSuccess (v3)
  • Void (v2)

Release 3 - 2014-04-24

New Feature

Added flexId variable to support FlexForms (Open Beta). The field only appears for FlexForm transactions.

Affected Webhooks

  • NewSalesSuccess (v3)
  • NewSalesFailure (v2)
  • Notes were added to related Webhooks (UpSaleSuccess, UpSaleFailure, CrossSaleSuccess, CrossSaleFailure) to reference the correct base versions.

Release 2 - 2013-10-30

New Features

  • Introduced versioning support for configurations and events.
  • Older configurations prompt upgrade option.

New Webhooks Event

  • Return - Notifies users of check returns.

New Parameters

  • paymentAccount
  • renewalDate

Affected Webhooks

paymentAccount field added to:

  • NewSaleSuccess (v2)

renewalDate field added to:

  • RenewalSuccess (v2)
  • RenewalFailure (v2)

Bug Fixes

  • Fixes a bug that resulted in incorrect POST of the failureCode, failureReason, and transactionId fields in CrossSales, CrossSaleAPI, and Upgrades with specialOffer.
  • Fixes a bug that resulted in incorrect POST of failureCode, failureReason, and transactionId fields for Upsales.
  • Fixes a bug that caused the subscriptionTypeId to be incorrectly sent.

Release 1 - Initial Release

No notable changes included.