Skip to main content

IPN triggers

Last updated: 17-Jan-2023
Rate this article:

Set IPN triggers and contents 

In your Control Panel account, navigate to Dashboard → Integrations → Webhooks and API and click on the IPN Settings tab. In the General IPN Settings section, under Triggers, select the events for which 2Checkout sends notifications.

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

IPN triggers

General

Trigger

ORDERSTATUS

Description

Pending orders

PENDING

Shopper places the order. 2Checkout is waiting for bank authorization.

 

PURCHASE_PENDING

Shopper places the order using a Purchase Order (PO). 2Checkout 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 2Checkout system / Orders under 2Checkout review

PENDING_APPROVAL

Order is waiting for the 2Checkout 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

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

 

PENDING_ORDER_APPROVAL

2Checkout 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

2Checkout 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

2Checkout marks the order as finished and fulfilled.

 

2Checkout can resend this notification when it generates invoices.

Order shipped (only for tangible products) PAYMENT_AUTHORIZED

You marked the order as shipped, and the delivery process has started.

2Checkout sends a notification to customers once orders are marked as shipped.

Refunds and chargebacks

Trigger

ORDERSTATUS

Description

Invalid orders

INVALID

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

Suspect orders

SUSPECT

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

Canceled orders

CANCELED

The 2Checkout system can send out notifications for:

  • eStore orders canceled by 2Checkout 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. 2Checkout details information about disputes in the CHARGEBACK_RESOLUTION and CHARGEBACK_REASON_CODE fields.

Chargeback closed / Invoice generated

COMPLETE

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

 

2Checkout can resend this notification when it generates chargeback invoices.

Reversed and refund orders

REVERSED

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

 

REFUND

2Checkout repays funds back to shoppers for Complete orders.

 

2Checkout 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 2Checkout 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

2Checkout fulfills partner orders.

Rate this article:

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo