Ir al contenido

Obtener el certificado (PFX) — solo la primera vez

POST
/certificate_claim
curl --request POST \
--url https://dev-api.tsp.cl/firma_digital/dev/api/partners/v1/certificate_claim \
--header 'Content-Type: application/json' \
--header 'x-gw: <x-gw>' \
--data '{ "p_code": "example", "dni": "18925910-7", "pin": "example" }'

Genera y entrega el certificado de un código de compra que ya pasó por certificate_request (flujo B2C). Es de una sola vez: si el certificado ya fue reclamado, responde 201 sin volver a generarlo. No aplica a partners B2B, que reciben el certificado automáticamente en certificate_request.

Media typeapplication/json
object
p_code
required
string
dni
required
string
Example
18925910-7
pin
required

El mismo PIN enviado en certificate_request.

string
/^\d{4}$/

Certificado emitido y entregado.

Media typeapplication/json
object
success
boolean
data
object
p_code
string
certificate

PFX en base64.

string format: byte
validFrom
string format: date-time
validTo
string format: date-time
serialNumber
string
Example
{
"success": true
}

El certificado ya había sido reclamado antes — no se regenera. error: "ALREADY_ISSUED".

Hay una validación en curso sobre este código de compra — reintentar en unos segundos.

API Key inválida o ausente.

El código de compra no existe, o existe pero todavía no pasó por certificate_request (identidad no validada).

El RUT/PIN no coinciden con lo generado en certificate_request.