> ## 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. # Account Tokenization Success > Fired when a recipient account is successfully tokenized. Documents the latest contract version (v4); earlier versions may omit account_id. ## AsyncAPI ````yaml specs/asyncapi-notify-v3.yaml TransactionAccountTokenizationSuccess id: TransactionAccountTokenizationSuccess title: Account Tokenization Success description: >- Fired when a recipient account is successfully tokenized. Documents the latest contract version (v4); earlier versions may omit account_id. servers: - id: webhook protocol: https host: your-webhook-endpoint.example.com bindings: [] variables: [] address: transaction.account.tokenization.success parameters: [] bindings: [] operations: - &ref_0 id: receiveTransactionAccountTokenizationSuccess title: Receive transaction account tokenization success description: Account Tokenization Success type: receive messages: - &ref_1 id: TransactionAccountTokenizationSuccessMessage contentType: application/json payload: - name: Account Tokenization Success 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 Notify webhook events. Use these fields to match the event to a transaction in your system. required: true properties: - name: notification_id type: string description: >- Ingo-assigned unique identifier for the staged notification. required: true - name: session_id type: string description: Ingo-assigned session identifier, when applicable. required: false - name: participant_unique_id1 type: string description: >- Your primary correlation ID from the original Notify request. required: true - name: participant_unique_id2 type: string description: Your optional secondary correlation ID. required: false - name: party_id type: string description: >- Ingo-assigned ID for the specific party this event relates to. Present on multi-party (Notify v4) events. 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: customer_account_token type: string description: >- Opaque token representing the tokenized account. Use in subsequent Process or Debit requests. required: true - name: account_type type: string description: >- Account type code (CA, AC, SD, RT, PD, PU, VE, BP, CK). required: true - name: last_4 type: string description: >- Last four characters of the account number for identification. required: true - name: expiration_date type: string description: >- Expiration date in MMYY format. Present for card-based accounts only. required: false - name: account_id type: string description: Ingo-assigned unique identifier for this account. required: true - name: issuers type: array description: >- Details about the account issuer(s). Typically one object per account. required: true properties: - name: payee_id type: string description: Ingo-assigned ID for the payee/account issuer. required: false - name: payee_name type: string description: Name of the payee/account issuer. required: false - name: payee_address type: string description: Address of the payee/account issuer. May be empty. required: false - name: payee_city type: string description: City of the payee/account issuer. May be empty. required: false - name: payee_state type: string description: State of the payee/account issuer. May be empty. required: false - name: payee_zip type: string description: >- ZIP code of the payee/account issuer. May be empty. required: false - name: issuing_network type: string description: >- Network the account was issued under (Visa, MasterCard, ACH, etc.). "NA" if not applicable. required: false - name: credit_enabled type: integer description: >- 1 if account can receive credits for this participant, 0 otherwise. required: false - name: debit_enabled type: integer description: >- 1 if account can be debited for this participant, 0 otherwise. required: false - name: credit_info type: object description: >- Credit disbursement details. Present when credit_enabled is 1. required: false properties: - name: min type: string description: Minimum amount the issuer will accept. required: false - name: max type: string description: Maximum amount the issuer will accept. required: false - name: card_type type: string description: >- Type of card (credit, debit, prepaid, DDA, etc.). "NA" if not applicable. required: false - name: estimated_posting_time type: string description: Human-readable estimated posting time. required: false - name: estimated_posting_date type: string description: Estimated posting date in MM/DD/YYYY format. required: false - name: debit_info type: object description: >- Debit pull details. Present when debit_enabled is 1. required: false properties: - name: min type: string description: Minimum amount the issuer will accept. required: false - name: max type: string description: Maximum amount the issuer will accept. required: false - name: card_type type: string description: Type of card. "NA" if not applicable. required: false - name: bin type: string description: >- Bank Identification Number. Present for card-based accounts only. required: false - name: network_validation type: object description: >- Reference data from network card validation. Present when network validation was performed. required: false properties: - name: validation_provider_id type: string description: >- Card validation provider: 1 = Visa, 3 = MasterCard. required: false - name: name_validation type: object description: Name match results. required: false properties: - name: name_match_status type: string description: 1 = Name match performed, 2 = Not performed. required: false - name: name_match_decision type: string description: 1 = Match, 2 = Partial, 3 = No match. required: false - name: first_name_match_decision type: string description: 1 = Match, 2 = Partial, 3 = No match. required: false - name: last_name_match_decision type: string description: 1 = Match, 2 = Partial, 3 = No match. required: false - name: middle_name_match_decision type: string description: 1 = Match, 2 = Partial, 3 = No match. required: false - name: open_banking_finicity type: object description: >- Open banking account identification for Finicity. Present when client is configured for Finicity. required: false properties: - name: customer_id type: string description: Finicity customer ID. required: false - name: account_id type: string description: Finicity account ID. required: false 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: - notification_id - participant_unique_id1 description: >- Transaction correlation identifiers for Notify webhook events. Use these fields to match the event to a transaction in your system. properties: notification_id: type: string maxLength: 15 description: >- Ingo-assigned unique identifier for the staged notification. example: '10042781' x-parser-schema-id: session_id: type: string maxLength: 50 nullable: true description: Ingo-assigned session identifier, when applicable. x-parser-schema-id: participant_unique_id1: type: string maxLength: 100 description: >- Your primary correlation ID from the original Notify request. x-parser-schema-id: participant_unique_id2: type: string maxLength: 100 nullable: true description: Your optional secondary correlation ID. x-parser-schema-id: party_id: type: string maxLength: 36 nullable: true description: >- Ingo-assigned ID for the specific party this event relates to. Present on multi-party (Notify v4) events. x-parser-schema-id: x-parser-schema-id: NotifyCorrelation 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: - customer_account_token - account_type - last_4 - account_id - issuers description: >- Account tokenization result. The latest contract version (v4) is documented here; earlier versions may omit account_id. properties: customer_account_token: type: string maxLength: 50 description: >- Opaque token representing the tokenized account. Use in subsequent Process or Debit requests. x-parser-schema-id: account_type: type: string maxLength: 2 description: >- Account type code (CA, AC, SD, RT, PD, PU, VE, BP, CK). x-parser-schema-id: last_4: type: string maxLength: 4 description: >- Last four characters of the account number for identification. x-parser-schema-id: expiration_date: type: string maxLength: 4 description: >- Expiration date in MMYY format. Present for card-based accounts only. x-parser-schema-id: account_id: type: string maxLength: 36 description: Ingo-assigned unique identifier for this account. x-parser-schema-id: issuers: type: array description: >- Details about the account issuer(s). Typically one object per account. items: type: object properties: payee_id: type: string maxLength: 20 description: Ingo-assigned ID for the payee/account issuer. x-parser-schema-id: payee_name: type: string maxLength: 100 description: Name of the payee/account issuer. x-parser-schema-id: payee_address: type: string maxLength: 150 description: >- Address of the payee/account issuer. May be empty. x-parser-schema-id: payee_city: type: string maxLength: 150 description: >- City of the payee/account issuer. May be empty. x-parser-schema-id: payee_state: type: string maxLength: 2 description: >- State of the payee/account issuer. May be empty. x-parser-schema-id: payee_zip: type: string maxLength: 10 description: >- ZIP code of the payee/account issuer. May be empty. x-parser-schema-id: issuing_network: type: string maxLength: 10 description: >- Network the account was issued under (Visa, MasterCard, ACH, etc.). "NA" if not applicable. x-parser-schema-id: credit_enabled: type: integer description: >- 1 if account can receive credits for this participant, 0 otherwise. x-parser-schema-id: debit_enabled: type: integer description: >- 1 if account can be debited for this participant, 0 otherwise. x-parser-schema-id: credit_info: type: object description: >- Credit disbursement details. Present when credit_enabled is 1. properties: min: type: string description: Minimum amount the issuer will accept. x-parser-schema-id: max: type: string description: Maximum amount the issuer will accept. x-parser-schema-id: card_type: type: string description: >- Type of card (credit, debit, prepaid, DDA, etc.). "NA" if not applicable. x-parser-schema-id: estimated_posting_time: type: string description: Human-readable estimated posting time. x-parser-schema-id: estimated_posting_date: type: string description: >- Estimated posting date in MM/DD/YYYY format. x-parser-schema-id: x-parser-schema-id: debit_info: type: object description: >- Debit pull details. Present when debit_enabled is 1. properties: min: type: string description: Minimum amount the issuer will accept. x-parser-schema-id: max: type: string description: Maximum amount the issuer will accept. x-parser-schema-id: card_type: type: string description: Type of card. "NA" if not applicable. x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: bin: type: string maxLength: 8 description: >- Bank Identification Number. Present for card-based accounts only. x-parser-schema-id: network_validation: type: object description: >- Reference data from network card validation. Present when network validation was performed. properties: validation_provider_id: type: string maxLength: 3 description: >- Card validation provider: 1 = Visa, 3 = MasterCard. x-parser-schema-id: name_validation: type: object description: Name match results. properties: name_match_status: type: string description: 1 = Name match performed, 2 = Not performed. x-parser-schema-id: name_match_decision: type: string description: 1 = Match, 2 = Partial, 3 = No match. x-parser-schema-id: first_name_match_decision: type: string description: 1 = Match, 2 = Partial, 3 = No match. x-parser-schema-id: last_name_match_decision: type: string description: 1 = Match, 2 = Partial, 3 = No match. x-parser-schema-id: middle_name_match_decision: type: string description: 1 = Match, 2 = Partial, 3 = No match. x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: open_banking_finicity: type: object description: >- Open banking account identification for Finicity. Present when client is configured for Finicity. properties: customer_id: type: string maxLength: 50 description: Finicity customer ID. x-parser-schema-id: account_id: type: string maxLength: 50 description: Finicity account ID. x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: EventTokenizationSuccess x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: title: Account Tokenization Success example: |- { "metadata": { "topic_description": "This event reports successful tokenization of a recipient disbursement account. Includes the token and other account information.", "version": "4", "timestamp": 1777551286, "topic": "transaction.account.tokenization.success", "id": "ld01-56a94d64-0b65-43f0-88f1-3972d3900173" }, "data": { "ancillary": { "participant_unique_id2": "MM-92005-20260430-121439-7650-2", "session_id": "00000000-0000-0000-0000-000000000001", "participant_unique_id1": "MM-92005-20260430-121439-7650", "notification_id": "1000001" }, "event": { "last_4": "k6Aw", "issuers": [ { "payee_city": "", "issuing_network": "NA", "payee_address": "", "payee_id": "550330", "payee_state": "", "payee_name": "Paypal", "debit_enabled": 0, "payee_zip": "", "credit_enabled": 1, "credit_info": { "estimated_posting_date": "05/01/2026", "max": "4999.99", "estimated_posting_time": "Payment will post 05/01/2026", "min": "0.01", "card_type": "NA" } } ], "status": "100", "customer_account_token": "ee90dff0-eed3-4886-a26d-aa24733b46ca", "account_type": "PD", "attempt_count": 1, "max_attempts": 3, "client_message": "Success", "account_id": "992786" } } } bindings: [] extensions: - id: x-parser-unique-object-id value: TransactionAccountTokenizationSuccessMessage bindings: [] extensions: - id: x-parser-unique-object-id value: TransactionAccountTokenizationSuccess sendOperations: - *ref_0 receiveOperations: [] sendMessages: - *ref_1 receiveMessages: [] extensions: - id: x-parser-unique-object-id value: TransactionAccountTokenizationSuccess securitySchemes: [] ````