--- updatedAt: 2026-09-16T20:15:51.000Z agentTools: projectIndex: https://docs.dlocal.com/llms.txt --- # Get infraction by ID Returns the details of a Pix infraction and its associated transaction. Use the infraction ID received from infraction notifications or listing endpoints. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "dLocal Bank", "version": "2.1", "description": "dLocal Bank Pix API for merchant Pix operations.\n\n## Security\nEach request must include an HMAC-SHA256 signature in the `Authorization`\nheader.\nSee the [Security](security.md) page for header details and signature\ngeneration examples.\n\n## Environment\nUse sandbox for testing and production for live operations.\nSee the [Environments](environment.md) page for base URLs and credentials.\n" }, "servers": [ { "url": "https://sandbox.dlocal.com/dlocalbank/pix", "description": "Sandbox" }, { "url": "https://api.dlocal.com/dlocalbank/pix", "description": "Production" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "X-Date", "in": "header", "description": "ISO8601 datetime with UTC timezone. E.g. `2018-07-12T13:46:28.629Z`.", "x-default": "" }, "sec1": { "type": "apiKey", "name": "X-Login", "in": "header", "description": "Merchant login credential from the Merchant Dashboard.", "x-default": "" }, "sec2": { "type": "apiKey", "name": "X-Trans-Key", "in": "header", "description": "Transaction key sent along with `X-Login` to authenticate the request.", "x-default": "" }, "sec3": { "type": "apiKey", "name": "Content-Type", "in": "header", "description": "Always set to `application/json`.", "x-default": "application/json" }, "sec4": { "type": "apiKey", "name": "X-Version", "in": "header", "description": "Current API version number.", "x-default": "2.1" }, "sec5": { "type": "apiKey", "name": "User-Agent", "in": "header", "description": "Identifies the requesting software user agent.", "x-default": "" }, "sec6": { "type": "apiKey", "name": "Authorization", "in": "header", "description": "Signature header with format: V2-HMAC-SHA256, Signature: {hmac(secretKey, X-Login + X-Date + RequestBody)}", "x-default": "" } } }, "security": [ { "sec0": [], "sec1": [], "sec2": [], "sec3": [], "sec4": [], "sec5": [], "sec6": [] } ], "paths": { "/dlocalbank-merchantpixapi/infraction/{id}": { "get": { "tags": [ "Infraction" ], "summary": "Get infraction by ID", "description": "Returns the details of a Pix infraction and its associated transaction.\n\nUse the infraction ID received from infraction notifications or listing\nendpoints.\n", "operationId": "get-infraction-by-id", "parameters": [ { "name": "id", "in": "path", "description": "Unique identifier of the infraction.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"infraction\": {\n \"amount\": \"150.00\",\n \"analysis_status\": \"PENDING\",\n \"creation_date\": \"2026-08-24T12:00:00Z\",\n \"details\": \"Suspected fraud reported by payer PSP\",\n \"infraction_id\": \"INF-123456789\",\n \"due_date\": \"2026-09-01T23:59:59Z\",\n \"reason\": \"FRAUD\",\n \"status\": \"OPEN\"\n },\n \"transaction\": {\n \"value\": \"150.00\",\n \"end_to_end_id\": \"E12345678202608241200000000001\",\n \"payment_id\": \"PAY-987654321\",\n \"payment_merchant_id\": \"MERCH-001\",\n \"payer\": {\n \"account\": {\n \"account_number\": \"1234567\",\n \"account_type\": \"CACC\",\n \"branch\": \"0001\"\n },\n \"name\": \"John Doe\",\n \"psp\": {\n \"ispb\": \"12345678\",\n \"name\": \"Payer Bank\"\n },\n \"tax_id\": \"12345678901\"\n },\n \"receiver\": {\n \"account\": {\n \"account_number\": \"7654321\",\n \"account_type\": \"CACC\",\n \"branch\": \"0001\"\n },\n \"address_key\": \"merchant@email.com\",\n \"psp\": {\n \"ispb\": \"87654321\",\n \"name\": \"Receiver Bank\"\n },\n \"tax_id\": \"98765432100\"\n }\n }\n}" } }, "schema": { "type": "object", "properties": { "infraction": { "type": "object", "properties": { "amount": { "type": "string" }, "analysis_status": { "type": "string" }, "creation_date": { "type": "string" }, "details": { "type": "string" }, "infraction_id": { "type": "string" }, "due_date": { "type": "string" }, "reason": { "type": "string" }, "status": { "type": "string" } } }, "transaction": { "type": "object", "properties": { "value": { "type": "string" }, "end_to_end_id": { "type": "string" }, "payment_id": { "type": "string" }, "payment_merchant_id": { "type": "string" }, "payer": { "type": "object", "properties": { "account": { "type": "object", "properties": { "account_number": { "type": "string" }, "account_type": { "type": "string" }, "branch": { "type": "string" } } }, "name": { "type": "string" }, "psp": { "type": "object", "properties": { "ispb": { "type": "string" }, "name": { "type": "string" } } }, "tax_id": { "type": "string" } } }, "receiver": { "type": "object", "properties": { "account": { "type": "object", "properties": { "account_number": { "type": "string" }, "account_type": { "type": "string" }, "branch": { "type": "string" } } }, "address_key": { "type": "string" }, "psp": { "type": "object", "properties": { "ispb": { "type": "string" }, "name": { "type": "string" } } }, "tax_id": { "type": "string" } } } } } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "example": "401" }, "message": { "type": "string", "example": "Unauthorized" } } } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "example": "4003" }, "message": { "type": "string", "example": "Access denied" } } } } } }, "500": { "description": "Internal Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "example": "7000" }, "message": { "type": "string", "example": "Internal Error" } } } } } } }, "deprecated": false, "x-readme": { "code-samples": [ { "language": "shell", "code": "curl -X GET \\\n -H 'X-Date: {X-Date}' \\\n -H 'X-Login: {X-Login}' \\\n -H 'X-Trans-Key: {X-Trans-Key}' \\\n -H 'X-Version: 2.1' \\\n -H 'User-Agent: MerchantTest / 1.0 ' \\\n -H 'Authorization: V2-HMAC-SHA256, Signature: {Signature}' \\\n https://sandbox.dlocal.com/dlocalbank/pix/dlocalbank-merchantpixapi/infraction/{id}" } ], "samples-languages": [ "shell" ] } } } } } ```