Body

• event object Required

  Webhook event details.

  Hide event attributes Show event attributes object

  • id string Required

    Unique ID for this webhook event.

  • type string Required

    The type of event that occurred.

  • timestamp string(date-time) Required

    The time when the event was triggered (UTC).

• originalResponse object Required

  Represents the response to a tokenized card removal request.

  Hide originalResponse attributes Show originalResponse attributes object

  • id string

    Unique ID for this card removal transaction.

  • paymentMethod object

    The tokenized card that was removed.

    Hide paymentMethod attributes Show paymentMethod attributes object

    • id string Required

      The unique identifier of the payment method. This ID has a prefix that makes it human-readable (pmt_trm_* for physical terminals, pmt_vrt_* for virtual card terminals, pmt_ach_* for virtual ACH terminals, pmt_tkn_* for tokenized cards), but applications should always use the type field to determine the payment method type rather than parsing this ID.

    • dateDeleted string(date-time)

      The date and time (UTC) when this payment method token was removed from the system using the Remove Token endpoint. This parameter will only be returned if the token was removed/deleted from the system.

      This field will be present in three scenarios:

      • As part of a successful Remove Token endpoint response
      • In token.removed webhook notifications
      • In List Transactions responses for transactions where the associated token was later removed

      When this field is present, sensitive card details (maskedCardNumber, cardExpDate) will be removed for security purposes, but all other transaction data remains intact.

    • type string Required

      The type of payment method:

      • Physical - A physical payment terminal for Card Present transactions
      • Virtual - A hosted payment form/iframe for Card Not Present transactions
      • VirtualAch - A hosted payment form/iframe for ACH (US) bank transfer transactions
      • Token - A tokenized card for card-on-file transactions

      Values are Physical, Virtual, VirtualAch, or Token.

    • currency string Required

      The currency of the payment method.

      Values are USD or CAD.

    • description string

      A human-readable name for the payment method.

    • billingContact object

      Billing contact information. Only returned for tokenized payment methods from Card Not Present transactions.

      Hide billingContact attributes Show billingContact attributes object

      • name string
      • countryCode string
      • zipCode string
      • address string
      • state string
      • city string
    • cardType string

      The type of card used for this transaction:

      • UNKNOWN - The card type is unknown
      • DEBIT - Debit Card
      • VISA - Visa Credit Card
      • MASTERCARD - MasterCard Credit Card
      • AMEX - American Express Credit Card
      • DINERS - Diners Club Credit Card
      • DISCOVER - Discover Credit Card
      • JCB - JCB Credit Card
      • UNIONPAY - UnionPay Credit Card
      • MAESTRO - Maestro Debit Card
      • GIFT - Gift Card
      • CASH - All-cash Transaction
      • EBT - Electronic Benefits Transfer Card
      • INTERAC - Interac (Canadian PIN-debit network), Card Present only
      • OTHER - Other tender types

      Values are UNKNOWN, DEBIT, VISA, MASTERCARD, AMEX, DINERS, DISCOVER, JCB, UNIONPAY, MAESTRO, GIFT, CASH, EBT, INTERAC, or OTHER.

    • maskedCardNumber string

      The masked card number. The format may vary (e.g. *********0011, 4*0011, etc.)

    • cardExpDate string

      The expiration date of the card in MMYY format.

    • accountType string

      Funding-source classification of this token-type payment method.

      • For card tokens: Credit or Debit.
      • For ACH tokens: Checking or Savings. May be null for older tokens that pre-date this field, for non-token payment methods, or when the source did not provide a classification.

      Values are Credit, Debit, Checking, or Savings.

  • referenceId string

    The reference ID for this transaction. This will either be the reference ID provided in the transaction request or, if no value was provided, a value generated automatically by the system. This reference ID can be used for processing captures and referenced refunds by including it in the originalReferenceId field of subsequent transactions.

    Maximum length is 100.

  • resultCode number

    Result codes:

    • 0 - Successful transaction request. (Check each transactionResponse's responseCode to determine if a transaction was approved or declined, card was tokenized, etc.)
    • 1003 - The payment terminal is busy or unavailable. (If this error persists, the user may need to close and re-open the Payment Application on the terminal or restart the terminal)
    • 1005 - The specified terminal could not be found.
    • 1010 - The transaction request is pending to become transaction.
    • 3000 - An unexpected error occurred. Please try again.
    • 3002 - The transaction could not be completed because the payment terminal could not find the related transaction.
    • 3005 - To resolve this error, power off your payment terminal, wait one minute and retry the transaction. If the error persists, please contact support.
    • 3006 - The transaction could not be completed because the payment terminal is low on battery.
    • 3009 - The transaction could not be completed because of network connectivity issues with the payment terminal. Please restore connectivity and try again.
    • 3010 - The transaction took too long and was cancelled by the application.
    • 3011 - Invalid transaction request. Please consult the documentation for valid transaction requests.
    • 3012 - Invalid transaction request. paymentMethodId is invalid.
    • 3013 - Invalid transaction request. The specified amount appears to be incorrect. Please retry with a smaller amount.
    • 3014 - Invalid amount. Please try your transaction again with an amount greater than $0.
    • 3020 - An unsupported transaction result was received.
    • 4001 - The transaction is being processed. This is returned for asynchronous bank transfer payment methods (e.g. ACH) while awaiting a final outcome.
    • 6800 - 3D Secure authentication was rejected by the issuer's ACS (card auth failed, security failure, stolen card, suspected fraud, etc.). Surfaced on declined CNP transactions when formConfig.enable3DSecure: true. See SDK Error Codes for guidance.
    • 6801 - 3D Secure authentication could not be completed because of an upstream technical issue (ACS timeout, directory server unreachable). Retry later or, if merchant policy allows, retry with 3DS disabled.
    • 6802 - The card is not enrolled in 3D Secure. Retry without 3DS (if allowed) to succeed.
    • 9998 - The system is not ready to process a transaction.
    • 9999 - An unknown error has occurred. If available, an auxiliary error code will be provided in the message.

    Values are 0, 1003, 1005, 1010, 3000, 3002, 3005, 3006, 3009, 3010, 3011, 3012, 3013, 3014, 3020, 4001, 6800, 6801, 6802, 9998, or 9999.

  • resultText string

    A message describing the result code in more detail.