Autenticación - Alignet Integration Docs

Genera un Access Token usando tus credenciales client_id y client_secret.
Todos los endpoints requieren este token para ser consumidos.

POST /token

endpoint

Pre-Producción

https://auth.preprod.alignet.io/token

Producción

https://auth.alignet.io/token

Este endpoint sigue el flujo OAuth 2.0 client_credentials. Genera el token una vez y reutilízalo mientras siga vigente.

Scopes disponibles

Define los permisos asociados al token.

create:token

Obligatorio para generar tokens.

post:charges

Crear cargos y autorizaciones.

get:charges

Consultar transacciones.

delete:charges

Cancelar transacciones.

Request

Headers

Campo	Descripción	Valor	Tipo	Obligatorio
`Content-Type`	Formato del request	`application/json`	String	SI
`ALG-API-VERSION`	Versión del API	`1709847567`	String	SI

Content-Type: application/json
ALG-API-VERSION: 1709847567

Body

Campo	Descripción	Ejemplo	Tipo	Obligatorio
`action`	Acción a ejecutar	`authorize`	String	SI
`grant_type`	Método de autorización	`client_credentials`	String	SI
`audience`	URL base del API	`{{base_url}}`	String	SI
`client_id`	Identificador del cliente	Credencial	String	SI
`client_secret`	Secreto del cliente	Credencial	String	SI
`scope`	Permisos solicitados	`create:token post:charges`	String	SI

Ejemplo (JSON)

{
  "action": "authorize",
  "grant_type": "client_credentials",
  "audience": "{{base_url_del_ambiente}}",
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "scope": "create:token post:charges get:charges delete:charges"
}

Response

Body

Campo	Descripción	Tipo
`action`	Acción ejecutada	String
`success`	Resultado del proceso	Boolean
`access_token`	Token generado	String
`scope`	Permisos del token	String
`expires_in`	Tiempo de expiración (segundos)	Integer
`token_type`	Tipo de token (`Bearer`)	String
`authorization`	Metadata del flujo	Object

Ejemplo (JSON)

{
  "action": "authorize",
  "success": true,
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "scope": "create:token api-test:create:token",
  "expires_in": 8600,
  "token_type": "Bearer",
  "authorization": {
    "meta": {
      "status": {
        "code": "00",
        "message_ilgn": [
          {
            "locale": "es_PE",
            "value": "Access Token creado"
          }
        ]
      }
    }
  }
}

Usar el token en requests

Incluye el token en el header Authorization:

Authorization: Bearer {access_token}
Content-Type: application/json
ALG-API-VERSION: 1709847567

Buenas prácticas

Reutiliza el token mientras esté vigente.
No generes un token por cada transacción.
Renuévalo antes de su expiración.
Centraliza su gestión en backend.
Usa caché para optimizar rendimiento.
Controla concurrencia para evitar múltiples generaciones simultáneas.

Errores comunes

401 Unauthorized

Token inválido, expirado o no enviado correctamente en el header.

403 Forbidden

El token no tiene los scopes necesarios para el endpoint.

No expongas el Access Token en frontend, logs o herramientas sin enmascaramiento.

Siguiente paso

PayIn — Introducción

Aprende a crear tu primera transacción.

Pre-Producción

Producción

​Scopes disponibles

create:token

post:charges

get:charges

delete:charges

​Request

​Headers

​Body

​Ejemplo (JSON)

​Response

​Body

​Ejemplo (JSON)

​Usar el token en requests

​Buenas prácticas

​Errores comunes

401 Unauthorized

403 Forbidden

​Siguiente paso

PayIn — Introducción

Scopes disponibles

Request

Headers

Body

Ejemplo (JSON)

Response

Body

Ejemplo (JSON)

Usar el token en requests

Buenas prácticas

Errores comunes

Siguiente paso