Inicio rápido de la API: desarrollo local
Ejecute una solicitud local de desembolso para inspeccionar el contrato y la política inicial. El ejemplo usa datos sintéticos y local-baseline, sin llamadas externas. La discrepancia de país devuelve review con puntuación 55; es un resultado de desarrollo, no una predicción de fraude.
Ejecutar el servicio local
Use Python 3.10 o superior, instale requirements.txt en un entorno virtual y ejecute uvicorn app.main:app --reload. Envíe el ejemplo a localhost:8000. La autenticación depende de la configuración local; incluya X-API-Key si existe una clave configurada. No envíe el ejemplo a un endpoint público o de piloto sin aprobación.
Leer el resultado
La solicitud declara MX y expected_country ID. local-baseline emite identifier_present=true y country_context_match=false. La política añade 45 por discrepancia y 10 por desembolso con puntuación no nula. Devuelve review, risk_score=55 y country_context_mismatch. Los identificadores y fechas varían en cada evaluación.
Siguiente paso de integración
Use la referencia de respuesta para separar decisiones de fallos HTTP. Para señales reales, delimite un adaptador aprobado, credenciales y datos permitidos con el equipo del piloto. La documentación no emite una clave de producción ni implica un sandbox real abierto.
Ejemplo sintético ejecutable
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn app.main:app --reload
# In another terminal:
curl http://localhost:8000/api/v1/decisions/payout \
-H "Content-Type: application/json" \
-d '{
"event": "payout",
"subject": {
"email": "person@example.com"
},
"context": {
"country": "MX",
"expected_country": "ID",
"consent_reference": "synthetic-test-1"
},
"providers": [
"local-baseline"
]
}'Campos seleccionados; se omiten traza, fechas, evidencia y nota.
{
"event": "payout",
"decision": "review",
"risk_score": 55,
"reason_codes": [
"country_context_mismatch"
],
"providers_used": [
"local-baseline"
]
}Fuentes y alcance
Basado en el contrato y código alfa. Las rutas reales requieren confirmación separada.