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

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

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

...a VCC reversal authorization was approved

purchase.card.auth.reversal.pending

...a VCC chargeback reversal pending approval. Temporary transaction type.

purchase.card.refund.auth.reversal

...a VCC transaction is reversed when an auth succeeds but before the transaction is cleared

purchase.card.auth.reversal.issuerexpiration.cleared

...a VCC transaction reversal or dropped transaction due to elapsed time

purchase.card.refund.completed

...a VCC refunds successfully after clearing process has been completed

purchase.card.refund.auth.declined

...a VCC refund has been declined

purchase.card.refund.auth.approved

...a VCC refund has been authorized. Temporary state before completion.

purchase.card.refund.auth.clearing

...a VCC refund has been authorized for clearing and completed

purchase.card.refund.auth.reversal

...a VCC reversed a purchase return authorization

Purchase ACH Events

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

Event

Triggered when...

purchase.ach.pending

The immediate status when an ACH purchase is created.

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


Did this page help you?