Confirmar instalación con código temporal

Se utiliza para confirmar la vinculación de una tienda particular con una aplicación determinada. Sólo confirmar una instalación cuando se haya identificado al usuario en su sistema y considerar que el código temporal es válido por 2 horas.


POST {env}/1/redeem-code

Headers


{
  "Authorization": "Bearer {access_token}"
}

Parámetro	Tipo	Requerido	Valores aceptados	Descripción
`Authorization`	string	Si	`Bearer` + access_token	Token obtenido mediante client_id y client_secret.

Body


{
  "code": "uuid string"
}

Parámetro	Tipo	Requerido	Valores aceptados	Descripción
`code`	string	Si	uuid	uuid obtenido en el query param “code” en la url de redirección cuando un usuario es redireccionado a la aplicación.

Response exitosa: 200 Ok


{
  "shop_id": "110111"
}

Campos de la respuesta

Atributo	Tipo	Descripción
`shop_id`	string	Corresponde al identificador de la tienda posteriormente requerido para hacer peticiones a diversos endpoints junto con el access token.

Responses de error

En caso de que la respuesta http no sea 200, entonces se debe considerar el error.

Atributo	Tipo	Descripción
`status`	int	Http code de respuesta.
`code`	string	Código de error, indica la naturaleza del mismo.
`msg`	string	Mensaje de error.

Ejemplo response 400 bad request cuando un authorization code es inexistente o ha expirado:


{
  "status": 400,
  "code": "bad request",
  "msg": "authorization code does not exist"
}

Ejemplo response 400 bad request cuando la cuenta de la tienda no está vinculada a tu aplicación:


{
  "status": 400,
  "code": "bad request",
  "msg": "invalid application_id"
}

En Stage, este error indica que la cuenta con la que se creó la tienda de prueba todavía no fue vinculada a tu application_id. Escribinos y la vinculamos.