Pinch Payments

Pinch Payments Merchant Financial Data API

The Merchant Financial Data API from Pinch Payments — 2 operation(s) for merchant financial data.

GitHub OpenAPI

Operations 2

GET /merchant-financial-data/current Get Current Merchant Financial Data #
POST /merchant-financial-data Save Merchant Financial Data #

Documentation

📖
Documentation
https://docs.getpinch.com.au/docs/pinch-payments-api-core-concepts
📖
APIReference
https://docs.getpinch.com.au/reference/things-to-know
📖
Documentation
https://docs.getpinch.com.au/docs/credit-card-payments
📖
APIReference
https://docs.getpinch.com.au/reference/realtime-payment
📖
APIReference
https://docs.getpinch.com.au/reference/save-payer
📖
Documentation
https://docs.getpinch.com.au/docs/payment-links
📖
APIReference
https://docs.getpinch.com.au/reference/create-payment-link
📖
Documentation
https://docs.getpinch.com.au/docs/managed-merchants
📖
APIReference
https://docs.getpinch.com.au/reference/create-managed-merchant
📖
Documentation
https://docs.getpinch.com.au/docs/webhooks
📖
APIReference
https://docs.getpinch.com.au/reference/create-or-update-webhook
📖
APIReference
https://docs.getpinch.com.au/reference/save-contact
📖
Documentation
https://docs.getpinch.com.au/docs/transfers-in-pinch-payments
📖
APIReference
https://docs.getpinch.com.au/reference/list-all-transfers
📖
Documentation
https://docs.getpinch.com.au/docs/compliance-process
📖
APIReference
https://docs.getpinch.com.au/reference/getcurrentmerchantfinancialdata
📖
Documentation
https://docs.getpinch.com.au/docs/application-authentication
📖
APIReference
https://docs.getpinch.com.au/reference/tokens

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/pinch-payments/refs/heads/main/openapi/pinch-payments-merchant-financial-data-api-openapi.yml

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/pinch-payments-merchant-financial-data-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 email required.

GitHub Google LinkedIn

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

OpenAPI Specification

pinch-payments-merchant-financial-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: pinch-api-merchant-financial-data Merchant Financial Data API
  version: '2020.1'
servers:
- url: https://api.getpinch.com.au/test
- url: https://api.getpinch.com.au/live
security:
- sec0: []
tags:
- name: Merchant Financial Data
paths:
  /merchant-financial-data/current:
    get:
      summary: Get Current Merchant Financial Data
      description: Returns the current (most recent) merchant financial data record
      operationId: getCurrentMerchantFinancialData
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  currency:
                    type: string
                    description: The currency code (e.g., AUD, USD)
                  totalAnnualBusinessTurnover:
                    type: integer
                    format: int64
                    nullable: true
                    description: Total annual business turnover amount
                  totalAnnualCardSales:
                    type: integer
                    format: int64
                    nullable: true
                    description: Total annual card sales amount
                  averageTicketOrSalesAmount:
                    type: integer
                    format: int64
                    nullable: true
                    description: Average ticket or sales amount
                  captureMethod:
                    type: string
                    description: The capture method (card-present or card-not-present)
                  isDepositRequired:
                    type: boolean
                    nullable: true
                    description: Indicates whether a deposit is required
                  depositPercentage:
                    type: number
                    format: double
                    nullable: true
                    description: The percentage of deposit required
                  averageDeliveryTimeframe:
                    type: integer
                    format: int32
                    nullable: true
                    description: Average delivery timeframe in days
                  hasRecurringTransactions:
                    type: boolean
                    nullable: true
                    description: Indicates whether the merchant has recurring transactions
                  motoPercentage:
                    type: number
                    format: double
                    nullable: true
                    description: Mail Order / Telephone Order percentage
                  inStorePercentage:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of in-store transactions
                  internetPercentage:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of internet transactions
                  percentageDeliveredIn0Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in 0 days
                  percentageDeliveredIn7Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in 7 days
                  percentageDeliveredIn14Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in 14 days
                  percentageDeliveredIn30Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in 30 days
                  percentageDeliveredInOver30Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in over 30 days
                  percentageMagSwiped:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of transactions using magnetic stripe (mag swiped)
                  percentageKeyedManually:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of transactions keyed manually
                  percentageChipEnabled:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of transactions using chip-enabled cards
      tags:
      - Merchant Financial Data
  /merchant-financial-data:
    post:
      summary: Save Merchant Financial Data
      description: Creates or updates merchant financial data
      operationId: saveMerchantFinancialData
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  nullable: true
                totalAnnualBusinessTurnover:
                  type: integer
                  format: int64
                  nullable: true
                totalAnnualCardSales:
                  type: integer
                  format: int64
                  nullable: true
                averageTicketOrSalesAmount:
                  type: integer
                  format: int64
                  nullable: true
                captureMethod:
                  type: string
                  nullable: true
                  description: Must be a valid CardPresence enum value
                isDepositRequired:
                  type: boolean
                  nullable: true
                depositPercentage:
                  type: number
                  format: double
                  nullable: true
                  description: Must be less than 1 (100%) when IsDepositRequired is true
                averageDeliveryTimeframe:
                  type: integer
                  format: int32
                  nullable: true
                  description: Must be ≤ 999
                hasRecurringTransactions:
                  type: boolean
                  nullable: true
                motoPercentage:
                  type: number
                  format: double
                  nullable: true
                  description: Mail Order / Telephone Order percentage. MotoPercentage + InStorePercentage + InternetPercentage must equal 1 (100%)
                inStorePercentage:
                  type: number
                  format: double
                  nullable: true
                  description: MotoPercentage + InStorePercentage + InternetPercentage must equal 1 (100%)
                internetPercentage:
                  type: number
                  format: double
                  nullable: true
                  description: MotoPercentage + InStorePercentage + InternetPercentage must equal 1 (100%)
                percentageDeliveredIn0Days:
                  type: number
                  format: double
                  nullable: true
                  description: All delivery percentages must sum to 1 (100%)
                percentageDeliveredIn7Days:
                  type: number
                  format: double
                  nullable: true
                  description: All delivery percentages must sum to 1 (100%)
                percentageDeliveredIn14Days:
                  type: number
                  format: double
                  nullable: true
                  description: All delivery percentages must sum to 1 (100%)
                percentageDeliveredIn30Days:
                  type: number
                  format: double
                  nullable: true
                  description: All delivery percentages must sum to 1 (100%)
                percentageDeliveredInOver30Days:
                  type: number
                  format: double
                  nullable: true
                  description: All delivery percentages must sum to 1 (100%)
                percentageMagSwiped:
                  type: number
                  format: double
                  nullable: true
                  description: All card entry percentages must sum to 1 (100%) or all be 0
                percentageKeyedManually:
                  type: number
                  format: double
                  nullable: true
                  description: All card entry percentages must sum to 1 (100%) or all be 0
                percentageChipEnabled:
                  type: number
                  format: double
                  nullable: true
                  description: All card entry percentages must sum to 1 (100%) or all be 0
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  currency:
                    type: string
                    description: The currency code (e.g., AUD, USD)
                  totalAnnualBusinessTurnover:
                    type: integer
                    format: int64
                    nullable: true
                    description: Total annual business turnover amount
                  totalAnnualCardSales:
                    type: integer
                    format: int64
                    nullable: true
                    description: Total annual card sales amount
                  averageTicketOrSalesAmount:
                    type: integer
                    format: int64
                    nullable: true
                    description: Average ticket or sales amount
                  captureMethod:
                    type: string
                    description: The capture method (card-present or card-not-present)
                  isDepositRequired:
                    type: boolean
                    nullable: true
                    description: Indicates whether a deposit is required
                  depositPercentage:
                    type: number
                    format: double
                    nullable: true
                    description: The percentage of deposit required
                  averageDeliveryTimeframe:
                    type: integer
                    format: int32
                    nullable: true
                    description: Average delivery timeframe in days
                  hasRecurringTransactions:
                    type: boolean
                    nullable: true
                    description: Indicates whether the merchant has recurring transactions
                  motoPercentage:
                    type: number
                    format: double
                    nullable: true
                    description: Mail Order / Telephone Order percentage
                  inStorePercentage:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of in-store transactions
                  internetPercentage:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of internet transactions
                  percentageDeliveredIn0Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in 0 days
                  percentageDeliveredIn7Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in 7 days
                  percentageDeliveredIn14Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in 14 days
                  percentageDeliveredIn30Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in 30 days
                  percentageDeliveredInOver30Days:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of goods/services delivered in over 30 days
                  percentageMagSwiped:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of transactions using magnetic stripe (mag swiped)
                  percentageKeyedManually:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of transactions keyed manually
                  percentageChipEnabled:
                    type: number
                    format: double
                    nullable: true
                    description: Percentage of transactions using chip-enabled cards
      tags:
      - Merchant Financial Data
components:
  securitySchemes:
    sec0:
      type: oauth2
      flows: {}