Skip to main content
Version: 2.0

Changelog

Version 2.0​

Changes to API endpoints​

  • The Payment Fraud Score endpoint has been renamed to Financial Events Screening to better reflect its purpose of screening financial events rather than just providing a score. The score field in the response continues to represent the fraud risk assessment.
https://api.fraudio.com/v2/financial-events/screening
  • The Payment Events Enrichment endpoint has been renamed to Financial Events Enrichment.
https://api.fraudio.com/v2/financial-events/enrichment

  • Payment Post-Authorization Enrichment is no longer a separate endpoint in v2. Send post-authorization data (for example authorization response fields such as response_code, eci, avs_result, cvv_result, cavv_result) to Financial Events Enrichment as a card_network_transaction event with MTI 0110 (authorization response), linked to the original 0100 via parent_event_id and/or lifecycle_rrn.

  • Merchant Account Information is no longer a separate endpoint in v2. Send merchant and other entity snapshots or updates via Financial Events Enrichment using an entities-only payload (events: []).

  • Merchant entities are renamed: use merchant_business for the selling business, and merchant_account for the acquiring account. The processor-assigned Merchant ID is the mid property on merchant_account (not a separate entity type). Registered MCCs go on merchant_account / sub_merchant (mccs); the as-processed code for a payment goes on the event (details.mcc). sub_merchant is a PayFac-sponsored seller.

  • The former event type transaction is renamed to card_network_transaction (card payment network messages such as authorization, capture, reversal, OCT). The field details.transaction_type is unchanged.

  • The Merchant Evaluations endpoint has been removed in v2.

  • Dispute Events is no longer a separate endpoint in v2. Send disputes via Financial Events Enrichment with event type dispute.

  • Account Bank Transfers is no longer a separate endpoint in v2. Send bank-to-bank transfers via Financial Events Enrichment with event type bank_transfer.

  • All other endpoints remain functionally similar but now use the v2 API path structure.

Version 1.1​

Attention:

We've updated our API endpoints with new names and an additional route. However: All previous endpoints remain operational and supported, facilitating a seamless transition.

For help navigating the legacy endpoints, please refer to the Version 1.0 documentation or select version 1.0 directly from the top navigation dropdown.

Changes to API endpoints​

  • The "Fraud Score" endpoint has been renamed to Payment Fraud Score.
https://api.fraudio.com/v1/transactions/payment-fraud-score
  • The "Post-Authorization Backfill" endpoint has been renamed to Payment Post-Authorization Enrichment.
https://api.fraudio.com/v1/transactions/payment-post-authorization-enrichment
  • The endpoints "Fraud Notifications Enrichment" and "Chargebacks" are aliases for the new Dispute Events endpoint.
https://api.fraudio.com/v1/transactions/dispute-events
  • The Payment Events Enrichment endpoint is brand-new, and is designed as a supplement to the Payment Fraud Score endpoint, supporting additional data on both pre-auth and post-auth integrations.
https://api.fraudio.com/v1/transactions/payment-events-enrichment
tip

Note on the difference between Payment Events Enrichment and Payment Post-Authorization Enrichment:

  • Payment Events Enrichment supports both pre-auth and post-auth integrations in the context of real-time fraud detection.
  • Payment Post-Authorization Enrichment is all about enriching existing pre-auth transactions with new data, and is specialized for pre-auth setups, letting you backfill post-auth fields like eci and cavvresult, which the first endpoint doesn't accommodate.

Added Rules Management API Endpoints​

We've introduced new API endpoints for Rules Management. These endpoints allow customers to create, read, update, and archive transaction rules. These additions provide more granular control for fraud detection and transaction processing. Please refer to the updated documentation sections on Rules Management for detailed information on each endpoint and its usage.

New and modified fields​

  • The fields originalamount and iban have been renamed in all endpoints where they existed:
    • originalamount is now amount.
    • iban is now bankaccountnumber.
  • currencyunit now allows you to specify the currency unit (minor / major).