> This is Payabli documentation. For a complete page index, fetch https://docs.payabli.com/llms.txt — append .md to any page URL for lightweight markdown. For section-level indexes, query parameters, and other AI-optimized access methods, see https://docs.payabli.com/ai-agents.md

# Bill Approved

POST 

Triggered when a bill is approved for payment.

Notification name: `billapproved`

Reference: https://docs.payabli.com/developers/webhooks/payout-bill-approved

## OpenAPI 3.1 Webhook Specification

```yaml
openapi: 3.1.0
info:
  title: webhooks-oas
  version: 1.0.0
paths: {}
webhooks:
  subpackage_payOutWebhooks.billApproved:
    post:
      operationId: subpackage_payOutWebhooks.billApproved
      summary: Bill Approved
      description: |-
        Triggered when a bill is approved for payment.

        Notification name: `billapproved`
      responses:
        '200':
          description: Webhook received successfully
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillApprovedContent'
components:
  schemas:
    BillApprovedContentApprovalsItems:
      type: object
      properties:
        ApproverId:
          type: integer
          description: The unique identifier for the approver
        ApproverName:
          type: string
          description: The approver's name
        ApprovalDate:
          type: string
          description: Timestamp of the approval decision
        Status:
          type: string
          description: Status value
      title: BillApprovedContentApprovalsItems
    BillApprovedContent:
      type: object
      properties:
        Event:
          type: string
          enum:
            - BillApproved
          description: Event type identifier
        Paypoint:
          type: string
          description: The name of the merchant/paypoint
        Text:
          type: string
          description: Human-readable description of the event
        InvoiceId:
          type: integer
          description: Unique bill/invoice identifier
        InvoiceNumber:
          type: string
          description: Bill/invoice number
        TotalAmount:
          type: string
          description: Total transaction amount including fees
        TransId:
          type: string
          description: Unique transaction identifier
        Method:
          type: string
          description: Payment processing method
        Approvals:
          type: array
          items:
            $ref: '#/components/schemas/BillApprovedContentApprovalsItems'
          description: List of approval records for the bill
        CustomerId:
          type: integer
          description: The unique identifier for the customer
        CustomerName:
          type: string
          description: The customer or vendor name
        CustomerNumber:
          type: string
          description: Internal customer identifier
        ExternalPaypointId:
          type: string
          description: External paypoint system identifier
        entryPoint:
          type: string
          description: System entry point identifier
      required:
        - Event
        - Paypoint
        - Text
        - InvoiceId
        - InvoiceNumber
        - TotalAmount
        - TransId
        - Method
        - Approvals
        - CustomerId
        - CustomerName
        - CustomerNumber
        - ExternalPaypointId
        - entryPoint
      title: BillApprovedContent

```