# Create fraud report Create a fraud report. This endpoint generates a [Fraud report created](https://developers.pismo.io/events/docs/fraud-report-fraud-report-creation-1) event. **Note:** This endpoint takes an account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a 401 Unauthorized message. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Card issuing - Disputes", "version": "1.0.0", "description": "Disputes API endpoints", "contact": { "name": "API Support", "url": "https://developers.pismo.io/support/" }, "license": { "name": "Copyright Pismo" } }, "servers": [ { "url": "https://sandbox.pismolabs.io/disputes", "description": "Sandbox API server for testing" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Fraud report", "description": "Endpoints to create and manage fraud reports" } ], "components": { "schemas": { "AccountID": { "type": "number", "description": "Pismo account ID", "example": 577830 }, "AuthorizationCode": { "type": "string", "description": "Authorization code", "example": "F0JR9H" }, "AuthorizationId": { "type": "number", "description": "Pismo network authorization ID.", "example": 1234567890 }, "CardID": { "type": "number", "description": "Pismo card ID.", "example": 123456 }, "CreatedAt": { "type": "string", "description": "Created at datetime, format = yyyy-mm-dd hh:mm:ss\"", "example": "2024-10-18 11:21:45" }, "CustomerId": { "type": "number", "example": 10203040, "description": "Pismo customer ID." }, "EloInternationalAction": { "type": "string", "description": "Elo international action", "enum": [ "CREATED", "UPDATED", "DELETED" ], "example": "CREATED" }, "EloInternationalPrimaryReason": { "type": "string", "description": "Fraud report reasons:
\n`AT`: Account Takeover - The unauthorized use of a card account by any person who gains access to that card account with the intent to defraud the Issuer.
\n`CA`: Counterfeit/altered Cards - Any card that is manufactured illegally, stamped, or coded.
\n`ED`: Employee Fraud - Any manipulation or misuse of a card account by an employee of the issuer with the intention of defrauding the issuer.
\n`FA`: Application fraud - Acquisition of a card account as a result of presenting false or incorrect information with the intention of deceiving and defrauding an issuer.
\n`LS`: Lost/Stolen - Unauthorized use of lost or stolen card, checks, or balance transfer coupons.
\n`MS`: Skimmed - Unauthorized use or possession of an account through theft of content of the complete magnetic stripe data of a valid card and duplication on the stripe magnetic from another card.
\n`ND`: No device - Unauthorized use of a valid card number to make purchases by mail, telephone, or electronic order.
\n`NR`: Non-Receipt - Non-receipt or theft through the card sending process by mail, checks, or balance transfer coupons.
\n`OT`: Others - Generally not used. This type of fraud is only used when the fraud activity cannot be classified by the remaining fraud types. **Exception for prepaid only**: This type of fraud must be used to classify the activity determined to be the conversion of unsettled funds.
\n", "enum": [ "AT", "CA", "ED", "FA", "LS", "MS", "ND", "NR", "OT" ], "example": "AT" }, "EloInternationalSecondaryReason": { "type": "string", "description": "Secondary fraud report reasons.
\n`BT`\\* - Balance Transfer Coupon - An unauthorized, completed balance transfer by telephone, at the request of a person claiming to be the Owner.
\n`CD` - Card - An altered card.
\n`CK`\\* - Verification - Any non-receipt of money access checks or balance transfer. Or changed check(s).
\n`FF`\\* - Family Fraud - The information (Name, social security number (SSN), date of birth, etc.) belongs to another person (the victim), who actually knows the individual(fraudster) who committed the fraud, forging his (the victim's) identity. The fraudster may be a household, non-domestic, or a distant family member relative or friend. This is the most common application of fraud.
\n`FP` - Forced emission of plastic - Plastics that were sent due to the update platinum, marketing initiative, or any issue outside the usual reissue cycle.
\n`IT`\\* - Internet - An unauthorized change of address made via the internet.
\n`MI`\\* - Mail - An unauthorized address change request sent via US mail.
\n`NA` - Nova Conta - Plastics shipped upon issuance of a new bill.
\n`P!`\\* - Telephone - A request for authorization for a change of address, plastics, or checks by a person claiming to be the holder.
\n`PN` - Card and PIN - unauthorized cash advances at an ATM for a lost or stolen personal card number and password (PIN).
\n`RI` - Card reissuance - Plastics sent automatically to replace those that approaching their expiration date.
\n`RT` - Retail - Sales are keyed in commercial establishments where a card is normally necessary and there is no direct evidence that any card was present at the time of sale.
\n`ST`\\* - Student - A long format \"student\" application, usually requested in university campuses.
\n`TM`\\* - Telemarketing - A request made over the telephone via an outgoing call from the center or via marketing service.
\n`TO`\\* - Take One - Unsolicited Application. This is the most common type of application. Lots of It are sometimes displayed at sales counters.
\n`TP` - Telephone - An inbound telephone call to the Customer Service Department to the cardholder, in which the representative, assumed the information provided by telephone.
\n`TR`- Account Transfer - Plastics that were shipped as a result of any type replacement account.
\n\n\\* - Can only be used for Credit.\n", "enum": [ "BT", "CD", "CK", "FF", "FP", "IT", "MI", "NA", "PI", "PN", "RI", "RT", "ST", "TM", "TO", "TP", "TR" ], "example": "BT" }, "EloNationalAuthorizationOriginIndicator": { "type": "string", "description": "Authorization origin indicator.
\n `Y` - Issuer authorized
\n `X` - Parameter authorized
\n `N` - Not authorized
\n", "enum": [ "Y", "N", "X" ], "example": "Y" }, "EloNationalCardServiceCode": { "type": "string", "description": "Card type:
\n * `C` - Chip
\n * `M` - Stripe
\n", "enum": [ "C", "M" ], "example": "C" }, "EloNationalExchangeIndicator": { "type": "string", "description": "Is this an exchange? Default is `N` (no).\n", "enum": [ "Y", "N" ], "example": "N" }, "EloNationalExchangeValue": { "type": "number", "format": "double", "description": "Exchange value.", "example": 9 }, "EloNationalFraudType": { "type": "string", "description": "Elo national fraud type:
\n\n `00` - Cartão Perdido pelo Portador/ Lost card
\n `01` - Cartão Roubado do Portador/ Stolen card
\n `02` - Cartão extraviado (Portador não recebeu cartão do emissor, porém emissor alega que enviou o cartão)/ Card not received as issued
\n `03` - Falsidade ideológica/ Fraudulent use
\n `04` - Cartão clonado/falsificado/ Cloned card
\n `05` - Transação autorizada sem o envolvimento do portador/invasão da conta/ Fraudulent use of account number
\n `06` - Número do cartão foi usado em transação de marketing direto ou no comércio eletrônico/ Card number was used in a direct marketing or e-commerce transaction.
\n `07` - Fraude Familiar / Friendly fraud
\n `08` - Suspeita de Golpe / Suspected scam
\n `09` - Auto Fraude / Auto fraud
\n `10` - Fraude Interna / Internal fraud
\n `11` - Prilex / Brazilian malware
\n", "enum": [ "00", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11" ], "example": "01" }, "EloNationalNotificationCode": { "type": "string", "description": "Notification type code.
\n`1` - First notification
\n`2` - Notification sent again
\n`3` - Change
\n`4` - Deletion (cancellation fraud warning)
\n`5` = Reactivation
\n", "enum": [ "1", "2", "3", "4", "5" ], "example": "1" }, "ErrorModel": { "title": "ErrorModel", "description": "API generic returned error.", "type": "object", "properties": { "code": { "type": "string", "description": "Error code." }, "message": { "type": "string", "description": "Error description." }, "http_status_code": { "type": "number", "description": "HTTP status code following RCF-9110" }, "details": { "type": "object", "description": "Payload array returning all fields with problems on request validation.
\nThese validations can be:
\n * Invalid length
\n * Invalid type
\n * Invalid accepted
\n\nValues are explained in the message.
\n" } } }, "Fraud_Report_Create_Elo_International": { "type": "object", "description": "Create Elo international fraud report", "required": [ "transaction_id", "report_type", "report" ], "properties": { "transaction_id": { "$ref": "#/components/schemas/TransactionId" }, "report_type": { "$ref": "#/components/schemas/ReportTypeEloInternational" }, "report": { "$ref": "#/components/schemas/ReportEloInternational" } } }, "Fraud_Report_Create_Elo_National": { "type": "object", "description": "Create Elo national fraud report", "required": [ "transaction_id", "report_type", "report" ], "properties": { "transaction_id": { "$ref": "#/components/schemas/TransactionId" }, "report_type": { "$ref": "#/components/schemas/ReportTypeElo" }, "report": { "$ref": "#/components/schemas/ReportEloNational" } } }, "Fraud_Report_Create_Mastercard": { "type": "object", "description": "Create Mastercard fraud report", "required": [ "transaction_id", "report_type", "report" ], "properties": { "transaction_id": { "$ref": "#/components/schemas/TransactionId" }, "report_type": { "$ref": "#/components/schemas/ReportTypeMastercard" }, "report": { "$ref": "#/components/schemas/ReportMastercard" } } }, "Fraud_Report_Create_Visa": { "type": "object", "description": "Create Visa fraud report", "required": [ "transaction_id", "report_type", "report" ], "properties": { "transaction_id": { "$ref": "#/components/schemas/TransactionId" }, "report_type": { "$ref": "#/components/schemas/ReportTypeVisa" }, "report": { "$ref": "#/components/schemas/ReportVisa" } } }, "Fraud_Report_Create_Visa_Card": { "type": "object", "description": "Create Visa card fraud report", "required": [ "report_type", "card_id", "customer_id", "report" ], "properties": { "report_type": { "$ref": "#/components/schemas/ReportTypeVisaCard" }, "card_id": { "$ref": "#/components/schemas/CardID" }, "customer_id": { "$ref": "#/components/schemas/CustomerId" }, "report": { "$ref": "#/components/schemas/ReportVisa" } } }, "Fraud_Report_Create_Response_Elo_International": { "type": "object", "properties": { "fraud_report_id": { "$ref": "#/components/schemas/FraudReportId" }, "org_id": { "$ref": "#/components/schemas/OrgId" }, "status": { "$ref": "#/components/schemas/Status" }, "network": { "$ref": "#/components/schemas/Network" }, "report": { "$ref": "#/components/schemas/ReportEloInternationalUpdate" }, "created_at": { "$ref": "#/components/schemas/CreatedAt" }, "network_authorization_id": { "$ref": "#/components/schemas/AuthorizationId" }, "authorization_code": { "$ref": "#/components/schemas/AuthorizationCode" }, "transaction_id": { "$ref": "#/components/schemas/TransactionId" }, "account_id": { "$ref": "#/components/schemas/AccountID" }, "card_id": { "$ref": "#/components/schemas/CardID" }, "report_type": { "$ref": "#/components/schemas/ReportType" } } }, "Fraud_Report_Create_Response_Elo_National": { "type": "object", "properties": { "fraud_report_id": { "$ref": "#/components/schemas/FraudReportId" }, "org_id": { "$ref": "#/components/schemas/OrgId" }, "status": { "$ref": "#/components/schemas/Status" }, "network": { "$ref": "#/components/schemas/Network" }, "report": { "$ref": "#/components/schemas/ReportEloNationalUpdate" }, "created_at": { "$ref": "#/components/schemas/CreatedAt" }, "network_authorization_id": { "$ref": "#/components/schemas/AuthorizationId" }, "authorization_code": { "$ref": "#/components/schemas/AuthorizationCode" }, "transaction_id": { "$ref": "#/components/schemas/TransactionId" }, "account_id": { "$ref": "#/components/schemas/AccountID" }, "card_id": { "$ref": "#/components/schemas/CardID" }, "report_type": { "$ref": "#/components/schemas/ReportType" } } }, "Fraud_Report_Create_Response_Mastercard": { "type": "object", "properties": { "fraud_report_id": { "$ref": "#/components/schemas/FraudReportId" }, "org_id": { "$ref": "#/components/schemas/OrgId" }, "status": { "$ref": "#/components/schemas/Status" }, "network": { "$ref": "#/components/schemas/Network" }, "report": { "$ref": "#/components/schemas/ReportMastercardUpdate" }, "created_at": { "$ref": "#/components/schemas/CreatedAt" }, "network_authorization_id": { "$ref": "#/components/schemas/AuthorizationId" }, "authorization_code": { "$ref": "#/components/schemas/AuthorizationCode" }, "transaction_id": { "$ref": "#/components/schemas/TransactionId" }, "account_id": { "$ref": "#/components/schemas/AccountID" }, "card_id": { "$ref": "#/components/schemas/CardID" }, "report_type": { "$ref": "#/components/schemas/ReportType" } } }, "Fraud_Report_Create_Response_Visa": { "type": "object", "properties": { "fraud_report_id": { "$ref": "#/components/schemas/FraudReportId" }, "org_id": { "$ref": "#/components/schemas/OrgId" }, "status": { "$ref": "#/components/schemas/Status" }, "network": { "$ref": "#/components/schemas/Network" }, "report": { "$ref": "#/components/schemas/ReportVisaUpdate" }, "created_at": { "$ref": "#/components/schemas/CreatedAt" }, "network_authorization_id": { "$ref": "#/components/schemas/AuthorizationId" }, "authorization_code": { "$ref": "#/components/schemas/AuthorizationCode" }, "transaction_id": { "$ref": "#/components/schemas/TransactionId" }, "account_id": { "$ref": "#/components/schemas/AccountID" }, "card_id": { "$ref": "#/components/schemas/CardID" }, "report_type": { "$ref": "#/components/schemas/ReportType" } } }, "Fraud_Report_Create_Response_Visa_Card": { "type": "object", "properties": { "fraud_report_id": { "$ref": "#/components/schemas/FraudReportId" }, "org_id": { "$ref": "#/components/schemas/OrgId" }, "status": { "$ref": "#/components/schemas/Status" }, "network": { "$ref": "#/components/schemas/Network" }, "report": { "$ref": "#/components/schemas/ReportVisaCardUpdate" }, "created_at": { "$ref": "#/components/schemas/CreatedAt" }, "account_id": { "$ref": "#/components/schemas/AccountID" }, "card_id": { "$ref": "#/components/schemas/CardID" }, "report_type": { "$ref": "#/components/schemas/ReportType" }, "customer_id": { "$ref": "#/components/schemas/CustomerId" } } }, "FraudReportId": { "type": "number", "example": 123, "description": "Pismo fraud report ID." }, "MastercardAcctStatus": { "type": "string", "description": "Mastercard account status", "enum": [ "ACCT_IS_OPEN", "ACCT_HAS_BEEN_CLOSED" ], "example": "ACCT_IS_OPEN" }, "MastercardChargebackIndicator": { "type": "string", "description": "Mastercard chargeback indicator. true = `1`, false = `0`.", "enum": [ "0", "1" ], "example": "1" }, "MastercardCvcInvalidIndicator": { "type": "string", "description": "Mastercard CVC invalid code indicator\n", "example": "Y", "enum": [ "Y", "*", "M", "N", "P", "U", "?", "E" ] }, "MastercardDeviceType": { "type": "string", "description": "Mastercard account device type.\n", "enum": [ "1", "2", "3", "4", "A", "B", "C", "D", "E", "F", "G", "H", "I", "J" ], "example": "1" }, "MastercardFraudType": { "type": "string", "description": "Mastercard fraud type.\n", "enum": [ "00", "01", "02", "03", "04", "05", "06", "51", "55", "56", "57" ], "example": "01" }, "MastercardSubType": { "type": "string", "description": "Mastercard fraud sub type codes\n", "enum": [ "K", "N", "P", "U", "H", "R", "I", "V", "A" ], "example": "K" }, "Network": { "type": "string", "description": "Card network brand.", "enum": [ "Elo", "Mastercard", "Visa" ], "example": "Visa" }, "OrgId": { "type": "string", "description": "Organization/tenant ID.", "example": "TN-34778262-f4f0-464d-b4c6-a14exxxxxxxx" }, "ReportDate": { "type": "string", "description": "Fraud report date, format = yyyy-mm-dd.\n", "example": "2025-08-11" }, "ReportEloInternational": { "type": "object", "description": "Elo international report", "required": [ "action", "primary_reason", "secondary_reason" ], "properties": { "action": { "$ref": "#/components/schemas/EloInternationalAction" }, "primary_reason": { "$ref": "#/components/schemas/EloInternationalPrimaryReason" }, "secondary_reason": { "$ref": "#/components/schemas/EloInternationalSecondaryReason" } } }, "ReportEloInternationalUpdate": { "type": "object", "description": "Elo international report", "properties": { "action": { "$ref": "#/components/schemas/EloInternationalAction" }, "primary_reason": { "$ref": "#/components/schemas/EloInternationalPrimaryReason" }, "secondary_reason": { "$ref": "#/components/schemas/EloInternationalSecondaryReason" } } }, "ReportEloNational": { "type": "object", "description": "Elo national report", "required": [ "fraud_type", "report_date", "authorization_origin_indicator", "notification_code", "card_service_code", "exchange_value", "exchange_indicator" ], "properties": { "fraud_type": { "$ref": "#/components/schemas/EloNationalFraudType" }, "report_date": { "$ref": "#/components/schemas/ReportDate" }, "authorization_origin_indicator": { "$ref": "#/components/schemas/EloNationalAuthorizationOriginIndicator" }, "notification_code": { "$ref": "#/components/schemas/EloNationalNotificationCode" }, "card_service_code": { "$ref": "#/components/schemas/EloNationalCardServiceCode" }, "exchange_value": { "$ref": "#/components/schemas/EloNationalExchangeValue" }, "exchange_indicator": { "$ref": "#/components/schemas/EloNationalExchangeIndicator" } } }, "ReportEloNationalUpdate": { "type": "object", "description": "Elo national report", "properties": { "fraud_type": { "$ref": "#/components/schemas/EloNationalFraudType" }, "report_date": { "$ref": "#/components/schemas/ReportDate" }, "authorization_origin_indicator": { "$ref": "#/components/schemas/EloNationalAuthorizationOriginIndicator" }, "notification_code": { "$ref": "#/components/schemas/EloNationalNotificationCode" }, "card_service_code": { "$ref": "#/components/schemas/EloNationalCardServiceCode" }, "exchange_value": { "$ref": "#/components/schemas/EloNationalExchangeValue" }, "exchange_indicator": { "$ref": "#/components/schemas/EloNationalExchangeIndicator" } } }, "ReportMastercard": { "type": "object", "description": "Mastercard report", "required": [ "fraud_type", "acct_status", "chgbk_indicator", "cvc_invalid_indicator", "device_type", "sub_type" ], "properties": { "fraud_type": { "$ref": "#/components/schemas/MastercardFraudType" }, "acct_status": { "$ref": "#/components/schemas/MastercardAcctStatus" }, "chgbk_indicator": { "$ref": "#/components/schemas/MastercardChargebackIndicator" }, "cvc_invalid_indicator": { "$ref": "#/components/schemas/MastercardCvcInvalidIndicator" }, "device_type": { "$ref": "#/components/schemas/MastercardDeviceType" }, "sub_type": { "$ref": "#/components/schemas/MastercardSubType" } } }, "ReportMastercardUpdate": { "type": "object", "description": "Mastercard report", "properties": { "fraud_type": { "$ref": "#/components/schemas/MastercardFraudType" }, "acct_status": { "$ref": "#/components/schemas/MastercardAcctStatus" }, "chgbk_indicator": { "$ref": "#/components/schemas/MastercardChargebackIndicator" }, "cvc_invalid_indicator": { "$ref": "#/components/schemas/MastercardCvcInvalidIndicator" }, "device_type": { "$ref": "#/components/schemas/MastercardDeviceType" }, "sub_type": { "$ref": "#/components/schemas/MastercardSubType" } } }, "ReportType": { "type": "string", "description": "Fraud report type. \n\nUsed to validate the `transaction_id` or `card_id` network brand and content following network brand rules.\n", "enum": [ "elo", "elo_international", "mastercard", "visa", "visa_card" ], "example": "visa" }, "ReportTypeElo": { "type": "string", "description": "Fraud report type. \n", "enum": [ "elo" ], "example": "elo" }, "ReportTypeEloInternational": { "type": "string", "description": "Fraud report type. \n", "enum": [ "elo_international" ], "example": "elo_international" }, "ReportTypeMastercard": { "type": "string", "description": "Fraud report type. \n", "enum": [ "mastercard" ], "example": "mastercard" }, "ReportTypeVisa": { "type": "string", "description": "Fraud report type. \n", "enum": [ "visa" ], "example": "visa" }, "ReportTypeVisaCard": { "type": "string", "description": "Fraud report type. \n", "enum": [ "visa_card" ], "example": "visa_card" }, "ReportVisa": { "type": "object", "description": "Visa report", "required": [ "fraud_type", "fraud_type_category", "notification_cd", "close_fraud_case_ind" ], "properties": { "fraud_type": { "$ref": "#/components/schemas/VisaFraudType" }, "fraud_type_category": { "$ref": "#/components/schemas/VisaFraudTypeCategory" }, "notification_cd": { "$ref": "#/components/schemas/VisaNotificationCd" }, "close_fraud_case_ind": { "$ref": "#/components/schemas/VisaCloseFraudCaseInd" } } }, "ReportVisaUpdate": { "type": "object", "description": "Visa report", "properties": { "fraud_type": { "$ref": "#/components/schemas/VisaFraudType" }, "fraud_type_category": { "$ref": "#/components/schemas/VisaFraudTypeCategory" }, "notification_cd": { "$ref": "#/components/schemas/VisaNotificationCd" }, "close_fraud_case_ind": { "$ref": "#/components/schemas/VisaCloseFraudCaseInd" } } }, "ReportVisaCardUpdate": { "type": "object", "description": "Visa card report", "properties": { "fraud_type": { "$ref": "#/components/schemas/VisaFraudType" }, "fraud_type_category": { "$ref": "#/components/schemas/VisaFraudTypeCategory" }, "notification_cd": { "$ref": "#/components/schemas/VisaNotificationCd" }, "close_fraud_case_ind": { "$ref": "#/components/schemas/VisaCloseFraudCaseInd" } } }, "Status": { "type": "string", "description": "Fraud report ststus", "enum": [ "PENDING", "FAILED", "PROCESSED" ], "example": "PENDING" }, "TransactionId": { "type": "number", "description": "Pismo transaction ID.", "example": 1234567890 }, "VisaCloseFraudCaseInd": { "type": "boolean", "description": "Should the case be closed on the Visa's side? Default is `false`.\n", "example": false, "default": false }, "VisaFraudType": { "type": "string", "description": "Visa fraud type:
\n\n `0` - Lost
\n `1` - Stolen
\n `2` - Card not received as issued (NRI)
\n `3` - Fraudulent application (cardholder never applied for the card)
\n `4` - Issuer-reported counterfeit
\n `5` - Miscellaneous
\n `6` - Fraudulent use of account number
\n `A` = Incorrect processing
\n `B` = Account or credentials takeover
\n `C` = Merchant misrepresentation
\n `D` = Manipulation of account holder
\n", "enum": [ "0", "1", "2", "3", "4", "5", "6", "A", "B", "C", "D" ], "example": "0" }, "VisaFraudTypeCategory": { "type": "string", "description": "Visa fraud type category:
\n `CARDTXN` - Card transaction
\n `NRI` - Not received as issued
\n", "default": "CARDTXN", "enum": [ "CARDTXN", "NRI" ], "example": "CARDTXN" }, "VisaNotificationCd": { "type": "number", "description": "Notification code specifying action performed on the fraud report. Domain values:
\n `1`: Addition
\n `2`: Addition of dup
\n `3`: Change
\n `4`: Delete
\n `5`: Reactivate. No edits restricting values based on the value of existing report in case.\n" } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Account access token. Tokens can expire quickly, which can result in an \"Unauthorized\" error.", "bearerFormat": "JWT" } } }, "paths": { "/v2/fraud-report": { "post": { "summary": "Create fraud report", "description": "Create a fraud report.\n\nThis endpoint generates a [Fraud report created](https://developers.pismo.io/events/docs/fraud-report-fraud-report-creation-1) event.\n\n **Note:** This endpoint takes an account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a 401 Unauthorized message.\n", "operationId": "post-v2-fraud-report", "tags": [ "Fraud report" ], "requestBody": { "description": "Fraud report data - fill out and enter one card network object.", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/Fraud_Report_Create_Elo_International" }, { "$ref": "#/components/schemas/Fraud_Report_Create_Elo_National" }, { "$ref": "#/components/schemas/Fraud_Report_Create_Mastercard" }, { "$ref": "#/components/schemas/Fraud_Report_Create_Visa" }, { "$ref": "#/components/schemas/Fraud_Report_Create_Visa_Card" } ] }, "examples": { "Create an Elo National Fraud Report from Transaction": { "value": { "report_type": "elo", "transaction_id": 1234567890, "report": { "fraud_type": "10", "report_date": "2021-02-11", "authorization_origin_indicator": "Y", "notification_code": "1", "card_service_code": "C", "exchange_value": 0, "exchange_indicator": "N" } } }, "Create an Elo International Fraud Report from Transaction": { "value": { "report_type": "elo_international", "transaction_id": 1234567890, "report": { "action": "CREATED", "primary_reason": "CA", "secondary_reason": "BT" } } }, "Create a Mastercard Fraud Report from Transaction": { "value": { "report_type": "mastercard", "transaction_id": 1234567890, "report": { "fraud_type": "00", "acct_status": "ACCT_IS_OPEN", "chgbk_indicator": "0", "cvc_invalid_indicator": "Y", "device_type": "1", "sub_type": "K" } } }, "Create a Visa Fraud Report from Transaction": { "value": { "report_type": "visa", "transaction_id": 1234567890, "report": { "fraud_type": "1", "fraud_type_category": "CARDTXN", "notification_cd": 1, "close_fraud_case_ind": false } } }, "Create a Visa Fraud Report from Card": { "value": { "report_type": "visa_card", "card_id": 102030, "customer_id": 10203040, "report": { "fraud_type": "2", "fraud_type_category": "NRI", "notification_cd": 1, "close_fraud_case_ind": false } } } } }, "application/xml": { "schema": { "type": "object", "properties": {} } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/Fraud_Report_Create_Response_Elo_International" }, { "$ref": "#/components/schemas/Fraud_Report_Create_Response_Elo_National" }, { "$ref": "#/components/schemas/Fraud_Report_Create_Response_Mastercard" }, { "$ref": "#/components/schemas/Fraud_Report_Create_Response_Visa" }, { "$ref": "#/components/schemas/Fraud_Report_Create_Response_Visa_Card" } ] }, "examples": { "Fraud Report from Elo National Transaction": { "value": { "fraud_report_id": 1, "org_id": "TN-123", "status": "PENDING", "network": "Elo", "fraud_report_network_id": "82702030405", "report": { "fraud_type": "10", "report_date": "2021-02-11", "authorization_origin_indicator": "Y", "notification_code": "1", "card_service_code": "C", "exchange_value": 0, "exchange_indicator": "N" }, "created_at": "2024-10-18 11:20:22", "network_authorization_id": 1234567890, "authorization_code": "F0JR9H", "transaction_id": 1234567890, "account_id": 10203040, "card_id": 123456, "report_type": "elo" } }, "Fraud Report from Elo International Transaction": { "value": { "fraud_report_id": 1, "org_id": "TN-123", "status": "PENDING", "network": "Elo", "report": { "action": "CREATED", "primary_reason": "CA", "secondary_reason": "BT" }, "created_at": "2024-10-18 11:20:22", "network_authorization_id": 1234567890, "authorization_code": "F0JR9H", "transaction_id": 1234567890, "account_id": 10203040, "card_id": 123456, "report_type": "elo_international" } }, "Fraud Report from Mastercard Transaction": { "value": { "fraud_report_id": 1, "org_id": "TN-123", "status": "PENDING", "network": "Mastercard", "report": { "fraud_type": "00", "acct_status": "ACCT_IS_OPEN", "chgbk_indicator": "0", "cvc_invalid_indicator": "Y", "device_type": "1", "sub_type": "K" }, "created_at": "2024-10-18T11:20:22.000Z", "network_authorization_id": 1234567890, "authorization_code": "F0JR9H", "transaction_id": 1234567890, "account_id": 10203040, "card_id": 123456, "report_type": "mastercard" } }, "Fraud Report from Visa Transaction": { "value": { "fraud_report_id": 1, "org_id": "TN-123", "status": "PENDING", "network": "Visa", "report": { "close_fraud_case_ind": false, "fraud_type": "0", "fraud_type_category": "CARDTXN", "notification_cd": 1 }, "created_at": "2024-10-18T11:20:22.000Z", "network_authorization_id": 1234567890, "authorization_code": "F0JR9H", "transaction_id": 1234567890, "account_id": 10203040, "card_id": 123456, "report_type": "visa" } }, "Fraud Report from Visa Card": { "value": { "fraud_report_id": 1, "org_id": "TN-123", "status": "PENDING", "network": "Visa", "report": { "close_fraud_case_ind": false, "fraud_type": "2", "fraud_type_category": "NRI", "notification_cd": 1 }, "created_at": "2024-10-18T11:20:22.000Z", "account_id": 10203040, "card_id": 123456, "customer_id": 40506070, "report_type": "visa_card" } } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" }, "examples": { "EDPT0002 - Failed during validation of request payload": { "value": { "code": "EDPT0002", "message": "Failed during validation of request payload", "http_status_code": 400 } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" }, "examples": { "EDPT0005 - Missing or invalid Authorization header": { "value": { "code": "EDPT0005", "message": "Missing or invalid Authorization header", "http_status_code": 401 } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" }, "examples": { "BDPT0006 - Fraud Report [123] not found": { "value": { "code": "BDPT0006", "message": "Fraud Report [123] not found", "http_status_code": 404 } } } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" }, "examples": { "BDPT0007 - Fraud Report already created using transaction_id [123]": { "value": { "code": "BDPT0007", "message": "Fraud Report already created using transaction_id [123]", "http_status_code": 409 } }, "BDPT0007 - Fraud Report already created using card_id [12345]": { "value": { "code": "BDPT0007", "message": "Fraud Report already created using card_id [12345]", "http_status_code": 409 } } } } } }, "422": { "description": "Unprocessable entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" }, "examples": { "BDPT0001 - Error while validating fields": { "value": { "code": "BDPT0001", "message": "Error while validating fields", "http_status_code": 422, "details": { "payload": [ { "field": "transaction_id", "message": "This is field is required" }, { "field": "report_type", "message": "This is an invalid value" } ] } } }, "BDPT0002 - Fraud Report cannot be edited while in PENDING status": { "value": { "code": "BDPT0002", "message": "Fraud Report cannot be edited while in PENDING status.", "http_status_code": 422 } } } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" }, "examples": { "EDPT9999 - Something went wrong, please try again later": { "value": { "code": "EDPT9999", "message": "Something went wrong, please try again later", "http_status_code": 500 } } } } } }, "504": { "description": "Gateway timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" }, "examples": { "EDPT0001 - Request timeout": { "value": { "code": "EDPT0001", "message": "Request timeout", "http_status_code": 504 } } } } } } } } } } } ```