---
title: "Update gateway score"
method: POST
path: "/update-gateway-score"
tags: ["Score Feedback"]
---

# Update gateway score

`POST /update-gateway-score`

Feed a transaction outcome back into the success-rate model. Call this after every transaction so the engine has accurate SR data for future routing decisions.

A `CHARGED` status increases the gateway's SR; failure statuses (`AUTHENTICATION_FAILED`, `AUTHORIZATION_FAILED`, etc.) decrease it.

## Request body

- UpdateGatewayScoreRequest
  - `merchantId` string, required
  - `gateway` string, required
  - `paymentId` string, required
  - `status` 'CHARGED' | 'AUTHENTICATION_FAILED' | 'AUTHORIZATION_FAILED' | 'JUSPAY_DECLINED' | 'FAILURE', required
  - `gatewayReferenceId` string
  - `enforceDynamicRoutingFailure` boolean

## Response `200`

Score updated

- UpdateScoreResponse
  - `message` string
  - `merchant_id` string
  - `gateway` string
  - `payment_id` string

## Changes

- **2026-04-25** `986e537b0455` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-04-10** `9618544de91a` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - the endpoint scheme security `BearerAuth` was removed from the API

[Change history](https://skmtc.dev/juspay/apis/decision-engine/changes/update-gateway-score/post.md)

---

[API](https://skmtc.dev/juspay/apis/decision-engine.md) · [All operations](https://skmtc.dev/juspay/apis/decision-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/juspay/apis/decision-engine/revisions/986e537b0455?raw)