1. Notifications Structure
Payflow API
Spain
  • Spain
  • Colombia
  • Peru
  • Guides
    • API Integration guide
  • Definitions
    • Employees
      • Employee Statuses
      • Salary Concepts
    • Payments
      • Payment Lifecycle
  • Explore our Public API
    • Auth & Health
      • Health
      • Test an API Key
    • Company
      • Retrieve your Company Details
    • Employee
      • Retrieve an Employee
      • Retrieve all Employees
      • Retrieve all Employees (V1.1)
      • Create an Employee
      • Upsert Employees in Bulk
      • Update an Employee by Personal ID
      • Update an Employee by Payflow ID
      • Update an Employee by Payroll ID
    • Leaves
      • Retrieve all Employees on Leave
      • Create an Employee Leave
      • Remove an Employee Leave
    • Payments
      • Retrieve a Payment
      • Retrieve all Payments
      • Retrieve Employee Payments
      • Calculate Employee Available Amount
      • Request a Payment
      • Subscribe to Payment Updates
      • Mark Payments as Informed
    • Flexflow
      • Retrieve all Flexflow Transactions
      • Retrieve Employee Flexflow Transactions
  • Notifications Structure
    • Payment Updates
  • Schemas
    • Company
      • Company Response
    • Employee
      • ES | Create Employee Request
      • ES | Update Employee Request
      • ES | Employee Response
      • Create Employee Leave Request
    • Payment
      • Payment Response
      • Payment Response Convoluted
      • Payment Update
    • Flexflow
      • Employee Flexflow Transactions
    • Error
      • Generic Error Response
  1. Notifications Structure

Payment Updates

Payflow sends webhook notifications to the configured URL whenever a payment changes status.
Each notification contains the updated payment information, including the payment identifier, employee identifier, amount, status, and relevant timestamps.

Event delivery#

Webhook notifications are sent as HTTP POST requests to the URL configured in the Subscribe to Payment Updates endpoint.

Payload structure#

The request body follows the schema documented below.
Payment Update

Example Payload#

{
    "id": "Bmym0aVrK",
    "user": "12345678A",
    "amount": 100,
    "fee": 0,
    "paid": true,
    "requestedAt": "2026-01-01T00:00:00.000Z",
    "status": "processed",
    "paidAt": "2026-01-01T00:00:00.000Z"
}
Modified at 2026-05-14 12:24:49
Previous
Retrieve Employee Flexflow Transactions
Next
Company Response
Built with