> For the complete documentation index, see [llms.txt](https://docs.2checkout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.2checkout.com/2checkout-apis/2checkout-apis/webhooks/instant-payment-notification-ipn/ipn-parameters.md).

# IPN parameters

## Overview

Depending on your IPN settings, notifications contain all or a subset of the available parameters.

2Checkout sends IPN parameters exemplified in this article.

2Checkout continues to add new IPN parameters on an ongoing basis. To include additional information in the notifications, enable the new parameters in the IPN settings page, in your Merchant Control Panel.

Some parameters might behave differently depending on the payment method. For example, parameter MESSAGE\_TYPE behaves differently on the SEPA Direct debit flow, therefore the values for the parameters received are different than those in the table below. Parameter values for the Credit card flow: "ORDERSTATUS": "PAYMENT\_RECEIVED" / "MESSAGE\_TYPE": "APPROVED". Parameter values for the SEPA Direct debit flow: "ORDERSTATUS": "PAYMENT\_RECEIVED" / "MESSAGE\_TYPE": "PROCESSING".

## IPN Parameters

<table><thead><tr><th width="270">Parameter</th><th width="285">Description</th><th>Type/Length</th></tr></thead><tbody><tr><td>GIFT_ORDER</td><td>Allows shoppers to gift the subscription/product acquired to the recipient specified using the delivery details during the purchase process. Possible values:<br>- 0 – Not a gift order.<br>- 1 – Gift order. The subscription/product is a gift.</td><td>Integer/1</td></tr><tr><td>SALEDATE</td><td>Y-m-d H:i:s. The datetime stamp when shoppers place orders (e.g.: 2008-06-22 19:33:28) (e.g.: 2013-12-01 01:00:24)</td><td>String/19</td></tr><tr><td>PAYMENTDATE</td><td>Y-m-d H:i:s. The datetime stamp when payment processors authorize a transaction for an order 2Checkout approved (e.g.: 2008-06-22 14:30:24) (e.g.: 2013-12-01 01:00:24)</td><td>String/19</td></tr><tr><td>COMPLETE_DATE</td><td>Y-m-d H:i:s. The datetime stamp when orders reach Complete status (2Checkout received payments and marked the order as fulfilled, if necessary). (e.g.: 2008-06-22 14:41:30) (e.g.: 2013-12-01 01:00:24)</td><td>String/19</td></tr><tr><td>REFNO</td><td>Unique, system-generated 2Checkout order reference.</td><td>Integer/9</td></tr><tr><td>REFNOEXT</td><td>The order reference code (max. 100 chars) you control. You can attach an external reference number to orders during the purchase process.</td><td>String/100</td></tr><tr><td>SHOPPER_REFERENCE_NUMBER</td><td>The internal reference number your customers assign to orders during the checkout process. Customers using Purchase Orders (POs) as the payment method during the ordering process have the option of setting identifiers for their orders to track and manage purchases in their own system.</td><td>String/255</td></tr><tr><td>ORIGINAL_REFNOEXT</td><td>Available for subscription renewals. Array of REFNOEXT (the external order reference - max. 100 chars) values set for the initial orders when the subscriptions were first acquired.</td><td>String/100</td></tr><tr><td>ORDERNO</td><td>Order counter (numeric, incremental). Visible in your account in the <strong>Order search</strong> area.</td><td>Integer</td></tr><tr><td>ORDERSTATUS</td><td>Current order status. Possible values are:<br>• PENDING - Order placed, waiting bank authorization.<br>• PAYMENT_AUTHORIZED – The bank authorized the payment.<br>• SUSPECT – 2Checkout is reviewing the order having flagged it as a potential fraud attempt. <em>Note:</em> Not available by default. Contact 2Checkout directly to start receiving this order status.<br>• INVALID – Invalid Billing/Delivery information.<br>• COMPLETE – 2Checkout marked the order as complete.<br>• REFUND – 2Checkout refunded the money paid back to the shopper. 2Checkout can only refund complete orders.<br>• REVERSED – 2Checkout reversed a transaction and released the money back to the customer. 2Checkout can only reverse authorized orders that never reach the complete status.<br>• PURCHASE_PENDING – Sent for orders placed using <strong>Purchase Orders</strong> after you approve the PO. 2Checkout is waiting for the customer to make the payment.<br>• PAYMENT_RECEIVED – 2Checkout sends this notification when it received payment for orders with offline payment methods such as bank/wire transfer.<br>• CANCELED - The 2Checkout system sends out notifications when:<br>- 2Checkout representatives cancel eStore orders (only for orders that are not authorized/paid, otherwise a reverse or refund action is required).<br>- Partner (Channel Manager) orders you cancel yourself.<br>• PENDING_APPROVAL - 2Checkout has yet to approve this order.</td><td>String/22</td></tr><tr><td>PAYMETHOD</td><td>Order payment method.</td><td>String/255</td></tr><tr><td>PAYMETHOD_CODE</td><td>Payment method code. Possible values: (see table below)</td><td>String/250</td></tr><tr><td>CARD_TYPE</td><td>Shopper card type. When shoppers use multiple cards, 2Checkout includes the type of the last card used in the IPN - e.g. "Visa". Empty for non-card transactions.</td><td>String/255</td></tr><tr><td>CARD_LAST_DIGITS</td><td>The last 4 digits of the shopper credit/debit card. When shoppers use multiple cards, 2Checkout includes the last four digits of the last card used in the IPN - e.g. "Visa". Empty for non-card transactions.</td><td>String/4</td></tr><tr><td>CARD_EXPIRATION_DATE</td><td>MM/YY. Card expiration month and the year.</td><td>String/5</td></tr><tr><td>FX_RATE</td><td>Value of the exchange rate locked when the order reaches the Complete status. Includes the 2Checkout markup.</td><td>Float Number/100</td></tr><tr><td>FX_MARKUP</td><td>2Checkout exchange rate markup.</td><td>Float Number/100</td></tr><tr><td>PAYABLE_AMOUNT</td><td>Net profit in payout currency.</td><td>Float Number/100</td></tr><tr><td>PAYOUT_CURRENCY</td><td>Your account's default payout currency.</td><td>String/3</td></tr><tr><td>SHIPPING_TRACKING_NO</td><td>The tracking number requested as optional information when the order was marked as shipped.</td><td>String</td></tr><tr><td>SHIPPING_COMMENTS</td><td>Additional information requested as optional when the order was marked as shipped.</td><td>String</td></tr><tr><td>SHIPPING_TRACKING_URL</td><td>The Tracking URL defined when creating a shipping method.</td><td>String</td></tr><tr><td>SHIPPING_METHOD_NAME</td><td>Name of the shipping method used during the order.</td><td>String</td></tr><tr><td>SHIPPING_STATUS</td><td>Order shipment status. Possible values:<br>- TRUE - for shipped orders<br>- FALSE - for orders that are not shipped</td><td>String</td></tr><tr><td>CHARGEBACK_RESOLUTION</td><td>Chargeback status information. Possible values:<br>· OPEN (chargeback is in progress)<br>· WON (chargeback won by you)<br>· LOST (chargeback won by the customer)<br>· ACCEPTED (you agreed to repay the value of the order to the customer)<br>· NONE (no chargeback initiated for the order)<br>To manage chargeback notifications navigate to Control Panel Dashboard →Integrations → Webhooks and API, and click on the IPN settings tab: https://secure.avangate.com/cpanel/ipn_settings.php. In the <strong>General IPN Settings</strong> section, under <strong>Triggers</strong>, make sure to check the boxes next to the following options:<br>· chargeback open (2Checkout sends an IPN when shoppers open a chargeback dispute).<br>· chargeback closed - (2Checkout sends an IPN when the parties involved resolve a chargeback dispute).<br>Also, check the checkbox next to the <strong>CHARGEBACK_RESOLUTION</strong> parameter featured in the <strong>Response tags</strong> area.</td><td>String/8</td></tr><tr><td>CHARGEBACK_REASON_CODE</td><td>Identifier for the chargeback dispute reason from the 2Checkout system. Empty for orders with no chargeback dispute initiated. Possible values:<br>- MERCHANDISE_NOT_RECEIVED - Order not fulfilled/not delivered<br>- NOT_AS_DESCRIBED - Product(s) not as described/not functional<br>- DUPLICATE_TRANSACTION - Duplicate order<br>- FRAUD / NOT_RECOGNIZED - Fraud/Order not recognized<br>- CREDIT_NOT_PROCESSED - Agreed refund not processed<br>- NOT_RECOGNIZED - New/renewal order not recognized<br>- AUTHORIZATION_PROBLEM - Authorization problem<br>- INFO_REQUEST - Information request<br>- UNKNOWN - Unknown<br>- CANCELED_RECURRING - Recurring payment was canceled</td><td>String/24</td></tr><tr><td>TEST_ORDER</td><td>Possible values:<br>• 1 - for test orders<br>• 0 - for real orders</td><td>Integer/1</td></tr><tr><td>GATEWAY_RESPONSE</td><td>Forwards the payment gateway response received as a part of the card authorization process. Contact 2Checkout directly if the <strong>GATEWAY_RESPONSE</strong> parameter is not available in the list under the <strong>Notification Details</strong> area on the IPN settings page. Log into your Control Panel account and access this link to download a list of all gateway responses: https://secure.avangate.com/cpanel/help.php?view=resources&#x26;download=2Xrl83GnmbOBuXG1kb%2B2YQ%3D%3D</td><td>String/255</td></tr><tr><td>IPN_ORDER_ORIGIN</td><td>Source of the order placed. Possible values:<br>- Automatic Billing<br>- WEB<br>- Mobile<br>- API</td><td>String/17</td></tr><tr><td>REFUND_REASON</td><td>Refund reason. Possible values can be one of the refund reasons defined in the platform:<br>- Chargeback<br>- Duplicate order<br>- Not satisfied with the product<br>- Product not received<br>- Unwanted auto-renewal<br>- Technical issue with the product<br>- Other<br>- No reason<br>If you have set your own refund reasons, the value corresponds to the reasons selected in the refund process from your customized reasons. Click here to learn how to customize your refund reasons: https://verifone.cloud/docs/2checkout/Documentation/27Refunds_and_chargebacks/Refunds/</td><td>String</td></tr><tr><td>FRAUD_STATUS</td><td>Possible values:<br>- APPROVED for orders with a low fraud risk that passed the fraud screening.<br>- DENIED for orders with high score risk that were automatically rejected by the fraud engine.<br>- UNDER REVIEW for orders with a high fraud risk that require manual review and approval before the charge can be collected.<br>- PENDING for orders that are yet to enter the fraud screening.</td><td>String/12</td></tr><tr><td>MESSAGE_ID</td><td>The number generated incrementally for each sequence of message type sent to a seller.</td><td>Integer</td></tr><tr><td>MESSAGE_TYPE</td><td>The name of the event triggering the notification. See the MESSAGE_TYPE possible values table below.</td><td>String</td></tr><tr><td>VENDOR_CODE</td><td>Unique merchant identifier generated by the 2Checkout system.</td><td>String</td></tr><tr><td>PROPOSAL_ID</td><td>The unique identifier of the proposal generating the order. Can be found in Order additional information as text.</td><td>String</td></tr><tr><td>TAX_EXEMPT_ID</td><td>The tax exempt ID issued by 2Checkout.</td><td>String</td></tr><tr><td>TOTAL_REFUNDABLE_AMOUNT</td><td>The remaining order amount eligible for refund, calculated as the original order total minus any previously processed refunds.</td><td>Float Number/100</td></tr></tbody></table>

PAYMETHOD\_CODE possible values:

| Code               | Description                                |
| ------------------ | ------------------------------------------ |
| CCVISAMC           | Visa/MasterCard/Eurocard                   |
| WIRE               | Wire transfer                              |
| CCAMEX             | American Express                           |
| CCDINERS           | Diners Club                                |
| CCJCB              | JCB                                        |
| CC\_APPLE\_PAY     | Apple Pay                                  |
| PAYPAL             | PayPal                                     |
| VENDOR2VENDOR      | Vendor to vendor                           |
| PURCHASE\_ORDER    | Purchase order                             |
| DISCOVER           | Discover/Novus                             |
| CHECK              | Check                                      |
| DIRECT\_EBANKING   | DIRECTebanking.com                         |
| CARTE\_BLEUE       | Carte Bleue                                |
| FREE               | Payment not required                       |
| ALIPAY             | 支付宝 (Alipay)                               |
| DIRECT\_DEBIT      | Direct Debit                               |
| IDEAL              | iDEAL                                      |
| WEBMONEY           | Webmoney                                   |
| PAYNEARME          | Cash at 7-Eleven/Family Dollar/ACE         |
| WIRE\_ARMS\_RS     | Bank/Wire transfer - Channel Manager       |
| CCVISAMC\_ARMS\_RS | Visa/MasterCard/Eurocard - Channel Manager |
| CCAMEX\_ARMS\_RS   | American Express - Channel Manager         |
| PAYPAL\_ARMS\_RS   | PayPal - Channel Manager                   |
| CHECK\_ARMS\_RS    | Check - Channel Manager                    |
| BOLETO             | Boleto/Pix                                 |
| DANKORT            | Dankort                                    |
| ACH                | ACH                                        |
| CC\_INSTALLMENTS   | Installments                               |
| DIRECT\_DEBIT\_UK  | Direct Debit UK                            |
| UNIONPAY           | UnionPay                                   |
| TRIALPAY           | TrialPay Checkout                          |
| CCELO              | Elo Card                                   |
| CCHIPERCARD        | Hipercard                                  |
| OPPOHJOLA          | OP-Pohjola                                 |
| NORDEA             | Nordea                                     |
| DANSKE             | Danske                                     |
| TRUSTLY            | Trustly                                    |
| WE\_CHAT\_PAY      | WeChat Pay                                 |
| TRUSTPAY           | Trustpay                                   |
| SKRILL\_WALLET     | Skrill Wallet                              |
| NETELLER           | Neteller                                   |

CUSTOMER BILLING INFORMATION

| Field              | Type/Length                 |
| ------------------ | --------------------------- |
| FIRSTNAME          | Customer first name         |
| LASTNAME           | Customer last name          |
| COMPANY            | Company Name                |
| REGISTRATIONNUMBER | Company registration number |
| FISCALCODE         | Company VAT ID / Tax ID     |
| CBANKNAME          | Company bank name           |
| CBANKACCOUNT       | Company bank account        |
| ADDRESS1           | Address                     |
| ADDRESS2           | More address information    |
| CITY               | City                        |
| STATE              | State/County                |
| ZIPCODE            | Zip code                    |
| COUNTRY            | Country                     |
| COUNTRY\_CODE      | Country code                |
| PHONE              | Phone number                |
| FAX                | Fax number                  |
| CUSTOMEREMAIL      | Customer email address      |

CUSTOMER DELIVERY INFORMATION

| Field            | Type/Length                                |
| ---------------- | ------------------------------------------ |
| FIRSTNAME\_D     | First name                                 |
| LASTNAME\_D      | Last name                                  |
| COMPANY\_D       | Company name                               |
| ADDRESS1\_D      | Address                                    |
| ADDRESS2\_D      | Extra address information                  |
| CITY\_D          | City                                       |
| STATE\_D         | State/County                               |
| ZIPCODE\_D       | Zip code                                   |
| COUNTRY\_D       | Country                                    |
| COUNTRY\_D\_CODE | Country code                               |
| PHONE\_D         | Telephone number                           |
| EMAIL\_D         | Email address for delivery                 |
| IPADDRESS        | Customer IP address                        |
| IPCOUNTRY        | Country name, based on the user IP address |

CUSTOM ORDER INFORMATION (selected highlights)

| Parameter                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| TIMEZONE\_OFFSET                                                                                            | The time zone you selected or the default GMT+02:00 time zone of the 2Checkout system.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| CURRENCY                                                                                                    | Currency used in order. Possible values: USD, EUR, GBP. Depending on your account settings, other currencies might be available.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| CUSTOM\_PRICE                                                                                               | <p>Array of strings. Allows you to see how the custom price is calculated and is included in the IPN message you receive after an order. It contains variables such as Product ID, License code, TYPE (GROSS/NET/empty), SOURCE\_NAME, SOURCE\_TYPE, DISCOUNT\_VALUE, DISCOUNT\_TYPE (PERCENT/FIXED), DISCOUNT\_CURRENCY. Example:<br><code>apache\<br>\[CUSTOM\_PRICE] => Array\<br>(\<br>\[31029265] => Array\<br>(\<br>\[H17120HBAY] => Array\<br>(\<br>\[AMOUNT] => 80\<br>\[TYPE] => NET\<br>\[CURRENCY] => USD\<br>\[SOURCE\_NAME] => custom price regular\<br>\[SOURCE\_TYPE] => PROMOTION\<br>\[DISCOUNT\_VALUE] => 20\<br>\[DISCOUNT\_TYPE] => FIXED\<br>\[DISCOUNT\_CURRENCY] => USD\<br>)\<br>)\<br>)\<br></code></p> |
| LANGUAGE                                                                                                    | Payment interface language. Current possible values include: ar, bg, cs, da, de, el, en, es, fa, fi, fr, he, hi, hr, hu, it, ja, ko, nl, no, pl, pt, pt-br, ro, ru, sk, sl, sr, sv, th, tr, zh, zy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ORDERFLOW                                                                                                   | The type of ordering flow used for placing the order. Available values: PURCHASE\_ORDER, REGULAR.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| IPN\_PID\[] / IPN\_PNAME\[] / IPN\_PCODE\[] / IPN\_QTY\[] / IPN\_PRICE\[] / IPN\_VAT\[] / IPN\_VAT\_RATE\[] | Arrays describing products and pricing per-order line.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| IPN\_TOTALGENERAL                                                                                           | Total transacted sum, including shipping and VAT, using dot (.) as float separator, expressed in the same currency as the CURRENCY field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| IPN\_SHIPPING                                                                                               | Shipping costs, expressed in the same currency as the CURRENCY field, using dot (.) as float separator.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| IPN\_GLOBALDISCOUNT                                                                                         | Global order discount. Optional, sent only for values greater than 0.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| IPN\_COMMISSION                                                                                             | 2Checkout commission, using dot (.) as float separator.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| IPN\_CUSTOM\_TEXT\[] / IPN\_CUSTOM\_VALUE\[]                                                                | Custom fields set per order and corresponding client input.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| IPN\_PRODUCT\_OPTIONS\_1234\_\*                                                                             | Product option fields per product where 1234 represents the 2Checkout product ID. For usage scale pricing options groups, responses include units consumed (format examples provided in descriptions).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| IPN\_REFERRER                                                                                               | The last URL accessed by the shopper before landing in the 2Checkout cart.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| IPN\_LINK\_SOURCE                                                                                           | The link source for the sales. The SRC parameter used to track every sale point generator.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| IPN\_RESELLER\_ID / IPN\_RESELLER\_NAME / IPN\_RESELLER\_URL / IPN\_RESELLER\_COMMISSION                    | Affiliate/referrer information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| IPN\_LICENSE\_LIFETIME\[]                                                                                   | Array indicating products purchased with lifetime/evergreen option. Values: YES/NO.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| IPN\_PARTNER\_CODE                                                                                          | Empty = ecommerce order; otherwise partner code.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 2CHECKOUT\_CUSTOMER\_REFERENCE                                                                              | Default customer numerical (integer) IDs generated automatically by the 2Checkout system. See: <https://secure.2checkout.com/cpanel/ipn\\_settings.php>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| EXTERNAL\_CUSTOMER\_REFERENCE                                                                               | Unique customer alphanumeric (string) identifiers that you control. See: <https://secure.2checkout.com/cpanel/ipn\\_settings.php>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| REFUND\_TYPE                                                                                                | Describes refund type: TOTAL (entire sum) or PARTIAL (partial refund). Empty for non-refunds.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Various partner/margin/discount fields                                                                      | IPN\_PARTNER\_MARGIN\_PERCENT, IPN\_PARTNER\_MARGIN, IPN\_EXTRA\_MARGIN, IPN\_EXTRA\_DISCOUNT, IPN\_COUPON\_DISCOUNT, etc.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| IPN\_PROMOTION\_CATEGORY\[]                                                                                 | Array with the category of the promotions included in the order. Possible values: CROSS\_SELLING, UPSELL, PROMOTION.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

VALIDATION INFORMATION

| Field                          | Description                                                                                                                                                                                                |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| IPN\_DATE                      | IPN notification date in the YmdHis format. (ex: 20081117145935) (ex: 20131201010024)                                                                                                                      |
| HASH                           | Calculated HMAC\_MD5 signature based on the sent IPN fields and the secret key. (Note: This parameter won't be used anymore for IPN validation as of 15th of August, 2024.)                                |
| SIGNATURE\_SHA2\_256           | Calculated HMAC\_SHA2\_256 signature based on the sent IPN fields and the secret key.                                                                                                                      |
| SIGNATURE\_SHA3\_256           | Calculated HMAC\_SHA3\_256 signature based on the sent IPN fields and the secret key.                                                                                                                      |
| IPN\_PURCHASE\_ORDER\_INFO     | Order status and details for Purchase order acquisitions.                                                                                                                                                  |
| IPN\_ORIGINAL\_LINK\_SOURCE\[] | Array of IPN\_LINK\_SOURCE values for the initial orders when the subscriptions were first acquired. Available for subscription renewals.                                                                  |
| CUSTOM\_FIELDS                 | Additional order fields (dynamic variables). In your Merchant Control Panel, navigate to Setup - Ordering options - Additional order fields: <https://secure.2checkout.com/cpanel/additional\\_fields.php> |

MESSAGE\_TYPE possible values

| MESSAGE\_TYPE                          | Trigger name (according to Merchant Control Panel)                |
| -------------------------------------- | ----------------------------------------------------------------- |
| PENDING                                | Pending orders.                                                   |
| PROCESSING                             | Orders waiting to be processed by 2Checkout system.               |
| APPROVED                               | Authorized and approved orders (sent before electronic delivery). |
| AUTH                                   | Authorized and approved orders (sent after electronic delivery).  |
| APPROVED\_DELIVERY                     | Order approved for delivery.                                      |
| COMPLETE                               | Completed orders.                                                 |
| ORDER\_UNDER\_REVIEW                   | Orders under 2Checkout review.                                    |
| SHOPPER\_INVOICE                       | Invoice generated.                                                |
| SUSPECT                                | Fraud suspect.                                                    |
| CANCELED                               | Canceled orders.                                                  |
| CHARGEBACK\_OPEN                       | Chargeback open.                                                  |
| CHARGEBACK\_CLOSED                     | Chargeback closed.                                                |
| REFUND                                 | Reversed and refund orders.                                       |
| SEPA\_REFUSAL                          | Direct Debit payment refused.                                     |
| PURCHASE\_PENDING                      | Approved                                                          |
| PURCHASE\_REJECTED\_BY\_VENDOR         | Rejected                                                          |
| PURCHASE\_COMPLETE                     | Completed                                                         |
| PURCHASE\_EXPIRED\_NOT\_PAID           | Expired, not paid                                                 |
| PURCHASE\_CANCELED\_TIMEOUT            | Canceled                                                          |
| PENDING\_APPROVAL\_ORDER\_FOR\_PARTNER | Pending approval orders from partners.                            |
| VENDOR\_APPROVED                       | Approved orders from partners.                                    |
| DELIVERED\_ORDER\_FOR\_PARTNER         | Delivered orders from partners.                                   |

Related links

* [Instant Payment Notification (IPN)](https://verifone.cloud/docs/2checkout/API-Integration/Webhooks/06Instant_Payment_Notification_IPN)
* [IPN POST failure recovery process](https://verifone.cloud/docs/2checkout/API-Integration/Webhooks/06Instant_Payment_Notification_%2528IPN%2529/IPN-POST-failure-recovery-process)
* [Calculate the IPN HASH signature](https://verifone.cloud/docs/2checkout/API-Integration/Webhooks/06Instant_Payment_Notification_%2528IPN%2529/Calculate-the-IPN-HASH-signature)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.2checkout.com/2checkout-apis/2checkout-apis/webhooks/instant-payment-notification-ipn/ipn-parameters.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
