> ## Documentation Index > Fetch the complete documentation index at: https://developers.ingopayments.com/llms.txt > Use this file to discover all available pages before exploring further. # PayPal Account Verification Failure > Fired when PayPal account verification fails. ## AsyncAPI ````yaml specs/asyncapi-iframe.yaml PluginTransactionAccountVerificationPaypalFailureAv id: PluginTransactionAccountVerificationPaypalFailureAv title: PayPal Account Verification Failure description: Fired when PayPal account verification fails. servers: - id: webhook protocol: https host: your-webhook-endpoint.example.com bindings: [] variables: [] address: plugin.transaction.account.verification.paypal.failure.av parameters: [] bindings: [] operations: - &ref_0 id: receivePluginTransactionAccountVerificationPaypalFailureAv title: Receive plugin transaction account verification paypal failure av description: PayPal Account Verification Failure type: receive messages: - &ref_1 id: PluginTransactionAccountVerificationPaypalFailureAvMessage contentType: application/json payload: - name: PayPal Account Verification Failure type: object properties: - name: metadata type: object description: Delivery metadata present on every webhook event. required: true properties: - name: id type: string description: >- Ingo-assigned unique ID for this delivery. Use as your idempotency key to deduplicate retries. required: true - name: topic type: string description: Topic name identifying the event type. required: true - name: topic_description type: string description: Human-readable description of the event. required: true - name: timestamp type: integer description: Unix timestamp of the webhook delivery. required: true - name: version type: string description: Payload contract version. required: true - name: data type: object required: true properties: - name: ancillary type: object description: >- Transaction correlation identifiers for IngoPay and Embedded iFrame webhook events. Use these fields to match the event to a transaction in your system. required: true properties: - name: tracer_token type: string description: >- Ingo-assigned tracer identifier for the original request. required: false - name: session_id type: string description: >- Ingo-assigned session identifier for the iFrame interaction. required: false - name: participant_unique_id1 type: string description: Your primary correlation ID from the original request. required: true - name: participant_unique_id2 type: string description: Your optional secondary correlation ID. required: false - name: event type: object required: true properties: - name: status type: string description: Numeric status code for the event outcome. required: true - name: client_message type: string description: Human-readable description of the event outcome. required: true - name: attempt_count type: integer description: >- Current delivery attempt number. Present when the event type has a configurable attempt counter. required: false - name: max_attempts type: integer description: >- Maximum allowed attempts. Present when the event type has a configurable attempt counter. required: false - name: has_passed type: boolean description: >- Overall result of the PayPal account verification attempt. required: true - name: was_skipped type: boolean description: Whether verification was bypassed per configuration. required: true - name: field_results type: array description: Per-field verification results. required: true properties: - name: field_name type: string description: >- Name of the field assessed (e.g. FirstName, IsVerifiedAccount). required: true - name: is_matching type: boolean description: Whether the field values matched. required: true - name: is_enabled type: boolean description: Whether this field was enabled for matching. required: true - name: was_evaluated type: boolean description: Whether this field was evaluated. required: true - name: client_provided_value type: string description: Value you submitted for this field. required: true - name: paypal_provided_value type: string description: Value returned by PayPal for this field. required: true - name: hard_fail_on_mismatch type: boolean description: Whether a mismatch constitutes a hard failure. required: true headers: [] jsonPayloadSchema: type: object required: - metadata - data properties: metadata: type: object required: - id - topic - topic_description - timestamp - version description: Delivery metadata present on every webhook event. properties: id: type: string maxLength: 50 description: >- Ingo-assigned unique ID for this delivery. Use as your idempotency key to deduplicate retries. example: prod01-6aaa3079-c1ff-4cae-b77a-4b76026fc846 x-parser-schema-id: topic: type: string maxLength: 150 description: Topic name identifying the event type. x-parser-schema-id: topic_description: type: string maxLength: 250 description: Human-readable description of the event. x-parser-schema-id: timestamp: type: integer description: Unix timestamp of the webhook delivery. example: 1777509495 x-parser-schema-id: version: type: string maxLength: 5 description: Payload contract version. example: '1' x-parser-schema-id: x-parser-schema-id: WebhookMetadata data: type: object required: - ancillary - event properties: ancillary: type: object required: - participant_unique_id1 description: >- Transaction correlation identifiers for IngoPay and Embedded iFrame webhook events. Use these fields to match the event to a transaction in your system. properties: tracer_token: type: string maxLength: 250 nullable: true description: >- Ingo-assigned tracer identifier for the original request. x-parser-schema-id: session_id: type: string maxLength: 50 nullable: true description: >- Ingo-assigned session identifier for the iFrame interaction. x-parser-schema-id: participant_unique_id1: type: string maxLength: 100 description: Your primary correlation ID from the original request. x-parser-schema-id: participant_unique_id2: type: string maxLength: 100 nullable: true description: Your optional secondary correlation ID. x-parser-schema-id: x-parser-schema-id: IngoPayCorrelation event: allOf: - type: object required: - status - client_message description: >- Core event outcome fields present on every webhook event. Additional event-specific properties may be present — see the individual event documentation for the complete schema. properties: status: type: string maxLength: 10 description: Numeric status code for the event outcome. x-parser-schema-id: client_message: type: string maxLength: 250 description: Human-readable description of the event outcome. x-parser-schema-id: attempt_count: type: integer description: >- Current delivery attempt number. Present when the event type has a configurable attempt counter. example: 1 x-parser-schema-id: max_attempts: type: integer description: >- Maximum allowed attempts. Present when the event type has a configurable attempt counter. example: 3 x-parser-schema-id: x-parser-schema-id: WebhookEventBase - type: object required: - has_passed - was_skipped - field_results description: PayPal account verification outcome. properties: has_passed: type: boolean description: >- Overall result of the PayPal account verification attempt. x-parser-schema-id: was_skipped: type: boolean description: Whether verification was bypassed per configuration. x-parser-schema-id: field_results: type: array description: Per-field verification results. items: type: object required: - field_name - is_matching - is_enabled - was_evaluated - client_provided_value - paypal_provided_value - hard_fail_on_mismatch properties: field_name: type: string maxLength: 150 description: >- Name of the field assessed (e.g. FirstName, IsVerifiedAccount). x-parser-schema-id: is_matching: type: boolean description: Whether the field values matched. x-parser-schema-id: is_enabled: type: boolean description: Whether this field was enabled for matching. x-parser-schema-id: was_evaluated: type: boolean description: Whether this field was evaluated. x-parser-schema-id: client_provided_value: type: string maxLength: 150 description: Value you submitted for this field. x-parser-schema-id: paypal_provided_value: type: string maxLength: 150 description: Value returned by PayPal for this field. x-parser-schema-id: hard_fail_on_mismatch: type: boolean description: Whether a mismatch constitutes a hard failure. x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: EventPaypalVerification x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: title: PayPal Account Verification Failure example: |- { "data": { "ancillary": { "participant_unique_id2": "111111111-2222-3333333-4444444444", "tracer_token": "9999999abc-9abc-acb9-cab9999999999", "session_id": "00000000-0000-0000-0000-000000000001", "participant_unique_id1": "22222222-5555-3333333-4444444444" }, "event": { "has_passed": false, "status": "1150", "attempt_count": 1, "max_attempts": 1, "field_results": [ { "was_evaluated": true, "client_provided_value": "True", "is_matching": true, "field_name": "IsVerifiedAccount", "paypal_provided_value": "True", "hard_fail_on_mismatch": true, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "Alex", "is_matching": false, "field_name": "FirstName", "paypal_provided_value": "Jamie", "hard_fail_on_mismatch": false, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "Rivera", "is_matching": false, "field_name": "LastName", "paypal_provided_value": "Chen", "hard_fail_on_mismatch": false, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "100 Innovation Way", "is_matching": false, "field_name": "AddressLine1", "paypal_provided_value": "200 Different Blvd", "hard_fail_on_mismatch": false, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "Anytown", "is_matching": false, "field_name": "City", "paypal_provided_value": "Othertown", "hard_fail_on_mismatch": false, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "GA", "is_matching": false, "field_name": "State", "paypal_provided_value": "CA", "hard_fail_on_mismatch": false, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "30092", "is_matching": false, "field_name": "ZipCode", "paypal_provided_value": "95127", "hard_fail_on_mismatch": false, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "US", "is_matching": true, "field_name": "Country", "paypal_provided_value": "US", "hard_fail_on_mismatch": true, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "recipient@example.com", "is_matching": false, "field_name": "HasAssociatedEmail", "paypal_provided_value": "other@example.com", "hard_fail_on_mismatch": true, "is_enabled": true }, { "was_evaluated": true, "client_provided_value": "recipient@example.com", "is_matching": false, "field_name": "PrimaryEmail", "paypal_provided_value": "other@example.com", "hard_fail_on_mismatch": true, "is_enabled": true } ], "was_skipped": false, "client_message": "PayPal Account Verification Error" } }, "metadata": { "version": "1", "topic_description": "This event indicates that the PayPal account verification has failed", "timestamp": 1751947442, "topic": "plugin.transaction.account.verification.paypal.failure.av", "id": "prod1-123456-abcd-1234-ab12-c123d456e789" } } bindings: [] extensions: - id: x-parser-unique-object-id value: PluginTransactionAccountVerificationPaypalFailureAvMessage bindings: [] extensions: - id: x-parser-unique-object-id value: PluginTransactionAccountVerificationPaypalFailureAv sendOperations: - *ref_0 receiveOperations: [] sendMessages: - *ref_1 receiveMessages: [] extensions: - id: x-parser-unique-object-id value: PluginTransactionAccountVerificationPaypalFailureAv securitySchemes: [] ````