subotiz-com

subotiz-com Refund API

The Refund API from subotiz-com — 2 operation(s) for refund.

GitHub OpenAPI

Operations 3

GET /api/v1/trades/{trade_id}/refunds List Refunds #
POST /api/v1/trades/{trade_id}/refunds Create Refund #
GET /api/v1/trades/{trade_id}/refunds/{refund_id} Get Refund #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/subotiz-com/openapi/subotiz-com-refund-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/subotiz-com/json-schema/subotiz-com-create-checkout-session-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/subotiz-com/json-schema/subotiz-com-create-price-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/subotiz-com/json-schema/subotiz-com-create-trade-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/subotiz-com/json-schema/subotiz-com-product-version-schema.json
📊
JSONSchema
https://artifacts.apis.io/subotiz-com/json-schema/subotiz-com-product-schema.json
📊
JSONSchema
https://artifacts.apis.io/subotiz-com/json-schema/subotiz-com-update-subscription-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/subotiz-com:subotiz-com-refund-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

subotiz-com-refund-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Subotiz Com Refund API
  version: 1.0.0
  description: 'Operations tagged Refund across 2 of this provider''s published API definitions: subotiz-com-openapi.yml, v1-en.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{api}.subotiz.com
  variables:
    api:
      default: api
security:
- sec0: []
tags:
- name: Refund
paths:
  /api/v1/trades/{trade_id}/refunds:
    get:
      tags:
      - Refund
      summary: List Refunds
      operationId: v1-refund-list-refund
      parameters:
      - name: trade_id
        in: path
        description: Trade ID
        required: true
        schema:
          type: string
      - name: refund_ids
        in: query
        description: Refund ID array, filter refunds whose IDs belong to this array
        schema:
          type: array
          items:
            type: string
      - name: refund_status
        in: query
        description: 'Refund status array, filter refunds whose status belong to this array

          - pending: Processing

          - failed: Refund failed

          - succeeded: Refund successful'
        schema:
          type: array
          items:
            type: string
      - name: starting_after
        in: query
        description: Cursor for pagination. `starting_after` is the object ID that defines your position in the list. For example, if you want to get the next page, you can use the last object's ID as the parameter value after getting the object list for the first time. Cannot be used together with `ending_before`
        schema:
          type: string
      - name: ending_before
        in: query
        description: Cursor for pagination. `ending_before` is the object ID that defines your position in the list. For example, if you want to get the previous page, you can use the first object's ID as the parameter value after getting the object list for the first time. Cannot be used together with `starting_after`
        schema:
          type: string
      - name: limit
        in: query
        description: 'Pagination parameter, number of items per page, default: 10, interface defaults to sorting by creation time in descending order. Limit: [1, 100]'
        schema:
          type: integer
          format: int32
      - name: created_at.gt
        in: query
        description: Minimum value to filter by (exclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')
        schema:
          type: string
      - name: created_at.gte
        in: query
        description: Minimum value to filter by (inclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')
        schema:
          type: string
      - name: created_at.lt
        in: query
        description: Maximum value to filter by (exclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')
        schema:
          type: string
      - name: created_at.lte
        in: query
        description: Maximum value to filter by (inclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')
        schema:
          type: string
      - $ref: '#/components/parameters/HeaderRequestID'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRefundResponse'
    post:
      tags:
      - Refund
      summary: Create Refund
      operationId: v1-refund-create-refund
      parameters:
      - name: trade_id
        in: path
        description: Trade ID
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/HeaderRequestID'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateRefundRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateRefundResponse'
    servers:
    - url: https://{api}.subotiz.com
      variables:
        api:
          default: api
  /api/v1/trades/{trade_id}/refunds/{refund_id}:
    get:
      tags:
      - Refund
      summary: Get Refund
      operationId: v1-refund-get-refund
      parameters:
      - name: trade_id
        in: path
        description: Trade ID
        required: true
        schema:
          type: string
      - name: refund_id
        in: path
        description: Refund ID
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/HeaderRequestID'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryRefundResponse'
    servers:
    - url: https://{api}.subotiz.com
      variables:
        api:
          default: api
components:
  schemas:
    ListRefundResponse_Data:
      type: object
      properties:
        has_more:
          type: boolean
          description: Whether there is more data
        list:
          type: array
          items:
            $ref: '#/components/schemas/Refund'
          description: Refund list
    CreateRefundResponse:
      type: object
      properties:
        code:
          type: string
          description: error code
        message:
          type: string
          description: error message
        data:
          $ref: '#/components/schemas/CreateRefundResponse_Data'
    Refund:
      type: object
      properties:
        refund_id:
          type: string
          description: Refund ID
        trade_id:
          type: string
          description: Trade ID
        currency:
          type: string
          description: Transaction currency corresponding to the amount, encoded according to ISO4217
        callback_url:
          type: string
          description: Webhook notification callback URL
        reason:
          type: string
          description: Refund reason
        refund_amount:
          type: string
          description: Refund amount
        refund_status:
          type: string
          description: 'Refund status

            - pending: Processing

            - failed: Refund failed

            - succeeded: Refund successful'
        metadata:
          type: object
          additionalProperties:
            type: string
          description: A set of key-value pairs that can be attached to an object, allowing you to store additional information in a structured format.
        failure_reason:
          allOf:
          - $ref: '#/components/schemas/FailureReason'
          description: Refund failure reason
        ref_arn:
          type: string
          description: Refund credential returned by the issuing bank
        finished_at:
          type: string
          description: Refund completion time
        item_refund_amount:
          type: string
          description: Item-side refund amount (numeric string)
        tax_refund_amount:
          type: string
          description: Tax-side refund amount (numeric string); for non-taxable refunds use "0"
    CreateRefundResponse_Data:
      type: object
      properties:
        refund_id:
          type: string
          description: Refund ID
        trade_id:
          type: string
          description: Trade ID
        currency:
          type: string
          description: Transaction currency corresponding to the amount, encoded according to ISO4217
        callback_url:
          type: string
          description: Webhook notification callback URL
        reason:
          type: string
          description: Refund reason
        refund_amount:
          type: string
          description: Refund amount
        refund_status:
          type: string
          description: 'Refund status

            - pending: Processing

            - failed: Refund failed

            - succeeded: Refund successful'
        metadata:
          type: object
          additionalProperties:
            type: string
          description: Metadata
        failure_reason:
          allOf:
          - $ref: '#/components/schemas/FailureReason'
          description: Refund failure reason
        ref_arn:
          type: string
          description: Refund credential returned by the issuing bank
        finished_at:
          type: string
          description: Refund completion time
        item_refund_amount:
          type: string
          description: Item-side refund amount (numeric string)
        tax_refund_amount:
          type: string
          description: Tax-side refund amount (numeric string); for non-taxable refunds use "0"
    CreateRefundRequest:
      required:
      - access_no
      - merchant_id
      - refund_amount
      - currency
      type: object
      properties:
        access_no:
          type: string
          description: Third-party access number
        merchant_id:
          type: string
          description: Merchant unique identifier
        reason:
          type: string
          description: Refund reason
        refund_amount:
          type: string
          description: Refund amount
        currency:
          type: string
          description: Currency
        metadata:
          type: object
          description: A set of key-value pairs that can be attached to an object, allowing you to store additional information in a structured format.
    QueryRefundResponse_Data:
      type: object
      properties:
        refund_id:
          type: string
          description: Refund ID
        trade_id:
          type: string
          description: Trade ID
        currency:
          type: string
          description: Transaction currency corresponding to the amount, encoded according to ISO4217
        callback_url:
          type: string
          description: Webhook notification callback URL
        reason:
          type: string
          description: Refund reason
        refund_amount:
          type: string
          description: Refund amount
        refund_status:
          type: string
          description: 'Refund status

            - pending: Processing

            - failed: Refund failed

            - succeeded: Refund successful'
        metadata:
          type: object
          additionalProperties:
            type: string
          description: A set of key-value pairs that can be attached to an object, allowing you to store additional information in a structured format.
        failure_reason:
          allOf:
          - $ref: '#/components/schemas/FailureReason'
          description: Refund failure reason
        ref_arn:
          type: string
          description: Refund credential returned by the issuing bank
        finished_at:
          type: string
          description: Refund completion time
        item_refund_amount:
          type: string
          description: Item-side refund amount (numeric string)
        tax_refund_amount:
          type: string
          description: Tax-side refund amount (numeric string); for non-taxable refunds use "0"
    QueryRefundResponse:
      type: object
      properties:
        code:
          type: string
          description: error code
        message:
          type: string
          description: error message
        data:
          $ref: '#/components/schemas/QueryRefundResponse_Data'
    ListRefundResponse:
      type: object
      properties:
        code:
          type: string
          description: error code
        message:
          type: string
          description: error message
        data:
          $ref: '#/components/schemas/ListRefundResponse_Data'
    FailureReason:
      type: object
      properties:
        code:
          type: string
          description: System returned transaction return code
        message:
          type: string
          description: System returned transaction return description
  parameters:
    HeaderRequestID:
      name: Request-Id
      in: header
      description: The unique identifier of the request
      required: true
      schema:
        type: string
        default: 008e3967-a1b5-48bb-be14-d5bff5092e61
  securitySchemes:
    sec0:
      type: http
      description: 'Bearer API Key authentication. Format: Authorization: Bearer {your_api_key}'
      scheme: bearer
x-refined-from:
- subotiz-com-openapi.yml
- v1-en.yaml