Purchase Events

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

PropertyDescription
idUnique identifier of event
subjectUnique merchant GUID
dataContains several data fields about the event.
You can find examples of the Purchase Card events here
and the Purchase Transaction events here
eventTypeType of event
eventTimeTime of event
dataVersionCurrent schema version

Purchase Card Events

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

EventTriggered 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.

EventTriggered 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 chargeback reversal pending approval. Temporary transaction type.
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.

EventTriggered when...
purchase.ach.notyetprocessedAs 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.cancelledThe transaction has been canceled by the customer or the merchant
purchase.ach.processedThe transaction has been successfully processed
purchase.ach.pendingThe immediate status when an ACH purchase is created.
purchase.ach.skippedThe 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.deniedThe transaction has been denied by ConnexPay's ACH processor.
purchase.ach.returnedThe transaction was processed, but then was returned by the bank.
purchase.ach.onholdThe transaction has been placed on hold for further review
purchase.ach.pendingpaymentThe transaction is waiting on a payment method / funding source to continue
purchase.ach.pendingauthorizationThe transaction is waiting on an authorization method to continue
purchase.ach.processingThe transaction is currently processing. ACH transactions are briefly in this status when the batches are processed each afternoon.
purchase.ach.declinedThe ACH transaction has been declined by ConnexPay.
purchase.ach.return.pendingThe immediate status when an ACH return transaction is created.
purchase.ach.return.notyetprocessedAs soon as ACH transactions are picked up by the processor, they have a status of Not Yet Processed.
purchase.ach.return.cancelledThe Purchase return has been canceled by the customer or the merchant
purchase.ach.return.processedThe transaction has been successfully processed
purchase.ach.return.skippedThe 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.deniedThe transaction has been denied by ConnexPay's ACH processor.
purchase.ach.return.returnedThe transaction was processed, but then was returned by the bank.
purchase.ach.return.onholdThe transaction has been placed on hold for further review
purchase.ach.return.pendingpaymentThe transaction is waiting on a payment method / funding source to continue
purchase.ach.return.pendingauthorizationThe transaction is waiting on an authorization method to continue
purchase.ach.return.processingThe transaction is currently processing. ACH transactions are briefly in this status when the batches are processed each afternoon.
purchase.ach.return.declinedThe transaction has been denied by ConnexPay's ACH processor.