ErrorResponse

Standard API error object. Fields traceId, timestamp, path, and details are optional and additive for integrators. Messages are provider-agnostic (no acquirer/PSP brand names); use error.code, details, and traceId when contacting support.

  • code
    Type: string

    Stable machine-readable error code (e.g. VALIDATION_ERROR, AUTHENTICATION_ERROR, DUPLICATE_WITHDRAWAL_RISK)

  • details

    Optional structured payload: validation field list, retryAfter seconds, existingWithdrawalId for duplicate withdrawal risk, etc. Shape varies by code.

  • integrationError

    Optional structured integration hint (transactions). Same additive rules as details.

  • message
    Type: string

    Human-readable message without acquirer or PSP identifiers

  • path
    Type: string

    Request path that produced the error

  • timestamp
    Type: stringFormat: date-time

    When the error was materialized (ISO 8601)

  • traceId
    Type: string

    Correlation / trace identifier for support and logs