send21-io

send21-io Payment Requests API

The Payment Requests API from send21-io — 3 operation(s) for payment requests.

GitHub OpenAPI

Operations 4

POST /api/v1/payment-requests Create api payment requests #
GET /api/v1/payment-requests Get api payment requests #
GET /api/v1/payment-requests/{id} Get api payment requests by id #
POST /api/v1/payment-requests/{id}/cancel Create api payment requests by id cancel #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/send21-io/openapi/send21-io-payment-requests-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/send21-io/json-schema/send21-io-draft-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/send21-io/json-schema/send21-io-payment-request-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/send21-io/json-schema/send21-io-quote-info-schema.json
📊
JSONSchema
https://artifacts.apis.io/send21-io/json-schema/send21-io-create-draft-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/send21-io/json-schema/send21-io-fee-breakdown-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/send21-io/json-schema/send21-io-demo-draft-response-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/send21-io:send21-io-payment-requests-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

send21-io-payment-requests-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Send21 Io Payment Requests API
  version: v1
  contact:
    name: send21 integration support
    email: integration@send21.io
  description: 'Operations tagged PaymentRequests across 2 of this provider''s published API definitions: send21-io-openapi.json, swagger.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://send21.io
security:
- ApiKey: []
tags:
- name: Payment Requests
paths:
  /api/v1/payment-requests:
    post:
      tags:
      - Payment Requests
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePaymentRequestRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/CreatePaymentRequestRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/CreatePaymentRequestRequest'
      responses:
        '201':
          description: Created
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
      summary: Create api payment requests
      x-summary-source: derived
      operationId: postApiV1PaymentRequests
      x-operation-id-source: derived
    get:
      tags:
      - Payment Requests
      parameters:
      - name: orderId
        in: query
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PaymentRequestResponse'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PaymentRequestResponse'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PaymentRequestResponse'
      summary: Get api payment requests
      x-summary-source: derived
      operationId: getApiV1PaymentRequests
      x-operation-id-source: derived
    servers:
    - url: https://send21.io
  /api/v1/payment-requests/{id}:
    get:
      tags:
      - Payment Requests
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      summary: Get api payment requests by id
      x-summary-source: derived
      operationId: getApiV1PaymentRequestsById
      x-operation-id-source: derived
    servers:
    - url: https://send21.io
  /api/v1/payment-requests/{id}/cancel:
    post:
      tags:
      - Payment Requests
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/PaymentRequestResponse'
      summary: Create api payment requests by id cancel
      x-summary-source: derived
      operationId: postApiV1PaymentRequestsByIdCancel
      x-operation-id-source: derived
    servers:
    - url: https://send21.io
components:
  schemas:
    PaymentNetwork:
      enum:
      - Mainnet
      - Testnet4
      - Signet
      - Regtest
      - Solana
      - SolanaDevnet
      - Ethereum
      - EthereumSepolia
      - Base
      - BaseSepolia
      - Arbitrum
      - ArbitrumSepolia
      - Polygon
      - PolygonAmoy
      type: string
    PaymentMethod:
      enum:
      - MultiOutput
      - Lightning
      type: string
    ShortfallPolicyDto:
      type: object
      properties:
        absorbUpToPercent:
          type: number
          format: double
        absorbedBy:
          type:
          - string
          - 'null'
      additionalProperties: false
    PaymentRequestOptionDto:
      type: object
      properties:
        currency:
          $ref: '#/components/schemas/PaymentCurrency'
        network:
          $ref: '#/components/schemas/PaymentNetwork'
        address:
          type:
          - string
          - 'null'
        method:
          $ref: '#/components/schemas/PaymentMethod'
      additionalProperties: false
    DraftStatus:
      enum:
      - AwaitingPayment
      - Seen
      - Confirmed
      - Expired
      - Cancelled
      type: string
    PaymentRequestResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
        shareToken:
          type:
          - string
          - 'null'
        payPath:
          type:
          - string
          - 'null'
        orderId:
          type:
          - string
          - 'null'
        fiatCurrency:
          type:
          - string
          - 'null'
        fiatAmount:
          type: number
          format: double
        memo:
          type:
          - string
          - 'null'
        status:
          $ref: '#/components/schemas/PaymentRequestStatus'
        expiresAt:
          type: string
          format: date-time
        createdAt:
          type: string
          format: date-time
        options:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/PaymentRequestOptionDto'
        activeDraftId:
          type:
          - string
          - 'null'
          format: uuid
        draftStatus:
          $ref: '#/components/schemas/DraftStatus'
        fee:
          $ref: '#/components/schemas/PaymentRequestFeeInfo'
        amountMismatch:
          $ref: '#/components/schemas/AmountMismatchInfo'
        declineNote:
          type:
          - string
          - 'null'
        shortfallPolicy:
          $ref: '#/components/schemas/ShortfallPolicyDto'
        changeSignals:
          type:
          - array
          - 'null'
          items:
            type: string
        changeNotes:
          type:
          - array
          - 'null'
          items:
            type: string
        optionChangeSignals:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/OptionChangeSignalsInfo'
      additionalProperties: false
    PaymentRequestFeeInfo:
      type: object
      properties:
        percent:
          type:
          - number
          - 'null'
          format: double
        feeUsd:
          type:
          - number
          - 'null'
          format: double
        feeBaseUnits:
          type: integer
          format: int64
        feeAmount:
          type:
          - string
          - 'null'
        currency:
          type:
          - string
          - 'null'
        waived:
          type: boolean
        settledAt:
          type:
          - string
          - 'null'
          format: date-time
      additionalProperties: false
    ProblemDetails:
      type: object
      properties:
        type:
          type:
          - string
          - 'null'
        title:
          type:
          - string
          - 'null'
        status:
          type:
          - integer
          - 'null'
          format: int32
        detail:
          type:
          - string
          - 'null'
        instance:
          type:
          - string
          - 'null'
      additionalProperties: {}
    AmountMismatchInfo:
      type: object
      properties:
        txId:
          type:
          - string
          - 'null'
        expectedBaseUnits:
          type: integer
          format: int64
        receivedBaseUnits:
          type: integer
          format: int64
        differenceBaseUnits:
          type: integer
          format: int64
        receivedFormatted:
          type:
          - string
          - 'null'
        differenceFormatted:
          type:
          - string
          - 'null'
        confirmations:
          type: integer
          format: int32
        detectedAt:
          type: string
          format: date-time
        acceptedAt:
          type:
          - string
          - 'null'
          format: date-time
        acceptReason:
          type:
          - string
          - 'null'
        acceptedBy:
          type:
          - string
          - 'null'
        reviewState:
          type:
          - string
          - 'null'
        rejectedAt:
          type:
          - string
          - 'null'
          format: date-time
        rejectReason:
          type:
          - string
          - 'null'
        rejectedBy:
          type:
          - string
          - 'null'
        reviewReason:
          type:
          - string
          - 'null'
      additionalProperties: false
    PaymentRequestStatus:
      enum:
      - Open
      - Completed
      - Cancelled
      - Expired
      type: string
    PaymentCurrency:
      enum:
      - Btc
      - Usdc
      - Usdt
      - Eurc
      - Sol
      - Eth
      type: string
    OptionChangeSignalsInfo:
      type: object
      properties:
        currency:
          $ref: '#/components/schemas/PaymentCurrency'
        network:
          $ref: '#/components/schemas/PaymentNetwork'
        method:
          $ref: '#/components/schemas/PaymentMethod'
        signals:
          type:
          - array
          - 'null'
          items:
            type: string
        notes:
          type:
          - array
          - 'null'
          items:
            type: string
      additionalProperties: false
    CreatePaymentRequestRequest:
      type: object
      properties:
        fiatCurrency:
          type:
          - string
          - 'null'
        fiatAmount:
          type: number
          format: double
        options:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/PaymentRequestOptionDto'
        orderId:
          type:
          - string
          - 'null'
        memo:
          type:
          - string
          - 'null'
        expiryHours:
          type:
          - integer
          - 'null'
          format: int32
        declineNote:
          type:
          - string
          - 'null'
        shortfallPolicy:
          $ref: '#/components/schemas/ShortfallPolicyDto'
        reuseOpenForOrder:
          type:
          - boolean
          - 'null'
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: http
      description: 'AI-agent API key (Authorization: Bearer s21_...). Humans use passkey session cookies instead.'
      scheme: bearer
      bearerFormat: s21_...
x-refined-from:
- send21-io-openapi.json
- swagger.json