> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/payin/recurring-payment/notification.md).

# Notification

Follow the [general IPN notifications guide](/reference/payin/notification.md) to receive our IPN notification messages. With recurring sub orders, we will also send the parameter `period` to specify the current period and `recurring_status` to specify the status of the recurring order.

#### Recurring Status <a href="#events" id="events"></a>

Whenever an event occurs, we will send you a notification in JSON format using HTTP POST to the notify\_url that you specified in the original request.

We will notify the following events associated with the recurring status:

| Event (Recurring Status) | Description                                         |
| ------------------------ | --------------------------------------------------- |
| ACTIVE                   | Subscription charge success.                        |
| CANCEL                   | Subscription cancelled.                             |
| PAST\_DUE                | Subscription charge failed, subscription cancelled. |
| CLOSE                    | Subscription ended.                                 |

#### Notification Example <a href="#notification-example" id="notification-example"></a>

{% hint style="warning" %}
The following notification is only an example. Different methods and statuses can have more or less parameters in the real notification. Please refer to what you received when testing.
{% endhint %}

```
Content-Type: application/json
Method: POST
Header: Pagsmile-Signature
Body:
{
	"period": "1",
	"amount": "124.99",
	"method": "CreditCard", //CreditCard, Wallet, or PIX
	"recurring_status": "ACTIVE", //One of ACTIVE, CANCEL, PAST_DUE, CLOSE
	"out_trade_no": "TEST20**********3521",
	"trade_status": "SUCCESS",
	"trade_no": "202509***********0078",
	"currency": "BRL",
	"out_request_no": "",
	"app_id": "175850********0945",
	"user": {
		  "buyer_id": "3437",
		  "ip": "2a*********a",
		  "username": "APRO"
	},
	"card": { //Only CreditCard methods return parameter "card" and the associated information.
		  "brand": "visa",
		  "card_no": "424242******4242",
		  "first_six_digits": "424242",
		  "holder": {
					"identification": {},
					"name": "APRO"
			},
			"issuer": "visa",
			"last_four_digits": "4242",
			"preserved": false,
			"valid_thru_month": "12",
			"valid_thru_year": "2025"
	},
	"timestamp": "1759140477"
}

```