Consultar el estado

Después del retorno, tu servidor confirma con el token si la inscripción quedó autorizada, es decir, si el tarjetahabiente completó el autopago en tu sitio.

Consultar

POST {URL_BASE}/restpatpass/v1/services/status

La petición se autentica con los headers Authorization y Commercecode, como se explica en Autenticación.

  • Name
    token
    Type
    string
    is Required
    REQUERIDO
    Description

    El token que recibiste al solicitar la inscripción y que PAR te devolvió en j_token.

Solicitud

POST
/restpatpass/v1/services/status
curl --request POST \
  --url '{URL_BASE}/restpatpass/v1/services/status' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: {TU_LLAVE_SECRETA}' \
  --header 'Commercecode: 1234567890' \
  --data '{"token": "{TOKEN}"}'

Respuesta

PAR responde 200 tanto si la inscripción quedó autorizada como si no:

Respuesta

{
  "authorized": true,
  "voucherUrl": "{URL_BASE}/nuevo-ic-rest/tokenVoucherLogin"
}
  • Name
    authorized
    Type
    boolean
    is Required
    REQUERIDO
    Description

    true si el tarjetahabiente inició la sesión con ese token y completó la inscripción de un autopago en el sitio de tu código de comercio.

  • Name
    voucherUrl
    Type
    string | null
    is Required
    REQUERIDO
    Description

    URL del comprobante del autopago. Solo viene cuando authorized es true.

authorized es false cuando el token no existe, todavía no se usó para iniciar sesión, fue revocado, pertenece a otro comercio o a otro sitio, o cuando el tarjetahabiente abandonó la inscripción sin completarla. PAR no distingue entre estos casos para no revelar información sobre tokens ajenos.

Consulta el estado cada vez que recibas un retorno, en lugar de suponer el resultado. Una vez autorizada, la inscripción no vuelve a quedar sin autorizar, salvo que Placetopay revoque la sesión.

authorized confirma que el autopago se inscribió, no su estado actual. Si tu sitio exige aprobar los autopagos, puede estar pendiente de aprobación; y el tarjetahabiente puede cancelarlo más adelante desde PAR sin que esta respuesta cambie.