Skip to main content
knowledgecenter.avangate.com

IPN triggers

Set IPN triggers and contents 

Navigate to IPN settings under System settings. Select the events for which Avangate sends notifications from the list of options available under Notification Settings.

Instant Payment Notification (IPN) provides automatic notifications for orders from the Avangate system, based on the following list of triggers you control:

IPN triggers

General

Trigger

ORDERSTATUS

Description

Pending orders

PENDING

Shopper places the order. Avangate is waiting for bank authorization.

 

PURCHASE_PENDING

Shopper places the order using a Purchase Order (PO). Avangate approves the PO document and you also approve the PO document. Shopper has yet to finalize the payment.

 

Alternatively, you use the AutoApprove API flow and do not require a PO document but the shopper has yet to finalize the payment.

Orders waiting to be processed by Avangate system / Orders under Avangate review

PENDING_APPROVAL

Order is waiting for the Avangate system to process it or for anti-fraud review.

Authorized and approved orders (sent before electronic delivery)

PAYMENT_AUTHORIZED

The bank authorized the payment.

 

PAYMENT_RECEIVED

Avangate sends a notification when it receives payments for offline orders (e.g. Bank/Wire transfer) but only before fulfillment/delivery.

 

PENDING_ORDER_APPROVAL

Avangate sends this status for products/subscriptions configured with the “Requires delivery confirmation” setting.

Authorized and approved orders (sent after electronic delivery)

PAYMENT_AUTHORIZED

The bank authorized the payment.

  COMPLETE

Avangate marks the order as finished and fulfilled.

Order approved for delivery

PAYMENT_AUTHORIZED

You approved an order for fulfillment/delivery.

Completed orders / Invoice generated

COMPLETE

Avangate marks the order as finished and fulfilled.

 

Avangate can resend this notification when it generates invoices.

Refunds and chargebacks

Trigger

ORDERSTATUS

Description

Invalid orders

INVALID

Shopper provides invalid billing and/or delivery information. (Not available by default, contact Avangate directly to enable it)

Suspect orders

SUSPECT

The Avangate Risk department is reviewing the order for possible fraud. (Not available by default, contact Avangate directly to enable it)

Canceled orders

CANCELED

The Avangate system can send out notifications for:

  • eStore orders canceled by Avangate representatives (only for orders that are not authorized/paid, otherwise a reverse or refund action is required).
  • Partner (Channel Manager) orders canceled by you.
  • Purchase Orders not approved/submitted in due time

 

Chargeback open

COMPLETE

ORDERSTATUS is COMPLETE for chargebacks. Avangate details information about disputes in the CHARGEBACK_RESOLUTION and CHARGEBACK_REASON_CODE fields.

Chargeback closed / Invoice generated

COMPLETE

ORDERSTATUS is COMPLETE for chargebacks. Avangate details information about disputes in the CHARGEBACK_RESOLUTION and CHARGEBACK_REASON_CODE fields.

 

Avangate can resend this notification when it generates chargeback invoices.

Reversed and refund orders

REVERSED

Avangate reverses transactions and releases funds back to shoppers for Authorized payments that never reach the Complete status.

 

REFUND

Avangate repays funds back to shoppers for Complete orders.

 

Avangate can resend this notification when it generates refund invoices.

Purchase orders

Trigger

ORDERSTATUS

Description

Approved

PURCHASE_PENDING

You approve the PO document.

Rejected

CANCELED

You reject the PO document.

Completed

COMPLETE

Customer pays the PO.

Expired, not paid

CANCELED

You don’t approve nor reject the PO within time interval.

Canceled

CANCELED

You cancel the PO or Avangate cancels the order.

Channel manager

 

Trigger

ORDERSTATUS

Description

Pending approval orders from partners

PENDING

Resellers place order that await your approval.

Approved orders from partners

PENDING

You approve partner orders.

Delivered orders from partners

PENDING

Avangate fulfills partner orders.