Notification

Follow the general IPN notifications guide 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

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

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.

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"
}