Utilice una marca de mensajería que pertenezca a la cuenta
Utilice una cuenta de API habilitada a través de HTTPS desde una dirección IP de origen permitida. Se admiten los métodos de autenticación Basic y Bearer. El identificador de marca debe pertenecer a esa cuenta. Mantenga privados los tokens del proveedor, los datos de identidad de la marca y los informes recibidos.
Utilice un resultado existente del proveedor
Utilice PUT para asociar a su marca un resultado de evaluación existente de un proveedor compatible. Esta operación no solicita una nueva evaluación. Obtenga directamente de ese proveedor el identificador correcto de la transacción y cualquier token de confirmación necesario, y asegúrese de que el informe corresponda a la misma identidad empresarial.
AUTHPLUS no admite este procedimiento de importación. Siguen aplicándose las reglas de coincidencia específicas del proveedor; una solicitud de importación no exime de cumplirlas ni garantiza la elegibilidad para todos los casos de uso de campañas.
Prepare la importación
| Campo | Valor |
|---|---|
| evpId | Identificador de un proveedor compatible, de 1–10 caracteres. |
| vettingId | El identificador real de la transacción de evaluación del proveedor, de hasta 255 caracteres. No lo sustituya por el identificador de marca ni invente un identificador. |
| vettingToken | Token de confirmación cuando el proveedor lo exija, de hasta 65535 caracteres. Trátelo como un secreto y omítalo cuando el proveedor no lo exija. |
Cree vetting-import.json con los valores reales del proveedor. No envíe campos de puntuación, estado o marca de tiempo que solo se incluyen en las respuestas como si pudieran cambiar el resultado.
Importe el resultado una sola vez
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Comprenda los cargos existentes
Este proxy no registra un resultado recién importado como una nueva solicitud de pago. Esto no cancela una evaluación solicitada anteriormente: cuando el mismo vettingId ya tiene una solicitud a la espera de un resultado o con un cobro pendiente, importar un resultado ACTIVE o FAILED puede liquidar la tarifa que tiene registrada. Esta rama de sincronización no vuelve a cobrar un registro que ya se haya cobrado.
Haga seguimiento del resultado real
Una respuesta HTTP satisfactoria puede contener un registro de evaluación pendiente. Conserve su vettingId y consulte vettingStatus, los motivos, la puntuación y las fechas de entrada en vigor y vencimiento, según estén disponibles. PENDING y UNSCORE requieren seguimiento adicional; ACTIVE, FAILED y EXPIRED describen resultados diferentes. La aceptación a nivel de HTTP por sí sola no demuestra una puntuación favorable ni la elegibilidad para campañas.
Utilice estado de la evaluación externa para hacer seguimiento del registro. Consultar o importar un resultado definitivo puede liquidar una solicitud de pago anterior; no implica necesariamente que no se aplique un cargo ya pendiente.
Reintente la misma solicitud prevista
Utilice una Idempotency-Key por cada operación prevista y conserve exactamente el método, la ruta, la consulta y los bytes del cuerpo. Las claves admiten 1–128 caracteres ASCII imprimibles sin espacios. Una solicitud duplicada mientras la original sigue en curso puede devolver 409 con Retry-After. Las solicitudes completadas vuelven a devolver su respuesta almacenada, incluidos los errores. Respete los límites de frecuencia de las solicitudes.
Un fallo de transporte puede dar lugar a un 502 almacenado en caché. Un 500 almacenado en caché con requestId puede significar que el registro aceptó la operación, pero falló el almacenamiento local o la facturación. Conserve el identificador de la solicitud, consulte los registros actuales y aclare las discrepancias con el equipo de soporte antes de utilizar una clave nueva. No dé por hecho que el error significa que no existe ninguna solicitud.