Autenticación

Genera un Access Token para autenticar requests a la API de Pay-me.

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.