Purchase Events

All purchase events will return a message which has the following properties:

Property	Description
id	Unique identifier of event
subject	Unique merchant GUID
data	Contains several data fields about the event. You can find examples of the Purchase Card events here and the Purchase Transaction events here
eventType	Type of event
eventTime	Time of event
dataVersion	Current schema version

Purchase Card Events

These are events triggered at a card level. The returned body can be seen here.

Event	Triggered when...
purchase.card.issued	...the VCC has been successfully issued
purchase.card.terminated	...the VCC has been successfully terminated
purchase.card.expired	...the VCC has expired
purchase.card.adjusted	...the VCC has been adjusted i.e. either changing reload amount on a VCC or the purchase type which controls MCC the card supports

Purchase Transaction Event

These events are triggered at an individual transaction level. The returned body and field descriptions can be seen here.

Event	Triggered when...
purchase.card.auth.declined	...a VCC purchase auth was declined
purchase.card.auth.approved	...a VCC purchase auth was approved. Temporary transaction type. Requires settlement.
purchase.card.auth.settled	...a VCC purchase was cleared post-approval and settled
purchase.card.chargeback.initiated.success	...a VCC chargeback has been created
purchase.card.chargeback.initiated.declined	...a VCC chargeback request has been declined
purchase.card.chargeback.accepted	...a VCC chargeback has been accepted (won)
purchase.card.chargeback.declined	...a VCC chargeback has been declined
purchase.card.chargeback.reversal.settled	...a rejected VCC chargeback has been cleared for reversal
purchase.card.chargeback.representment.completed	...a VCC chargeback case is in representment stage
purchase.card.auth.reversal	...a VCC reversal authorization was approved (voided auth prior to settlement)
purchase.card.auth.reversal.pending	...a VCC reversal pending approval. Temporary transaction type.
purchase.card.auth.reversal.settled	...a VCC authorization void by a merchant
purchase.card.auth.reversal.issuerexpiration.settled	...a VCC transaction reversal or dropped transaction due to elapsed time
purchase.card.return.completed	...a VCC refunds successfully after clearing process has been completed
purchase.card.return.auth.declined	...a VCC refund has been declined
purchase.card.return.auth.approved	...a VCC refund has been authorized. Temporary state before completion.
purchase.card.return.auth.settled	...a VCC refund has been authorized for clearing and completed
purchase.card.return.auth.reversal	...a VCC reversed a purchase return authorization
gpa.credit.authorization.reversal	...a VCC reversal authorization was approved. Not needed if a purchase.card.auth.reversal.cleared event exists for the same vcc. In some instances, no purchase.card.auth.reversal.cleared event is triggered so the gpa.credit.authorization.reversal needs to be considered
purchase.card.authorization.advice	...a VCC authorization amount needs to be overwritten with a new value.
purchase.card.auth.reversal.issuerexpiration	...a VCC authorization expires (after 7 days)

Purchase ACH Events

These events are triggered as ACH purchase transactions are created and processed.

Event	Triggered when...
purchase.ach.notyetprocessed	As soon as ACH purchases are picked up by the processor, they have a status of Not Yet Processed. Payments will remain in this status until their scheduled processing date.
purchase.ach.cancelled	The transaction has been canceled by the customer or the merchant
purchase.ach.processed	The transaction has been successfully processed
purchase.ach.pending	The immediate status when an ACH purchase is created.
purchase.ach.skipped	The transaction has been skipped because it is a part of a recurring payment series, and the series was placed on hold during the time the payment were to process. Not currently a live status for ConnexPay
purchase.ach.denied	The transaction has been denied by ConnexPay's ACH processor.
purchase.ach.returned	The transaction was processed, but then was returned by the bank.
purchase.ach.onhold	The transaction has been placed on hold for further review
purchase.ach.pendingpayment	The transaction is waiting on a payment method / funding source to continue
purchase.ach.pendingauthorization	The transaction is waiting on an authorization method to continue
purchase.ach.processing	The transaction is currently processing. ACH transactions are briefly in this status when the batches are processed each afternoon.
purchase.ach.declined	The ACH transaction has been declined by ConnexPay.
purchase.ach.return.pending	The immediate status when an ACH return transaction is created.
purchase.ach.return.notyetprocessed	As soon as ACH transactions are picked up by the processor, they have a status of Not Yet Processed.
purchase.ach.return.cancelled	The Purchase return has been canceled by the customer or the merchant
purchase.ach.return.processed	The transaction has been successfully processed
purchase.ach.return.skipped	The transaction has been skipped because it is a part of a recurring payment series, and the series was placed on hold during the time the payment were to process. Not currently a live status for ConnexPay
purchase.ach.return.denied	The transaction has been denied by ConnexPay's ACH processor.
purchase.ach.return.returned	The transaction was processed, but then was returned by the bank.
purchase.ach.return.onhold	The transaction has been placed on hold for further review
purchase.ach.return.pendingpayment	The transaction is waiting on a payment method / funding source to continue
purchase.ach.return.pendingauthorization	The transaction is waiting on an authorization method to continue
purchase.ach.return.processing	The transaction is currently processing. ACH transactions are briefly in this status when the batches are processed each afternoon.
purchase.ach.return.declined	The transaction has been denied by ConnexPay's ACH processor.