IPN triggers

Set IPN triggers

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.

Triggers

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.
SEPA refusal	COMPLETE	The 2Checkout system sends a notification when the payment processor sends a refusal date (min 1 day and max 42 days depending on refusal reason). The refusal date is the date when the notification is trigged.

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.

Related pages:

• Instant Payment Notification (IPN)

• IPN POST failure recovery process

• IPN parameters