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/auraspay-com:auraspay-com-agent-checkout-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

openapi: 3.2.0
info:
  title: AurasPay Agent Checkout API
  version: 0.1.0
  description: Buyer-side x402 v2 checkout for existing AurasPay payment links. Base USDC only. Uses the custom auraspay-splitter-v1 scheme and external wallet signing.
servers:
- url: https://auraspay.com
tags:
- name: Agent Checkout
paths:
  /api/x402/payments/{publicId}:
    get:
      operationId: resolveOrSettlePaymentLink
      summary: Resolve an unpaid quote or settle it with x402 proof
      description: Without PAYMENT-SIGNATURE this returns the server-owned quote as HTTP 402. With PAYMENT-SIGNATURE it verifies the exact finalized splitter transaction. The amount and merchant are dynamic per existing AurasPay payment link.
      tags:
      - Agent Checkout
      parameters:
      - $ref: '#/components/parameters/PublicId'
      - $ref: '#/components/parameters/PaymentSignature'
      responses:
        '200':
          description: Payment already completed or newly settled
          headers:
            PAYMENT-RESPONSE:
              $ref: '#/components/headers/PaymentResponse'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentStatus'
        '202':
          description: Proof accepted for checking but finality or durable completion is pending
          headers:
            PAYMENT-RESPONSE:
              $ref: '#/components/headers/PaymentResponse'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PendingSettlement'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '410':
          $ref: '#/components/responses/Expired'
  /api/x402/payments/{publicId}/prepare:
    post:
      operationId: preparePayment
      summary: Prepare an exact unsigned Base USDC splitter transaction
      description: Returns existing AurasPay reset/approve/pay transaction steps. It never signs or broadcasts and never accepts private keys. humanApproved is trusted policy metadata from a buyer host; an external wallet remains the signing authority.
      tags:
      - Agent Checkout
      parameters:
      - $ref: '#/components/parameters/PublicId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrepareRequest'
      responses:
        '200':
          description: Unsigned exact transaction plan
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrepareResponse'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '410':
          $ref: '#/components/responses/Expired'
        '422':
          $ref: '#/components/responses/Invalid'
        '428':
          $ref: '#/components/responses/ApprovalRequired'
  /api/x402/payments/{publicId}/proof:
    post:
      operationId: submitPaymentProof
      summary: Submit PAYMENT-SIGNATURE for finalized verification
      tags:
      - Agent Checkout
      parameters:
      - $ref: '#/components/parameters/PublicId'
      - $ref: '#/components/parameters/RequiredPaymentSignature'
      responses:
        '200':
          description: Verified structured receipt
          headers:
            PAYMENT-RESPONSE:
              $ref: '#/components/headers/PaymentResponse'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentReceipt'
        '202':
          description: Awaiting finality or durable completion
          headers:
            PAYMENT-RESPONSE:
              $ref: '#/components/headers/PaymentResponse'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PendingSettlement'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
  /api/x402/payments/{publicId}/status:
    get:
      operationId: getPaymentStatus
      summary: Read authoritative payment status
      tags:
      - Agent Checkout
      parameters:
      - $ref: '#/components/parameters/PublicId'
      responses:
        '200':
          description: Current AurasPay status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentStatus'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    PaymentRequired:
      type: object
      additionalProperties: false
      required:
      - x402Version
      - resource
      - accepts
      - extensions
      properties:
        x402Version:
          const: 2
        error:
          type: string
        resource:
          type: object
          additionalProperties: false
          required:
          - url
          - description
          - mimeType
          properties:
            url:
              type: string
              format: uri
            description:
              type: string
            mimeType:
              const: application/json
        accepts:
          type: array
          minItems: 1
          maxItems: 1
          items:
            $ref: '#/components/schemas/PaymentRequirement'
        extensions:
          type: object
    PendingSettlement:
      type: object
      additionalProperties: false
      required:
      - completed
      - pending
      properties:
        completed:
          const: false
        pending:
          const: true
    PrepareRequest:
      type: object
      additionalProperties: false
      required:
      - account
      properties:
        account:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        purchaseType:
          type: string
          enum:
          - physical_goods
          - digital_goods
          - service
          - other
          default: physical_goods
        humanApproved:
          type: boolean
          default: false
        spendAuthorization:
          $ref: '#/components/schemas/SpendAuthorization'
      anyOf:
      - properties:
          humanApproved:
            const: true
        required:
        - humanApproved
      - required:
        - spendAuthorization
    PaymentReceipt:
      allOf:
      - $ref: '#/components/schemas/PaymentStatus'
      - type: object
        required:
        - receipt
        - idempotent
        properties:
          receipt:
            $ref: '#/components/schemas/SettlementResponse'
          idempotent:
            type: boolean
    TransactionStep:
      type: object
      additionalProperties: false
      required:
      - step
      - to
      - value
      - data
      - chainId
      properties:
        step:
          type: string
          enum:
          - reset
          - approve
          - pay
        to:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        value:
          const: '0'
        data:
          type: string
          pattern: ^0x[0-9a-fA-F]*$
        chainId:
          const: 8453
    SettlementResponse:
      type: object
      required:
      - success
      - transaction
      - network
      - payer
      properties:
        success:
          type: boolean
        transaction:
          type: string
        network:
          const: eip155:8453
        payer:
          type: string
        errorReason:
          type: string
    PaymentRequirement:
      type: object
      additionalProperties: false
      required:
      - scheme
      - network
      - amount
      - asset
      - payTo
      - maxTimeoutSeconds
      - extra
      properties:
        scheme:
          const: auraspay-splitter-v1
        network:
          const: eip155:8453
        amount:
          type: string
          pattern: ^[1-9][0-9]*$
          description: Exact Base USDC amount in atomic units
        asset:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        payTo:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          description: Reviewed AurasPay splitter contract, not the merchant wallet
        maxTimeoutSeconds:
          const: 900
        extra:
          type: object
          additionalProperties: false
          required:
          - paymentFlow
          - assetTransferMethod
          - merchant
          - platform
          - feeBps
          - paymentReference
          - publicId
          - nonce
          - expiresAt
          properties:
            paymentFlow:
              const: upfront
            assetTransferMethod:
              const: auraspay-splitter-v1
            merchant:
              type: string
              pattern: ^0x[0-9a-fA-F]{40}$
            platform:
              type: string
              pattern: ^0x[0-9a-fA-F]{40}$
            feeBps:
              const: 100
            paymentReference:
              type: string
              pattern: ^0x[0-9a-fA-F]{64}$
            publicId:
              type: string
              pattern: ^pay_[A-Za-z0-9_-]{22}$
            nonce:
              type: string
              pattern: ^0x[0-9a-fA-F]{64}$
            expiresAt:
              type: string
              format: date-time
    TransactionPlan:
      type: object
      required:
      - network
      - chainId
      - account
      - token
      - splitter
      - merchant
      - platform
      - amount
      - merchantAmount
      - platformAmount
      - reference
      - deadline
      - steps
      properties:
        network:
          const: base
        chainId:
          const: 8453
        account:
          type: string
        token:
          type: string
        splitter:
          type: string
        merchant:
          type: string
        platform:
          type: string
        amount:
          type: string
        merchantAmount:
          type: string
        platformAmount:
          type: string
        reference:
          type: string
        deadline:
          type: integer
        steps:
          type: array
          minItems: 1
          maxItems: 3
          items:
            $ref: '#/components/schemas/TransactionStep'
    Error:
      type: object
      additionalProperties: false
      required:
      - error
      - message
      properties:
        error:
          type: string
        message:
          type: string
    PrepareResponse:
      type: object
      required:
      - paymentRequired
      - transactionPlan
      - signing
      properties:
        paymentRequired:
          $ref: '#/components/schemas/PaymentRequired'
        transactionPlan:
          $ref: '#/components/schemas/TransactionPlan'
        signing:
          type: object
          required:
          - mode
          - privateKeysAccepted
          - unlimitedApprovalRequested
          - humanApproved
          - boundedPreAuthorizationUsed
          properties:
            mode:
              const: external-wallet-only
            privateKeysAccepted:
              const: false
            unlimitedApprovalRequested:
              const: false
            humanApproved:
              type: boolean
            boundedPreAuthorizationUsed:
              type: boolean
    SpendAuthorization:
      type: object
      additionalProperties: false
      required:
      - publicId
      - nonce
      - network
      - asset
      - payTo
      - maxAmountAtomic
      - expiresAt
      properties:
        publicId:
          type: string
          pattern: ^pay_[A-Za-z0-9_-]{22}$
        nonce:
          type: string
          pattern: ^0x[0-9a-fA-F]{64}$
        network:
          const: eip155:8453
        asset:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        payTo:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        maxAmountAtomic:
          type: string
          pattern: ^[1-9][0-9]*$
        expiresAt:
          type: string
          format: date-time
        allowPhysicalGoods:
          type: boolean
          default: false
    PaymentStatus:
      type: object
      required:
      - publicId
      - status
      - network
      - asset
      - amount
      - completed
      - transactionHash
      - verifiedAt
      - expiresAt
      properties:
        publicId:
          type: string
        status:
          type: string
          enum:
          - PENDING
          - EXPIRED
          - COMPLETED
        network:
          const: base
        asset:
          const: USDC
        amount:
          type: string
        completed:
          type: boolean
        transactionHash:
          type:
          - string
          - 'null'
        verifiedAt:
          type:
          - string
          - 'null'
          format: date-time
        expiresAt:
          type: string
          format: date-time
  headers:
    PaymentResponse:
      description: Base64 JSON x402 SettlementResponse.
      schema:
        type: string
        maxLength: 16384
        contentEncoding: base64
        contentMediaType: application/json
    PaymentRequired:
      description: Base64 JSON PaymentRequired using x402Version 2 and auraspay-splitter-v1.
      schema:
        type: string
        maxLength: 16384
        contentEncoding: base64
        contentMediaType: application/json
  responses:
    Expired:
      description: The unpaid quote has expired
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Feature unavailable, unsupported payment or unknown public ID
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ApprovalRequired:
      description: Human approval or matching bounded pre-authorization required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Conflict:
      description: Payment or transaction plan cannot be processed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Invalid:
      description: Invalid payer or purchase request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    PaymentRequired:
      description: Unpaid or invalid proof; inspect PAYMENT-REQUIRED
      headers:
        PAYMENT-REQUIRED:
          $ref: '#/components/headers/PaymentRequired'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PaymentRequired'
  parameters:
    PaymentSignature:
      name: PAYMENT-SIGNATURE
      in: header
      required: false
      description: Base64 JSON x402 v2 PaymentPayload. Scheme payload contains transactionHash, payer and the server-issued nonce.
      schema:
        type: string
        maxLength: 16384
        contentEncoding: base64
        contentMediaType: application/json
    RequiredPaymentSignature:
      name: PAYMENT-SIGNATURE
      in: header
      required: true
      description: Base64 JSON x402 v2 PaymentPayload. Scheme payload contains transactionHash, payer and the server-issued nonce.
      schema:
        type: string
        maxLength: 16384
        contentEncoding: base64
        contentMediaType: application/json
    PublicId:
      name: publicId
      in: path
      required: true
      schema:
        type: string
        pattern: ^pay_[A-Za-z0-9_-]{22}$