IPN triggers
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:
|
| 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. |
