naftiko: 1.0.0-alpha2 info: label: Stripe Test Helpers API — Test Helpers description: 'Stripe Test Helpers API — Test Helpers. 31 operations. Lead operation: Test Helpers. Self-contained Naftiko capability covering one Stripe business surface.' tags: - Stripe - Test Helpers created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: STRIPE_API_KEY: STRIPE_API_KEY capability: consumes: - type: http namespace: test-helpers-test-helpers-2 baseUri: https://api.stripe.com description: Stripe Test Helpers API — Test Helpers business capability. Self-contained, no shared references. resources: - name: v1-test_helpers-customers-customer-fund_cash_balance path: /v1/test_helpers/customers/{customer}/fund_cash_balance operations: - name: posttesthelperscustomerscustomerfundcashbalance method: POST description:
Create an incoming testmode bank transfer
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: customer in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: v1-test_helpers-issuing-authorizations path: /v1/test_helpers/issuing/authorizations operations: - name: posttesthelpersissuingauthorizations method: POST description:Create a test-mode authorization.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: v1-test_helpers-issuing-authorizations-authorization-capture path: /v1/test_helpers/issuing/authorizations/{authorization}/capture operations: - name: posttesthelpersissuingauthorizationsauthorizationcapture method: POST description:Capture a test-mode authorization.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: authorization in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: v1-test_helpers-issuing-authorizations-authorization-expire path: /v1/test_helpers/issuing/authorizations/{authorization}/expire operations: - name: posttesthelpersissuingauthorizationsauthorizationexpire method: POST description:Expire a test-mode Authorization.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: authorization in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: v1-test_helpers-issuing-authorizations-authorization-increment path: /v1/test_helpers/issuing/authorizations/{authorization}/increment operations: - name: posttesthelpersissuingauthorizationsauthorizationincrement method: POST description:Increment a test-mode Authorization.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: authorization in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: v1-test_helpers-issuing-authorizations-authorization-reverse path: /v1/test_helpers/issuing/authorizations/{authorization}/reverse operations: - name: posttesthelpersissuingauthorizationsauthorizationreverse method: POST description:Reverse a test-mode Authorization.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: authorization in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: v1-test_helpers-issuing-cards-card-shipping-deliver path: /v1/test_helpers/issuing/cards/{card}/shipping/deliver operations: - name: posttesthelpersissuingcardscardshippingdeliver method: POST description:Updates the shipping status of the specified Issuing Card object to delivered.
Updates the shipping status of the specified Issuing Card object to failure.
Updates the shipping status of the specified Issuing Card object to returned.
Updates the shipping status of the specified Issuing Card object to shipped.
Allows the user to capture an arbitrary amount, also known as a forced capture.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: v1-test_helpers-issuing-transactions-create_unlinked_refund path: /v1/test_helpers/issuing/transactions/create_unlinked_refund operations: - name: posttesthelpersissuingtransactionscreateunlinkedrefund method: POST description:Allows the user to refund an arbitrary amount, also known as a unlinked refund.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: v1-test_helpers-issuing-transactions-transaction-refund path: /v1/test_helpers/issuing/transactions/{transaction}/refund operations: - name: posttesthelpersissuingtransactionstransactionrefund method: POST description:Refund a test-mode Transaction.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: transaction in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: v1-test_helpers-refunds-refund-expire path: /v1/test_helpers/refunds/{refund}/expire operations: - name: posttesthelpersrefundsrefundexpire method: POST description:Expire a refund with a status of requires_action.
Presents a payment method on a simulated reader. Can be used to simulate accepting a payment, saving a card or refunding a transaction.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: reader in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: v1-test_helpers-test_clocks path: /v1/test_helpers/test_clocks operations: - name: gettesthelperstestclocks method: GET description:Returns a list of your test clocks.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: ending_before in: query type: string description: A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 ob - name: expand in: query type: array description: Specifies which fields in the response should be expanded. - name: limit in: query type: integer description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. - name: starting_after in: query type: string description: A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 o - name: body in: body type: object description: Request body (JSON). required: false - name: posttesthelperstestclocks method: POST description:Creates a new test clock that can be attached to new customers and quotes.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: v1-test_helpers-test_clocks-test_clock path: /v1/test_helpers/test_clocks/{test_clock} operations: - name: deletetesthelperstestclockstestclock method: DELETE description:Deletes a test clock.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: test_clock in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: gettesthelperstestclockstestclock method: GET description:Retrieves a test clock.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: expand in: query type: array description: Specifies which fields in the response should be expanded. - name: test_clock in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: v1-test_helpers-test_clocks-test_clock-advance path: /v1/test_helpers/test_clocks/{test_clock}/advance operations: - name: posttesthelperstestclockstestclockadvance method: POST description:Starts advancing a test clock to a specified time in the future. Advancement is done when status changes
to Ready.
Transitions a test mode created InboundTransfer to the failed status. The InboundTransfer
must already be in the processing state.
Marks the test mode InboundTransfer object as returned and links the InboundTransfer to a ReceivedDebit.
The InboundTransfer must already be in the succeeded state.
Transitions a test mode created InboundTransfer to the succeeded status. The InboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundPayment to the failed status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundPayment to the posted status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundPayment to the returned status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the failed status. The OutboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the posted status. The OutboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the returned status. The OutboundTransfer
must already be in the processing state.
Use this endpoint to simulate a test mode ReceivedCredit initiated by a third party. In live mode, you can’t directly create ReceivedCredits initiated by third parties.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: v1-test_helpers-treasury-received_debits path: /v1/test_helpers/treasury/received_debits operations: - name: posttesthelperstreasuryreceiveddebits method: POST description:Use this endpoint to simulate a test mode ReceivedDebit initiated by a third party. In live mode, you can’t directly create ReceivedDebits initiated by third parties.
outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true authentication: type: bearer token: '{{env.STRIPE_API_KEY}}' exposes: - type: rest namespace: test-helpers-test-helpers-2-rest port: 8080 description: REST adapter for Stripe Test Helpers API — Test Helpers. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/v1/test-helpers/customers/{customer}/fund-cash-balance name: v1-test-helpers-customers-customer-fund-cash-balance description: REST surface for v1-test_helpers-customers-customer-fund_cash_balance. operations: - method: POST name: posttesthelperscustomerscustomerfundcashbalance description:Create an incoming testmode bank transfer
call: test-helpers-test-helpers-2.posttesthelperscustomerscustomerfundcashbalance with: customer: rest.customer body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/issuing/authorizations name: v1-test-helpers-issuing-authorizations description: REST surface for v1-test_helpers-issuing-authorizations. operations: - method: POST name: posttesthelpersissuingauthorizations description:Create a test-mode authorization.
call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizations with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/issuing/authorizations/{authorization}/capture name: v1-test-helpers-issuing-authorizations-authorization-capture description: REST surface for v1-test_helpers-issuing-authorizations-authorization-capture. operations: - method: POST name: posttesthelpersissuingauthorizationsauthorizationcapture description:Capture a test-mode authorization.
call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizationsauthorizationcapture with: authorization: rest.authorization body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/issuing/authorizations/{authorization}/expire name: v1-test-helpers-issuing-authorizations-authorization-expire description: REST surface for v1-test_helpers-issuing-authorizations-authorization-expire. operations: - method: POST name: posttesthelpersissuingauthorizationsauthorizationexpire description:Expire a test-mode Authorization.
call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizationsauthorizationexpire with: authorization: rest.authorization body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/issuing/authorizations/{authorization}/increment name: v1-test-helpers-issuing-authorizations-authorization-increment description: REST surface for v1-test_helpers-issuing-authorizations-authorization-increment. operations: - method: POST name: posttesthelpersissuingauthorizationsauthorizationincrement description:Increment a test-mode Authorization.
call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizationsauthorizationincrement with: authorization: rest.authorization body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/issuing/authorizations/{authorization}/reverse name: v1-test-helpers-issuing-authorizations-authorization-reverse description: REST surface for v1-test_helpers-issuing-authorizations-authorization-reverse. operations: - method: POST name: posttesthelpersissuingauthorizationsauthorizationreverse description:Reverse a test-mode Authorization.
call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizationsauthorizationreverse with: authorization: rest.authorization body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/issuing/cards/{card}/shipping/deliver name: v1-test-helpers-issuing-cards-card-shipping-deliver description: REST surface for v1-test_helpers-issuing-cards-card-shipping-deliver. operations: - method: POST name: posttesthelpersissuingcardscardshippingdeliver description:Updates the shipping status of the specified Issuing Card object to delivered.
Updates the shipping status of the specified Issuing Card object to failure.
Updates the shipping status of the specified Issuing Card object to returned.
Updates the shipping status of the specified Issuing Card object to shipped.
Allows the user to capture an arbitrary amount, also known as a forced capture.
call: test-helpers-test-helpers-2.posttesthelpersissuingtransactionscreateforcecapture with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/issuing/transactions/create-unlinked-refund name: v1-test-helpers-issuing-transactions-create-unlinked-refund description: REST surface for v1-test_helpers-issuing-transactions-create_unlinked_refund. operations: - method: POST name: posttesthelpersissuingtransactionscreateunlinkedrefund description:Allows the user to refund an arbitrary amount, also known as a unlinked refund.
call: test-helpers-test-helpers-2.posttesthelpersissuingtransactionscreateunlinkedrefund with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/issuing/transactions/{transaction}/refund name: v1-test-helpers-issuing-transactions-transaction-refund description: REST surface for v1-test_helpers-issuing-transactions-transaction-refund. operations: - method: POST name: posttesthelpersissuingtransactionstransactionrefund description:Refund a test-mode Transaction.
call: test-helpers-test-helpers-2.posttesthelpersissuingtransactionstransactionrefund with: transaction: rest.transaction body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/refunds/{refund}/expire name: v1-test-helpers-refunds-refund-expire description: REST surface for v1-test_helpers-refunds-refund-expire. operations: - method: POST name: posttesthelpersrefundsrefundexpire description:Expire a refund with a status of requires_action.
Presents a payment method on a simulated reader. Can be used to simulate accepting a payment, saving a card or refunding a transaction.
call: test-helpers-test-helpers-2.posttesthelpersterminalreadersreaderpresentpaymentmethod with: reader: rest.reader body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/test-clocks name: v1-test-helpers-test-clocks description: REST surface for v1-test_helpers-test_clocks. operations: - method: GET name: gettesthelperstestclocks description:Returns a list of your test clocks.
call: test-helpers-test-helpers-2.gettesthelperstestclocks with: ending_before: rest.ending_before expand: rest.expand limit: rest.limit starting_after: rest.starting_after body: rest.body outputParameters: - type: object mapping: $. - method: POST name: posttesthelperstestclocks description:Creates a new test clock that can be attached to new customers and quotes.
call: test-helpers-test-helpers-2.posttesthelperstestclocks with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/test-clocks/{test-clock} name: v1-test-helpers-test-clocks-test-clock description: REST surface for v1-test_helpers-test_clocks-test_clock. operations: - method: DELETE name: deletetesthelperstestclockstestclock description:Deletes a test clock.
call: test-helpers-test-helpers-2.deletetesthelperstestclockstestclock with: test_clock: rest.test_clock body: rest.body outputParameters: - type: object mapping: $. - method: GET name: gettesthelperstestclockstestclock description:Retrieves a test clock.
call: test-helpers-test-helpers-2.gettesthelperstestclockstestclock with: expand: rest.expand test_clock: rest.test_clock body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/test-clocks/{test-clock}/advance name: v1-test-helpers-test-clocks-test-clock-advance description: REST surface for v1-test_helpers-test_clocks-test_clock-advance. operations: - method: POST name: posttesthelperstestclockstestclockadvance description:Starts advancing a test clock to a specified time in the future. Advancement is done when status changes
to Ready.
Transitions a test mode created InboundTransfer to the failed status. The InboundTransfer
must already be in the processing state.
Marks the test mode InboundTransfer object as returned and links the InboundTransfer to a ReceivedDebit.
The InboundTransfer must already be in the succeeded state.
Transitions a test mode created InboundTransfer to the succeeded status. The InboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundPayment to the failed status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundPayment to the posted status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundPayment to the returned status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the failed status. The OutboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the posted status. The OutboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the returned status. The OutboundTransfer
must already be in the processing state.
Use this endpoint to simulate a test mode ReceivedCredit initiated by a third party. In live mode, you can’t directly create ReceivedCredits initiated by third parties.
call: test-helpers-test-helpers-2.posttesthelperstreasuryreceivedcredits with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v1/test-helpers/treasury/received-debits name: v1-test-helpers-treasury-received-debits description: REST surface for v1-test_helpers-treasury-received_debits. operations: - method: POST name: posttesthelperstreasuryreceiveddebits description:Use this endpoint to simulate a test mode ReceivedDebit initiated by a third party. In live mode, you can’t directly create ReceivedDebits initiated by third parties.
call: test-helpers-test-helpers-2.posttesthelperstreasuryreceiveddebits with: body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: test-helpers-test-helpers-2-mcp port: 9090 transport: http description: MCP adapter for Stripe Test Helpers API — Test Helpers. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: p-create-incoming-testmode-bank-transfer description:Create an incoming testmode bank transfer
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelperscustomerscustomerfundcashbalance with: customer: tools.customer body: tools.body outputParameters: - type: object mapping: $. - name: p-create-test-mode-authorization-p description:Create a test-mode authorization.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizations with: body: tools.body outputParameters: - type: object mapping: $. - name: p-capture-test-mode-authorization-p description:Capture a test-mode authorization.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizationsauthorizationcapture with: authorization: tools.authorization body: tools.body outputParameters: - type: object mapping: $. - name: p-expire-test-mode-authorization-p description:Expire a test-mode Authorization.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizationsauthorizationexpire with: authorization: tools.authorization body: tools.body outputParameters: - type: object mapping: $. - name: p-increment-test-mode-authorization-p description:Increment a test-mode Authorization.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizationsauthorizationincrement with: authorization: tools.authorization body: tools.body outputParameters: - type: object mapping: $. - name: p-reverse-test-mode-authorization-p description:Reverse a test-mode Authorization.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersissuingauthorizationsauthorizationreverse with: authorization: tools.authorization body: tools.body outputParameters: - type: object mapping: $. - name: p-updates-shipping-status-specified-issuing description:Updates the shipping status of the specified Issuing Card object to delivered.
Updates the shipping status of the specified Issuing Card object to failure.
Updates the shipping status of the specified Issuing Card object to returned.
Updates the shipping status of the specified Issuing Card object to shipped.
Allows the user to capture an arbitrary amount, also known as a forced capture.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersissuingtransactionscreateforcecapture with: body: tools.body outputParameters: - type: object mapping: $. - name: p-allows-user-refund-arbitrary-amount description:Allows the user to refund an arbitrary amount, also known as a unlinked refund.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersissuingtransactionscreateunlinkedrefund with: body: tools.body outputParameters: - type: object mapping: $. - name: p-refund-test-mode-transaction-p description:Refund a test-mode Transaction.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersissuingtransactionstransactionrefund with: transaction: tools.transaction body: tools.body outputParameters: - type: object mapping: $. - name: p-expire-refund-status-code-requires-action description:Expire a refund with a status of requires_action.
Presents a payment method on a simulated reader. Can be used to simulate accepting a payment, saving a card or refunding a transaction.
hints: readOnly: false destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelpersterminalreadersreaderpresentpaymentmethod with: reader: tools.reader body: tools.body outputParameters: - type: object mapping: $. - name: p-returns-list-your-test-clocks description:Returns a list of your test clocks.
hints: readOnly: true destructive: false idempotent: true call: test-helpers-test-helpers-2.gettesthelperstestclocks with: ending_before: tools.ending_before expand: tools.expand limit: tools.limit starting_after: tools.starting_after body: tools.body outputParameters: - type: object mapping: $. - name: p-creates-new-test-clock-that description:Creates a new test clock that can be attached to new customers and quotes.
hints: readOnly: true destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelperstestclocks with: body: tools.body outputParameters: - type: object mapping: $. - name: p-deletes-test-clock-p description:Deletes a test clock.
hints: readOnly: false destructive: true idempotent: true call: test-helpers-test-helpers-2.deletetesthelperstestclockstestclock with: test_clock: tools.test_clock body: tools.body outputParameters: - type: object mapping: $. - name: p-retrieves-test-clock-p description:Retrieves a test clock.
hints: readOnly: true destructive: false idempotent: true call: test-helpers-test-helpers-2.gettesthelperstestclockstestclock with: expand: tools.expand test_clock: tools.test_clock body: tools.body outputParameters: - type: object mapping: $. - name: p-starts-advancing-test-clock-specified description:Starts advancing a test clock to a specified time in the future. Advancement is done when status changes
to Ready.
Transitions a test mode created InboundTransfer to the failed status. The InboundTransfer
must already be in the processing state.
Marks the test mode InboundTransfer object as returned and links the InboundTransfer to a ReceivedDebit.
The InboundTransfer must already be in the succeeded state.
Transitions a test mode created InboundTransfer to the succeeded status. The InboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundPayment to the failed status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundPayment to the posted status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundPayment to the returned status. The OutboundPayment
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the failed status. The OutboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the posted status. The OutboundTransfer
must already be in the processing state.
Transitions a test mode created OutboundTransfer to the returned status. The OutboundTransfer
must already be in the processing state.
Use this endpoint to simulate a test mode ReceivedCredit initiated by a third party. In live mode, you can’t directly create ReceivedCredits initiated by third parties.
hints: readOnly: true destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelperstreasuryreceivedcredits with: body: tools.body outputParameters: - type: object mapping: $. - name: p-use-this-endpoint-simulate-test-2 description:Use this endpoint to simulate a test mode ReceivedDebit initiated by a third party. In live mode, you can’t directly create ReceivedDebits initiated by third parties.
hints: readOnly: true destructive: false idempotent: false call: test-helpers-test-helpers-2.posttesthelperstreasuryreceiveddebits with: body: tools.body outputParameters: - type: object mapping: $.