> ## Documentation Index > Fetch the complete documentation index at: https://waffo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Reported Fraud list > Query the fraud reports the card schemes raised against your transactions, filtered by fraud report date, card scheme and acquiring order Id. Reported fraud is the card scheme's own fraud signal and is independent of chargebacks: a reported transaction may never be charged back, and a chargeback may exist without a fraud report — use the Chargeback list API for chargebacks. The query range must not exceed 3 months. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/fraud-report/list openapi: 3.1.0 info: title: acquiring-order description: 接口文档 termsOfService: https://www.waffo.com version: 1.0.0 servers: [] security: [] tags: - name: Subscription inquiry description: Subscription inquiry api description - name: Subscription manage description: > This API allows the merchant to request a subscription management URL from Waffo Waffo will generate a subscription management URL which merchant can redirect user to this URL for managing subscription details (e.g. view subscription detail and cancel subscription). This management URL has a fixed expiration time (e.g., 1 day). - name: Subscription change inquiry description: > This API allows merchants to query the status of a subscription change (upgrade/downgrade) request. 此接口允许商户查询订阅升降级请求的状态。 - name: Subscription update description: ' Subscription update api description' - name: Order inquiry description: Order inquiry api description - name: Payout inquiry description: Payout inquiry api description - name: Order create description: ' Order create api description' - name: Pay Method Config Inquiry description: Pay Method Config Inquiry api description - name: Order cancel description: Order cancel api description - name: Order capture description: Order capture api description - name: Chargeback list description: Chargeback list api description - name: Payout create description: Payout create api description - name: Chargeback file download description: Chargeback file download api description - name: Subscription change description: > This API allows merchants to upgrade or downgrade a user's subscription plan. The change request will create a new subscription based on the original subscription, applying any remaining amount from the original subscription. 此接口允许商户升级或降级用户的订阅计划。升降级请求将基于原订阅创建新订阅，并将原订阅的剩余金额应用到新订阅中。 - name: Chargeback accept description: Chargeback accept api description - name: Chargeback file upload description: Chargeback file upload api description - name: Chargeback update description: Chargeback update api description - name: Wallet inquiry description: Wallet inquiry api description - name: Order refund description: Order refund api description - name: Refund inquiry description: Refund inquiry api description - name: Subscription cancel description: > Cancel an active subscription when the merchant no longer wishes to continue the recurring billing cycle. This endpoint can only be invoked when the subscription status is active - name: Merchant config inquiry description: Merchant config inquiry api description - name: Chargeback inquiry description: Chargeback inquiry api description - name: Subscription create description: Subscription create api description - name: Reported Fraud list description: Reported Fraud list api description paths: /api/v1/fraud-report/list: post: tags: - Reported Fraud list summary: Reported Fraud list description: >- Query the fraud reports the card schemes raised against your transactions, filtered by fraud report date, card scheme and acquiring order Id. Reported fraud is the card scheme's own fraud signal and is independent of chargebacks: a reported transaction may never be charged back, and a chargeback may exist without a fraud report — use the Chargeback list API for chargebacks. The query range must not exceed 3 months. operationId: fraudReportList requestBody: content: application/json: schema: $ref: '#/components/schemas/FraudReportListRequest' required: true responses: '200': description: OK content: '*/*': schema: $ref: >- #/components/schemas/ResponseApiPageResponseFraudReportResponse components: schemas: FraudReportListRequest: type: object description: Reported Fraud list request properties: merchantId: type: string default: '1000000201' description: Merchant Id assigned by Waffo example: 1000000201 maxLength: 64 minLength: 0 paymentMethod: type: array description: >- Card scheme filter. Pass VISA, MASTERCARD or both; a record matches when its card scheme is any of the values passed. Optional — omit it to return all card schemes items: type: string acquiringOrderId: type: string description: >- Waffo acquiring order Id filter, to retrieve the fraud reports of a single transaction. Optional — omit it to return every transaction in the date range maxLength: 64 minLength: 0 startDate: type: string format: date description: >- Start of the query range, inclusive. Filters on fraudReportDate, not on the original transaction time. Format yyyy-MM-dd. The range must not exceed 3 months example: '2026-01-01' endDate: type: string format: date description: >- End of the query range, inclusive. Filters on fraudReportDate, not on the original transaction time. Format yyyy-MM-dd. The range must not exceed 3 months example: '2026-03-28' pageNum: type: integer format: int32 description: Page number to retrieve, starts from 1 example: 1 pageSize: type: integer format: int32 description: Number of records per page, between 1 and 100 example: 20 required: - endDate - merchantId - pageNum - pageSize - startDate ResponseApiPageResponseFraudReportResponse: type: object description: response data properties: code: type: string example: 0 msg: type: string example: success data: $ref: '#/components/schemas/ApiPageResponseFraudReportResponse' ApiPageResponseFraudReportResponse: type: object description: Paged data properties: records: type: array description: >- Records of the current page, empty array when nothing matches the query items: $ref: '#/components/schemas/FraudReportResponse' total: type: integer format: int64 description: Total number of records matching the query example: 125 size: type: integer format: int64 description: Page size, echoes pageSize in the request example: 20 current: type: integer format: int64 description: Current page number, starts from 1 example: 1 pages: type: integer format: int64 description: Total number of pages, derived from total and size example: 7 FraudReportResponse: type: object description: >- A fraud report raised by the card scheme against one of your transactions. Reported fraud is the card scheme's own fraud signal and is independent of chargebacks: a reported transaction may never be charged back, and a chargeback may exist without a fraud report. properties: acquiringOrderId: type: string description: >- Waffo acquiring order Id, i.e. the transaction this fraud was reported against. Use it with the order inquiry API to retrieve the full order merchantUserId: type: string description: Merchant user id of the user who made the reported transaction transactionDateTime: type: string description: >- The time of the original transaction, always earlier than fraudReportDate. ISO 8601 with millisecond precision, in UTC, e.g. 2026-04-01T03:00:00.000Z paymentRequestId: type: string description: >- Payment request ID sent from merchant when the reported order was created. Returned for non-subscription payments only — it and subscriptionId are mutually exclusive subscriptionId: type: string description: >- The associated Waffo subscription ID. Returned for subscription payments only — it and paymentRequestId are mutually exclusive merchantSubscriptionId: type: string description: >- Merchant subscription plan ID assigned to this user. Returned for subscription payments only fraudReportDate: type: string description: >- The time the card scheme reported the fraud. This is the field that the startDate and endDate filters apply to. ISO 8601 with millisecond precision, in UTC, e.g. 2026-04-01T03:00:00.000Z fraudAmount: type: string description: >- Fraud amount reported by the card scheme, in fraudCurrency. May differ from orderAmount fraudCurrency: type: string description: >- Fraud amount currency, ISO 4217, e.g. USD. May differ from orderCurrency orderAmount: type: string description: Amount of the original transaction, in orderCurrency orderCurrency: type: string description: Original transaction amount currency, ISO 4217, e.g. IDR fraudReason: type: string description: Fraud reason returned by the card scheme, e.g. Account takeover fraudReasonCode: type: string description: >- Fraud reason code returned by the card scheme. The code is scheme-specific, e.g. VI:6 for Visa or MC:5 for Mastercard paymentMethod: type: string description: >- Card scheme of the reported transaction, VISA or MASTERCARD. Same value set as the paymentMethod filter in the request cardType: type: string description: >- Card type of the reported transaction, e.g. Credit, Debit, Prepaid. Unknown when the card scheme did not report it cardMaskedNo: type: string description: >- Masked card number of the reported transaction. Only the masked value is ever returned; Waffo does not expose the full card number ````