> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peere.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Bank Intent Response

> Endpoint for banks to respond to billing intents and create customer decisions.



## OpenAPI

````yaml POST /v1/billing/intent-response
openapi: 3.1.0
info:
  title: Peere Network API
  description: >-
    Comprehensive API documentation for Peere Network's payment platform,
    including Merchant, Bank, and Provider APIs
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.peere.network
    description: Production server
  - url: https://sandbox-api.peere.network
    description: Sandbox server
security:
  - bearerAuth: []
tags:
  - name: Merchant - Account Operations
    description: Merchant account management operations
  - name: Merchant - Find Customer
    description: Customer discovery and lookup operations for merchants
  - name: Merchant - Billing & Payment Operations
    description: Billing and payment processing for merchants
  - name: Merchant - Recurring Billing
    description: Subscription and recurring payment management
  - name: Merchant - Customer Decisions
    description: Customer authorization and decision management
  - name: Merchant - Refund Management
    description: Refund processing and management
  - name: Merchant - Transaction Management
    description: Transaction history and details
  - name: Merchant - Balance & Financial Operations
    description: Balance inquiries and financial operations
  - name: Merchant - Shared Operations
    description: Common operations shared across merchant services
  - name: Bank - Account Operations
    description: Bank account management operations
  - name: Bank - Customer Management
    description: Customer management for banks
  - name: Bank - Customer Device Management
    description: Device linking and management for bank customers
  - name: Bank - Customer Billing & Subscriptions
    description: Billing and subscription management for bank customers
  - name: Bank - Transaction Management
    description: Transaction processing and history for banks
  - name: Bank - Balance & Financial Operations
    description: Balance and financial operations for banks
  - name: Provider - Provider Management
    description: Provider account and profile management
  - name: Provider - Merchant Management
    description: Merchant management for providers
  - name: Provider - Merchant Trust Management
    description: Trust and verification management for merchants
  - name: Provider - Find Customer
    description: Customer discovery operations for providers
  - name: Provider - Billing Operations
    description: Billing operations on behalf of merchants
  - name: Provider - Refund Management
    description: Refund management on behalf of merchants
  - name: Provider - Recurring Billing
    description: Recurring billing management for providers
  - name: Provider - Customer Decisions
    description: Customer decision management for providers
  - name: Provider - Transaction Management
    description: Transaction management for providers
  - name: Provider - Balance & Financial Operations
    description: Balance and financial operations for providers
  - name: Provider - Shared Operations
    description: Common operations for providers
paths:
  /v1/billing/intent-response:
    post:
      tags:
        - Bank - Customer Billing & Subscriptions
      summary: Bank Intent Response
      description: >-
        Endpoint for banks to respond to billing intents and create customer
        decisions
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                customerId:
                  type: string
                entityId:
                  type: string
                lookupID:
                  type: string
                customerDecision:
                  type: string
                  enum:
                    - approve_once
                    - approve_recurring
                    - deny
                    - suspended
                spendingLimits:
                  type: object
                  properties:
                    single:
                      type: number
                    daily:
                      type: number
                    weekly:
                      type: number
                    monthly:
                      type: number
                blockMerchant:
                  type: boolean
                reference:
                  type: string
              required:
                - customerId
                - entityId
                - lookupID
                - customerDecision
      responses:
        '201':
          description: Customer decision created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateCustomerDecisionResponse'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
components:
  schemas:
    CreateCustomerDecisionResponse:
      type: object
      properties:
        statusCode:
          type: integer
          example: 201
        success:
          type: boolean
          example: true
        message:
          type: string
          example: Customer decision created successfully
        customerDecisionId:
          type: string
        paymentID:
          type: string
    Error:
      type: object
      required:
        - statusCode
        - success
        - message
      properties:
        statusCode:
          type: integer
          example: 400
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Bad request
  responses:
    BadRequestError:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UnauthorizedError:
      description: Authentication required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````