Registra o actualiza clientes externos y consulta su estado dentro de la integración. La identidad estable es la combinación de source y externalCustomerId.
customers:readcustomers:write
Operaciones
- Crear o actualizar
- Consultar
Envía
source, externalCustomerId, type y name. También puedes conservar email, phone, taxId, customerCode y metadata.El upsert es seguro para sincronizaciones periódicas: la misma identidad actualiza el cliente existente. El POST requiere Idempotency-Key, firma del request y Bearer.Identidad que no debe cambiar
1
Define un source estable
Usa el mismo identificador configurado al crear el partner. No lo cambies entre sincronizaciones.
2
Conserva el ID del sistema externo
externalCustomerId debe seguir apuntando a la misma persona o empresa durante toda su vida útil.3
Referencia esa identidad
Los documentos, links y pagos posteriores deben utilizar el mismo
customerExternalId.¿Por qué recibí 403?
¿Por qué recibí 403?
Verifica que la llave pertenezca al
companyId, que conserve el source autorizado y que tenga customers:read o customers:write según la operación.¿Por qué recibí 409?
¿Por qué recibí 409?
La identidad o la idempotencia entró en conflicto con una solicitud anterior. Busca el
requestId en Auditoría y compara el payload enviado.Abrir referencia de clientes
La referencia interactiva muestra cada campo, código HTTP y ejemplo ejecutable.