Account state webhook

Allaria sends a notification to the partner's registered endpoint whenever the state of an account changes. The partner must implement this endpoint to receive these notifications.

The request is sent as an HTTP POST to the full URL the partner registered. The path is the partner's own — Allaria does not impose one:

POSTthe URL you registered

For example, a partner who registers https://api.partner.com/webhooks/allaria/account-state receives every notification there.

Registering your URL

Send the complete URL you want to receive notifications on to integraciones@allaria.com.ar, one per environment. There is no endpoint for this — the subscription is configured on Allaria's side.

If you want the request secured with an API key, say so in the same message. Until the URL is registered, no notification is sent and nothing fails visibly.

Request

Allaria sends this request to the partner. The partner must expose the endpoint and respond with a 2XX status code to acknowledge receipt.

Headers

Field	Type	Description
Content-Type	string	Always application/json
API key header	string	Only when you asked for API key security. The header name and the key are agreed when the URL is registered. Reject the request with 401 when it is missing or wrong.

Path Parameters

Not applicable.

Query Parameters

Not applicable.

Body

Field	Type	Description
type	string	Kind of holder the account belongs to. See Type values below.
taxId	string	Tax identifier (CUIT) of the holder. Digits only.
state	string	New state of the account. See State values below.
email	string	Email of the holder. Only sent when type is UnitHolder; absent otherwise.
accountNumber	string	The comitente of the account. See Account identifiers.

Type values

Value	Description
Individual	The account belongs to an individual.
LegalEntity	The account belongs to a legal entity.
UnitHolder	The account belongs to a unit holder (cuotapartista). The only type that includes email.

State values

Value	Description
aceptado	The account was accepted.
operativo	The account is operational.
bloqueado	The account is blocked.
detenido	The account is stopped.
rechazado	The account was rejected: it stayed under analysis past the allowed period (21 days) and was rejected automatically. It can be resumed later, in which case a new notification follows.

The state values are sent in Spanish, exactly as shown. A notification is sent on every state change, so the same state can arrive again if the account returns to it.

Example Payload

{
  "type": "UnitHolder",
  "taxId": "30712345841",
  "state": "operativo",
  "email": "empresa.segunda@example.com",
  "accountNumber": "263"
}

Response

The partner must respond with any 2XX status code to acknowledge receipt.

warning

Match each notification to your own record on accountNumber, and treat the latest state received as current.