Coudre Bros. Payment API

Build and check the on-chain payments used to pay for minting or registration.

GitHub OpenAPI

Operations 2

POST /payment/prepare Build an unsigned mint-fee payment transaction #
GET /payment/status Check whether a payment transaction is confirmed on-chain #

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/coudrebros-eu:coudrebros-eu-payment-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.

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

OpenAPI Specification

coudrebros-eu-payment-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Coudrebros Eu Payment API
  version: 1.1.0
  contact:
    name: CoudreBros
    url: https://www.coudrebros.eu/
  description: 'Operations tagged payment across 2 of this provider''s published API definitions: coudrebros-eu-openapi.json, coudrebros-eu-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://nftapi.coudrebros.eu
  description: Cardano mainnet (per https://nftapi.coudrebros.eu/llms.txt)
- url: https://testnet.nftapi.coudrebros.eu
  description: Testnet instance serving the same spec
tags:
- name: Payment
  description: Build and check the on-chain payments used to pay for minting or registration.
paths:
  /payment/prepare:
    post:
      tags:
      - Payment
      summary: Build an unsigned mint-fee payment transaction
      description: 'Convenience endpoint for clients that hold their own Cardano signing keys (e.g. a CIP-30 browser wallet, or an agent with direct key access): builds an **unsigned** transaction that pays the mint fee from `from_address` to the operator, with change returned to `from_address`. The caller is responsible for signing and submitting it themselves -- this API never sees or holds private keys.


        This is entirely optional: you can build and send the payment on your own using any tool of your choice and skip this endpoint.'
      operationId: prepare_payment_payment_prepare_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PreparePaymentRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PreparePaymentResponse'
        '400':
          description: from_address has insufficient funds, or the underlying Cardano node is temporarily unreachable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintError'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintError'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintError'
        '422':
          description: Request body failed validation (e.g. malformed from_address).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintError'
  /payment/status:
    get:
      tags:
      - Payment
      summary: Check whether a payment transaction is confirmed on-chain
      description: Returns whether `tx` is currently visible as a confirmed, unspent UTxO at the operator's payment address. Submitting a transaction to the network does not mean it is confirmed yet -- poll this endpoint after paying and before calling `/mint` or `/register` with the same transaction hash, to avoid a premature "payment not found" error.
      operationId: payment_status_payment_status_get
      parameters:
      - name: tx
        in: query
        required: true
        schema:
          type: string
          description: Transaction hash to check
          title: Tx
        description: Transaction hash to check
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentStatusResponse'
        '400':
          description: The underlying Cardano node is temporarily unreachable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintError'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintError'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintError'
        '422':
          description: Missing or malformed 'tx' query parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintError'
components:
  schemas:
    MintError:
      properties:
        status:
          type: string
          const: error
          title: Status
          default: error
        message:
          type: string
          title: Message
          description: Human-readable explanation of what went wrong
      type: object
      required:
      - message
      title: MintError
    PaymentStatusResponse:
      properties:
        confirmed:
          type: boolean
          title: Confirmed
          description: True once the given payment transaction is visible as a confirmed UTxO on-chain
      type: object
      required:
      - confirmed
      title: PaymentStatusResponse
    PreparePaymentResponse:
      properties:
        unsigned_tx:
          type: string
          title: Unsigned Tx
          description: CBOR hex of the unsigned payment transaction, ready to sign
        amount_lovelace:
          type: integer
          title: Amount Lovelace
          description: Exact lovelace amount the transaction sends to the operator
        to_address:
          type: string
          title: To Address
          description: Operator's payment address the transaction pays to
        network_fee_lovelace:
          type: integer
          title: Network Fee Lovelace
          description: Cardano network fee for this transaction, deducted from the customer's own change, not from amount_lovelace
      type: object
      required:
      - unsigned_tx
      - amount_lovelace
      - to_address
      - network_fee_lovelace
      title: PreparePaymentResponse
    PreparePaymentRequest:
      properties:
        from_address:
          type: string
          pattern: ^addr1[a-z0-9]+$
          title: From Address
          description: Customer's Cardano address that will pay and receive the NFT. Must be a mainnet address (starts with 'addr1').
      type: object
      required:
      - from_address
      title: PreparePaymentRequest
      example:
        from_address: addr_test1vpgnsrdu30exj2kscypxt6x8vxj4aghnqd6qkyywhqp0jgqmsh7px
x-refined-from:
- coudrebros-eu-openapi.json
- coudrebros-eu-openapi.yml