Alliance Data Systems (Bread Financial Holdings) · Capability

Bread Classic Merchant — Transactions & Shipping

Bread Classic Merchant API — Transactions, Carts and Shipping. Covers the legacy bread-classic surface still documented at docs.breadpayments.com.

Bread Classic Merchant — Transactions & Shipping is a Naftiko capability published by Alliance Data Systems (Bread Financial Holdings), one of 4 capabilities the APIs.io network indexes for this provider. It bundles 3 operations across the POST and GET methods.

The capability includes 3 read-only operations and 3 state-changing operations. Lead operation: Bread Classic Create A Cart. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Bread Classic, Bread Financial, BNPL, Transactions, and Carts.

Run with Naftiko Bread ClassicBread FinancialBNPLTransactionsCartsShippingLegacy

What You Can Do

POST

Createcart —

/v1/carts

POST

Addtransactionshipping —

/v1/transactions/{transactionID}/shipping

GET

Gettransactionshipping —

/v1/transactions/{transactionID}/shipping

MCP Tools

bread-classic-create-cart

Bread Classic Create A Cart

bread-classic-get-cart

Bread Classic Get A Cart

read-only idempotent

bread-classic-get-transaction

Bread Classic Get A Transaction

read-only idempotent

bread-classic-update-transaction

Bread Classic Update A Transaction (authorize/cancel/settle/refund)

bread-classic-add-shipping

Bread Classic Add Transaction Shipping

bread-classic-get-shipping

Bread Classic Get Transaction Shipping

read-only idempotent

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: Bread Classic Merchant — Transactions & Shipping
  description: 'Bread Classic Merchant API — Transactions, Carts and Shipping. Covers the legacy bread-classic surface still documented at docs.breadpayments.com.'
  tags:
    - Bread Classic
    - Bread Financial
    - BNPL
    - Transactions
    - Carts
    - Shipping
    - Legacy
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
  - namespace: env
    keys:
      BREAD_LEGACY_TOKEN: BREAD_LEGACY_TOKEN
capability:
  consumes:
    - type: http
      namespace: bread-classic-transactions
      baseUri: https://api.breadpayments.com
      description: Bread Classic Merchant API consumer.
      resources:
        - name: carts
          path: /carts
          operations:
            - name: createCart
              method: POST
              description: Bread Classic Create A Cart
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: cart-id
          path: /carts/{cartID}
          operations:
            - name: getCart
              method: GET
              description: Bread Classic Get A Cart
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: transaction-id
          path: /transactions/{transactionID}
          operations:
            - name: getTransactionClassic
              method: GET
              description: Bread Classic Get A Transaction
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
            - name: updateTransactionClassic
              method: PUT
              description: Bread Classic Update A Transaction
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: transaction-id-shipping
          path: /transactions/{transactionID}/shipping
          operations:
            - name: addTransactionShipping
              method: POST
              description: Bread Classic Add Transaction Shipping
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
            - name: getTransactionShipping
              method: GET
              description: Bread Classic Get Transaction Shipping
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: bearer
        token: '{{env.BREAD_LEGACY_TOKEN}}'
  exposes:
    - type: rest
      namespace: bread-classic-transactions-rest
      port: 8080
      description: REST adapter for the legacy Bread Classic Merchant API.
      resources:
        - path: /v1/carts
          name: carts
          description: REST surface for Bread Classic carts.
          operations:
            - method: POST
              name: createCart
              call: bread-classic-transactions.createCart
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/transactions/{transactionID}/shipping
          name: transaction-id-shipping
          description: REST surface for transaction shipping.
          operations:
            - method: POST
              name: addTransactionShipping
              call: bread-classic-transactions.addTransactionShipping
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
            - method: GET
              name: getTransactionShipping
              call: bread-classic-transactions.getTransactionShipping
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: bread-classic-transactions-mcp
      port: 9090
      transport: http
      description: MCP adapter for Bread Classic Merchant API.
      tools:
        - name: bread-classic-create-cart
          description: Bread Classic Create A Cart
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: bread-classic-transactions.createCart
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-get-cart
          description: Bread Classic Get A Cart
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: bread-classic-transactions.getCart
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-get-transaction
          description: Bread Classic Get A Transaction
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: bread-classic-transactions.getTransactionClassic
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-update-transaction
          description: Bread Classic Update A Transaction (authorize/cancel/settle/refund)
          hints:
            readOnly: false
            destructive: true
            idempotent: false
          call: bread-classic-transactions.updateTransactionClassic
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-add-shipping
          description: Bread Classic Add Transaction Shipping
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: bread-classic-transactions.addTransactionShipping
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-get-shipping
          description: Bread Classic Get Transaction Shipping
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: bread-classic-transactions.getTransactionShipping
          outputParameters:
            - type: object
              mapping: $.