Void

Voids allow you to effectively terminate the sale as if it never happened. When a full void occurs, no money is moved between any of the parties involved in the sale transaction.

Full Voids

A full void means the entire transaction is essentially terminated. The cardholder will not see a settled transaction on their statement.

Quick notes on full voids:

  • When a full void occurs, the ITC is terminated, prohibiting any VCs from being issued from that ITC going forward.
  • No DM (Daily Margin) is paid on full voids
  • You can not reverse a full void - once it’s done you would need to reauthorize the card if the void was a mistake.
  • Full voids can be performed in the CXP Portal

Partial Voids

A partial void will essentially “put back” that amount onto the customer’s credit card - returning the amount of the partial void to not impact the cardholder’s open to buy. For example, if you process a sale for $100, but it should have been $80, you can call the /void route with “Amount”:”20.00” to void $20 of the $100.

Quick notes on partial voids:

  • When a partial void occurs, the ITC is not automatically terminated like it is in a full void.
  • The Daily Margin timing changes slightly. See the section below detailing “Daily Margin for Partial Voids”.
  • You can not reverse a partial void - once it’s done you would need to reauthorize the card if the partial void was a mistake.
  • You can do multiple partial voids
  • You can also do multiple partial voids and then do a full void if you just need to void the remaining amount
  • As of the 2.06 release, partial voids can also be accomplished via the ConnexPay portal. Access the Sales → Search portal page and locate the order you want to partially void. The ‘Partial Void/Return' column will display an action button for orders that can be voided. Selecting that button will pop a screen that will ask you to confirm the return. The amount displayed is the full amount that can be voided (if a partial void occurred previously this amount will include that partial void amount). If you wish to return less than the full amount, key the desired value. Select ‘OK’ to save.

Technical Implementation

Partial voids can be performed by including an "Amount" in your payload when you call the Void route:

{
  "DeviceGuid" : "4b5013f7-b275-4929-8e83-0167c6edf639",
  "SaleGuid": "c5ac2017-99cb-4b1f-a90e-142cc82b21e5",
  "Amount": "20.00"
  "VoidReason": "DEVICE_TIMEOUT"
}

Full voids can be performed simply by not including the Amount when calling the void route.

For more technical information on the Void routes, please reference the developer documents here.

Voids in Reporting and CXP Portal

To see partial voids in the CXP Portal access Sales → Search Transactions → Search Voids and filter by the status of ‘Partially Voided’:

📘

Note:

Voids and Partial Voids apply only to credit card sales. If you need to process a return to a cash sale you will need to use the 'Return' endpoint.

Daily Margin for Partial Voids

DM (Daily Margin) is calculated by subtracting the amount the VC was issued from the amount of the sale. For example, a Sale of $100 and a VC created for $80 would result in $20 in DM ($100 Sale - $80 VC).

In the event of a partial void, the calculation remains the same but using the sale amount after the partial void. For example, a $100 sale and a VC was created for $80 but then a $30 partial void occurred on the sale. This would result in -$10 DM ($100 Sale - $30 partial void - $80 VC) meaning you would be debited DM for that transaction instead of being paid DM for that transaction.

In normal use cases, however, the VC would also be used for a lesser amount. So using the same example the VC was created for $80 but the purchase price dropped by $30 and only $50 is used on the VC. When RM (Residual Margin) is calculated it would come out to $30 ($80 issued - $50 settled).

So between DM and RM, you would be credited $20 (-$10 DM + $30 RM).

However, the issue is DM is calculated and credited/debited many days prior to RM. To avoid putting you in a negative cash position for those few days, when DM sums to a negative number, we will not apply that negative DM until the same day that RM is applied. In other words, if we were just following this one transaction in the example above, we would credit you $20 ($-10 for DM and $30 for RM) on the same day.

FAQs

If a transaction is voided let's say within the hour, is the authorization pending amount cleared right away from the customer's card?

Yes, we process real time voids so the cardholder should see the void immediately. Some issuing banks work differently than others - but most will post that void to the cardholder's balance immediately.


Did this page help you?