Plugins & SDKsReferencias APIAyudaForoReunión TécnicaFAQs
Referencias API

Token

post https://api-154.api-netpay.com/oauth-service/oauth/token

📘

Nota.

  • El access_token tiene una duración de 12 horas (43199 segundos). Después de que expire, se debe solicitar un nuevo Token. Actualmente no se recomienda utilizar el método refresh_token.
  • Las credenciales generadas deben mantenerse seguras en todo momento para evitar que alguien haga mal uso de tu cuenta. No compartas tus credenciales en lugares públicos ni por medios poco seguros.

2.3 Respuestas de la generación del Token

RespuestaDescripción
SUCCESSSe obtendrá la siguiente respuesta con un access_token y refresh_token válido si las credenciales enviadas han sido las correctas.
UNAUTHORIZEDSe obtendrá la siguiente respuesta si el {Auth_string} enviado está incorrecto o ha sido deshabilitado.
MISSING GRANT TYPESe obtendrá la siguiente respuesta si el {grant_type} no se ha enviado en la petición.
UNSUPPORTED GRANT TYPESe obtendrá la siguiente respuesta si el {grant_type} enviado en la petición es incorrecto.
INVALID USERNAME OR PASSWORDSe obtendrá la siguiente respuesta si el {username} o {password} enviado en la petición es incorrecto.
{
    "access_token": "CI6IkpXVCJ9wianReyJhdWQiOlsib2F1dGgyX2lkIl0sInVzZX",
    "token_type": "bearer",
    "refresh_token": "mlkLnJtei45NUBnbWFpbC5jb20iLCJzY6ImRhd_3yghIRLnew",
    "expires_in": 43199,
    "scope": "read write",
    "jti": "32116378-023b-9331-0920-ff1e2e200601"
}

{
    "timestamp": "2020-02-19T15:21:21.347+0000",
    "status": 401,
    "error": "Unauthorized",
    "message": "Unauthorized",
    "path": "/oauth/token"
}

{
    "error": "invalid_request",
    "error_description": "Missing grant type"
}

{
    "error": "unsupported_grant_type",
    "error_description": "Unsupported grant type: example"
}

{
    "error": "unauthorized",
    "error_description": "Invalid username or password."
}

📘

Nota.

Para este ejemplo el access_token y refresh_token se han recortado para efectos ilustrativos. En la práctica ambos tokens son de una longitud mayor variable.

Language