Notify

Freedom Pay sends this POST request to state_callback from Create.

It is sent when the profile is created (status = process) and every time the status changes.

The request is signed: check X-JWS-Signature with verify_jws / verifyJws from Invoice Overview, with the raw request body.

Answer with HTTP 2xx within 30 seconds; the response body is ignored.

The same notification can arrive more than once: process it by profile_id and status. If in doubt, check the profile with Info.

Notification flow

Result

Your answer	Meaning	Next step
HTTP `2xx` within 30 seconds	The notification is delivered.	—
Another HTTP code, no answer in 30 seconds, connection error	The notification is not delivered.	Freedom Pay sends it again in 30 seconds, up to 3 attempts in total.

Errors

Freedom Pay does not process the body of your answer: return HTTP 2xx once the notification is saved, even if your own processing fails later.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "profile_id": "9f8e7d6c5b4a39281706f5e4d3c2b1a0",
    "external_id": "sub1001",
    "type": "binance",
    "status": "active",
    "agreement_type": "on-demand",
    "expires_at": "2027-04-30T00:00:00+00:00",
    "created_at": "2026-10-30T08:48:47+00:00",
    "additional": {
        "scene_code": "SUBSCRIPTION"
    }
}

Notification flow#

Result#

Errors#

Request

Responses

Notification flow

Result

Errors