---
updatedAt: 2026-02-26T13:12:12.000Z
agentTools:
  projectIndex: https://docs.ksa.ngenius-payments.com/llms.txt
---

# Refund a Capture

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0",
    "title": "Transaction"
  },
  "x-samples-languages": [
    "node",
    "curl",
    "ruby",
    "javascript",
    "objectivec",
    "python",
    "java",
    "php",
    "csharp",
    "swift",
    "go"
  ],
  "paths": {
    "/outlets/{outletId}/orders/{orderRef}/payments/{paymentRef}/captures/{captureId}/refund": {
      "post": {
        "summary": "Refund a Capture",
        "description": "",
        "operationId": "refundCapture",
        "parameters": [
          {
            "name": "outletId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderRef",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "paymentRef",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "captureId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/vnd.ni-payment.v2+json": {
              "schema": {
                "$ref": "#/components/schemas/Amount"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "successful operation",
            "content": {
              "application/vnd.ni-payment.v2+json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api-gateway.sandbox.ksa.ngenius-payments.com/transactions"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "AuthResponseData": {
        "type": "object",
        "properties": {
          "authorizationCode": {
            "type": "string",
            "readOnly": true
          },
          "success": {
            "type": "boolean",
            "readOnly": true
          },
          "resultCode": {
            "type": "string",
            "readOnly": true
          },
          "resultMessage": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "CaptureData": {
        "type": "object",
        "properties": {
          "amount": {
            "$ref": "#/components/schemas/Money"
          }
        }
      },
      "Money": {
        "type": "object",
        "properties": {
          "currencyCode": {
            "type": "string"
          },
          "value": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "Payment3DsData": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "readOnly": true
          },
          "acsUrl": {
            "type": "string",
            "readOnly": true
          },
          "acsPaReq": {
            "type": "string",
            "readOnly": true
          },
          "acsMd": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "PaymentMethod": {
        "type": "object"
      },
      "PaymentResponse": {
        "type": "object",
        "properties": {
          "reference": {
            "type": "string"
          },
          "paymentMethod": {
            "$ref": "#/components/schemas/PaymentMethod"
          },
          "savedCard": {
            "$ref": "#/components/schemas/SavedCard"
          },
          "state": {
            "type": "string",
            "readOnly": true
          },
          "amount": {
            "$ref": "#/components/schemas/Money"
          },
          "updateDateTime": {
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "outletId": {
            "type": "string",
            "readOnly": true
          },
          "orderReference": {
            "type": "string",
            "readOnly": true
          },
          "merchantOrderReference": {
            "type": "string",
            "readOnly": true
          },
          "captureData": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CaptureData"
            }
          },
          "refundData": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RefundData"
            }
          },
          "cancellable": {
            "type": "boolean"
          },
          "availablePaymentMethods": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "displaySavedCard": {
            "type": "boolean"
          },
          "acceptResultLink": {
            "type": "boolean"
          },
          "is3dsRequired": {
            "type": "boolean"
          },
          "capturable": {
            "type": "boolean"
          },
          "authResponse": {
            "$ref": "#/components/schemas/AuthResponseData"
          },
          "3ds": {
            "$ref": "#/components/schemas/Payment3DsData"
          }
        }
      },
      "RefundData": {
        "type": "object",
        "properties": {
          "amount": {
            "$ref": "#/components/schemas/Money"
          },
          "createdTime": {
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "state": {
            "type": "string",
            "readOnly": true
          },
          "voidable": {
            "type": "boolean"
          }
        }
      },
      "SavedCard": {
        "type": "object",
        "required": [
          "cardToken",
          "cardholderName",
          "expiry",
          "maskedPan",
          "scheme"
        ],
        "properties": {
          "maskedPan": {
            "type": "string"
          },
          "expiry": {
            "type": "string",
            "pattern": "yyyy-MM"
          },
          "cardholderName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "scheme": {
            "type": "string",
            "enum": [
              "VISA",
              "MASTERCARD",
              "DINERS_CLUB_INTERNATIONAL",
              "AMERICAN_EXPRESS",
              "DISCOVER",
              "JCB"
            ]
          },
          "cardToken": {
            "type": "string"
          }
        }
      },
      "Amount": {
        "type": "object",
        "properties": {
          "amount": {
            "$ref": "#/components/schemas/Money"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  }
}
```