> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pix (Brasil)

Localpayment permite a los comercios procesar pagos instantáneos a través del sistema Pix de Brasil, la revolucionaria plataforma de pagos instantáneos desarrollada por el Banco Central de Brasil. Esta guía describe el proceso para iniciar pagos Pix mediante la API de Localpayment, detallando los parámetros necesarios, el manejo de las respuestas y la interpretación de los códigos de estado para una integración perfecta con la infraestructura de pagos en tiempo real de Brasil.

Pix es el sistema de pagos instantáneos de Brasil, desarrollado por el Banco Central de Brasil (BCB). Permite a particulares y empresas enviar y recibir pagos en segundos, las 24 horas del día, los 365 días del año.

Localpayment admite dos métodos de pago principales para Pix:

* **Código QR de Pix:** Los clientes escanean un código QR dinámico con su aplicación bancaria.
* **Pix Copiar y Pegar (Copia e Cola):** Los clientes copian un código Pix y lo pegan en su aplicación bancaria o de billetera digital para iniciar la transferencia.

Ambos métodos utilizan el mismo endpoint de la API y proporcionan una experiencia de pago rápida y segura.

## Antes de comenzar

Asegúrate de tener:

* [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md) válidas (token de acceso).

***

## Paso 1. Crear pago con Pix

Para generar un pago Pix para tu cobro en Brasil, envía una solicitud `POST` al endpoint [Crear Payin](https://docs.localpayment.com/es/reference/payins.md) con parámetros específicos de Pix.

### Parámetros clave de la solicitud

La solicitud requiere varios objetos clave específicos para los pagos mediante código QR:

| Objeto | Descripción | Requerido |
| - | - | - |
| `paymentMethod.type` | Debe ser `BankTransfer`. | ✅ |
| `paymentMethod.code` | Utiliza `1314` para Pix. | ✅ |
| `sender` | Información del remitente para fines de cumplimiento. | ✅ |
| `merchant` | Datos del comerciante/negocio. | ✅ |
| `paymentMethod` | Configuración del método de pago. | ✅ |
| `amount` | Importe de la transacción. | ✅ |
| `currency` | Código de moneda de la transacción. | ✅ |
| `country` | Debe ser `BRA`. | ✅ |

Consulta todos los [parámetros disponibles](https://docs.localpayment.com/es/reference/payins.md) en la solicitud.

> [!NOTE]
>
> **Mismo endpoint para ambos métodos:** Esta única solicitud a la API se utiliza para generar un pago tanto para **Código QR de Pix como para Pix Copiar y Pegar (Copia e Cola)**. El método que utilice el cliente dependerá de cómo se presenten los detalles de pago que se devuelvan en la respuesta.

### Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza `curl`:

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/payin/ \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'content-type: application/json' \
     --data '
{
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1314",
    "flow": "DIRECT"
  },
  "currency": "USD",
  "merchant": {
    "type": "COMPANY",
    "document": {
      "type": "",
      "id": ""
    },
    "name": "Company",
    "email": ""
  },
  "payer": {
    "type": "INDIVIDUAL",
    "document": {
      "id": "75.518.609/0001-56",
      "type": "CNPJ"
    },
    "bank": {
      "account": {
        "type": "C"
      }
    },
    "name": "John",
    "lastname": "Doe"
  },
  "externalId": "3d3b3e1d-c234-4fde-8e87-cd61b7dde3cf",
  "country": "BRA",
  "amount": 1000,
  "accountNumber": "{{accountNumber}}",
  "conceptCode": "0003",
  "comment": "Any relevant information related to the transaction"
}
'
```

***

## Paso 2. Gestionar la respuesta.

### Respuesta exitosa

La creación exitosa de un pago con Pix incluye los datos del código Pix y los detalles del pago:

```json QR theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "3d3b3e1d-c234-4fde-8e87-cd61b7dde3cf",
  "internalId": "7e57a8ed-7fa4-4264-bcf3-a44d3ff2c132",
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1314",
    "flow": "DIRECT"
  },
  "country": "BRA",
  "currency": "USD",
  "amount": 1000,
  "accountNumber": "{{accountNumber}}",
  "confirmed": {
    "currency": "USD",
    "amount": 1000,
    "fxQuote": 1,
    "exchangeRateToken": null
  },
  "payment": {
    "installment": null,
    "currency": "BRL",
    "fxQuote": 4.96637604,
    "financingFee": 0,
    "amount": 4966.38
  },
  "localTaxes": [],
  "withHoldings": [],
  "fees": {
    "description": "Fee",
    "currency": "USD",
    "fxSource": 1,
    "fxQuote": 1,
    "amount": 11,
    "account": "{{accountNumber}}"
  },
  "status": {
    "code": "100",
    "description": "INPROGRESS",
    "detail": "The payin is pending the confirmation"
  },
  "ticket": null,
  "qr": {
    "image": "https://api.stage.localpayment.com/api/images/1314/00020126580014br.gov.bcb.pix013627a44d0a-0736-4bbf-a4a4-6e11063973315204000053039865406150.005802BR5911Telequiet496008Campinas62230519mpqrinter12397252666304FA23",
    "code": "00020126580014br.gov.bcb.pix013627a44d0a-0736-4bbf-a4a4-6e11063973315204000053039865406150.005802BR5911Telequiet496008Campinas62230519mpqrinter12397252666304FA23",
    "codeBase64": "iVBORw0KGgoAAAANSUhEUgAABWQAAAVkAQAAAAB79iscAAAI/UlEQVR42u3dW47kNgwFUO3A+9+ld6Agg3nY4pVcnQyCjHz80ejuKstH/iNIka3/QdfZaGlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWlpaWl/v7aN13H/37c/f/z4+9b2/bYff367vn/w68/+88u/7mjXL18XODKDlpaWlpaWlpaWlpb2JdrjGrLdv3Z5WPHcFMMCw06vq/Trp1ftgkFLS0tLS0tLS0tLS7u9tqx+U1x/O37+eYv/Upw4hJzTe4dPC56WlpaWlpaWlpaWlval2vKV4x4xnjlOvG534LWAP8rytLS0tLS0tLS0tLS0tDfAWeohr8m+VLbZSmHmNRatiz69NFpaWlpaWlpaWlpa2hdoEz5l6K7POUINZS/pwenBuultX64RpaWlpaWlpaWlpaWl/dO16zX/sx//oqcKLS0tLS0tLS0tLS3tn6xdXyWo7LOjc8Nv6TTcrTfJkCNcXLS0tLS0tLS0tLS0tLtrU13lWfJ3w/G3KzmFobVfSSnlvHWPLI88aGlpaWlpaWlpaWlpX6O9ua9R36q9Y4kOp7x+33MvslTU+UnMS0tLS0tLS0tLS0tLu4t22tlx0m5k2pQ/D1UbDtadoanJpGElLS0tLS0tLS0tLS3tK7Q5/hsCvrZIzl0j0LOcqUvRZglcz4WblpaWlpaWlpaWlpZ2f21as85Jy1WSLe8l/cjb7WWQwENPFVpaWlpaWlpaWlpa2v20Na4b/pfTdJPnlMYjdSpb6k2SlqelpaWlpaWlpaWlpX2JNs2qTu7pYyedIqdNIhfNJJ+rLmlpaWlpaWlpaWlpaXfTpoBvGicucnq1hjKffGuzAQFtHobS0tLS0tLS0tLS0tLurB1Or5X7p/WXfTZZra5Xkoe1CcowQ+ChSwktLS0tLS0tLS0tLe1G2pJM6/eV2r3xSMsdJa+84x6VnvcAclJm+WHVJS0tLS0tLS0tLS0t7X7aHM2t83KpwrKWY5YoMo0PaLlr5XOXElpaWlpaWlpaWlpa2l20w7PLubihXeQRkoItn6TLBZwr3ic1orS0tLS0tLS0tLS0tLtpS/7uKLemKDL3F5lEgqn+sjzjKzWitLS0tLS0tLS0tLS0G2lLIu7MA7DLhOrJ4bg0d620i+xlKHY+OkdLS0tLS0tLS0tLS/sCbSmLPMJxteHU3BnqKlf4FIGWB9XXR0tLS0tLS0tLS0tL+xLtUUK6aZg3XOXk21FqN4dNpkg1PW0eRdLS0tLS0tLS0tLS0m6pLcZjUTQ5PPGjWWz1TF3a6SyopKWlpaWlpaWlpaWl3VlbHtszPlP6PWKsI9eK5yzH38qen2pEaWlpaWlpaWlpaWlpt9Km3iS5LUm7H2troVXJLX9XVpkkFKd1n7S0tLS0tLS0tLS0tC/Rtrxw0uZ03qTfZFmql/xd2kuJaGlpaWlpaWlpaWlpaffWJnIOKofzbimdV79XQsSWyyzTArS0tLS0tLS0tLS0tK/THqEE8pwp6oG5Yanp//LT+mczu2lpaWlpaWlpaWlpaffTnovQb5H7O4LieC6pbM9x5zKKpKWlpaWlpaWlpaWl3VKbB63dPi2H3lILkn5vz3+GKWrpnN0Xo0haWlpaWlpaWlpaWtqttLn68Qgj0vqikclwb9rz0NIkLfUcRdLS0tLS0tLS0tLS0u6nTXFi5k1GrqWQM4WD5XBczzWeH8a8tLS0tLS0tLS0tLS0+2h7iRiHPiTlERWVo8gjJ+yG3U9LL2lpaWlpaWlpaWlpaV+hLWfWUly3gg45wuv3esnzfVTZeY7vi5aWlpaWlpaWlpaWdmdtSuxdw8FhqNrQZCTtKk1gSzut/0u9JWlpaWlpaWlpaWlpaXfXLuoge+goOQ34ztbS2bYSVKaotC/mYdPS0tLS0tLS0tLS0u6uTUWTJUTsuVF/LpUc9jJ0PenlJF3JLz5l92hpaWlpaWlpaWlpabfSpjrIEv+dT0WTeYJ2rewsib360mhpaWlpaWlpaWlpaV+mTXWVTzFhK0WYZWupTvPIsn9WI0pLS0tLS0tLS0tLS7uLdhr/XaO+dGDuCDFmm3fmf8SnEk1aWlpaWlpaWlpaWtoXaEsA2RYRY9pBCv2GVfr9mhZwpndIS0tLS0tLS0tLS0u7u3YRDq4ekXaw2O6Kd909LS0tLS0tLS0tLS3ta7UD6pjVRh73bFydmz14cvLwDOnBYRgALS0tLS0tLS0tLS3tW7RTynAk7ikcPJepwBoslrnZ/f6COi0tLS0tLS0tLS0t7Uu0w4cp6lscmEtTsHOGrqXbyl6es3u0tLS0tLS0tLS0tLT7aSdPTOfT0ti01G6kRIwtfDD58iczCGhpaWlpaWlpaWlpabfSthIn5gb8PRdclhrKX6u0WZ3mcf3K8KCS9qOlpaWlpaWlpaWlpd1bO9w/5S0ScekRtZ4zHbsrJZ/9umdaWlpaWlpaWlpaWtqXaPvy9FpfNB6Z1mRO03nlLdXzc8uqS1paWlpaWlpaWlpa2v201xtSR5JUelnbjaTKyfxGjjA04OkkHS0tLS0tLS0tLS0t7Qu0bTGN+vqVyZm1YX9PAWQvg7K/FkXS0tLS0tLS0tLS0tJupE3X9DTcFLXoXDJsfN2csrUWajdpaWlpaWlpaWlpaWl31pYoroaNQ4SXdpXwOe3XS4OS1LTkOealpaWlpaWlpaWlpaXdR/uYzptm3p46/admkq3FFikfR5G0tLS0tLS0tLS0tLRbanPCLtVaplRgC5WTdZTadCpbDmEPWlpaWlpaWlpaWlraV2trG/+SjauPWESWRxm3Pc0MPmf3aGlpaWlpaWlpaWlpX6CtJ9oWg617Sc6V2PEs89nyGO0eJwfQ0tLS0tLS0tLS0tJury2o4RF1FPZASZnBReP/YeXbq3qOImlpaWlpaWlpaWlpaTfT1sLHFPXlELHlw2yLrQ1v6bzvoC5KS0tLS0tLS0tLS0u7u/b/f9HS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS/jbtX2Pf+2+J1zMMAAAAAElFTkSuQmCC",
    "expirationDate": "2022-08-13T12:28:09.695-04:00"
  },
  "beneficiary": null,
  "merchant": {
    "type": "COMPANY",
    "name": "Company",
    "document": {
      "id": "",
      "type": ""
    },
    "email": "",
    "phone": {
      "countryCode": "",
      "areaCode": "",
      "number": ""
    },
    "address": {
      "street": "",
      "number": "",
      "city": "",
      "state": "",
      "country": "",
      "zipCode": "",
      "comment": "Any relevant information related to the transaction"
    },
    "birthdate": "",
    "nationality": ""
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "John",
    "lastname": "Doe",
    "document": {
      "id": "75.518.609/0001-56",
      "type": "CNPJ"
    },
    "email": "",
    "phone": {
      "countryCode": "",
      "areaCode": "",
      "number": ""
    },
    "address": {
      "street": "",
      "number": "",
      "city": "",
      "state": "",
      "country": "",
      "zipCode": ""
    },
    "birthdate": "",
    "nationality": ""
  },
  "intermediaries": null,
  "wireInstructions": null,
  "date": {
    "creationDate": "2025-02-19T20:57:50.253+00:00",
    "processedDate": "2025-02-19T20:57:50.507088",
    "expirationDate": "2025-02-21T20:57:50.507088"
  },
  "card": null,
  "errors": []
} 
```

```json Copia e Cola theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
    "transactionType": "PayIn",
    "externalId": "18c12cfb-a4ea-c0bd-983b-51ac394a7439",
    "internalId": "8d9c5ae3-929d-105b-c59d-1c59e3096688",
    "paymentMethod": {
        "type": "BankTransfer",
        "code": "1314",
        "flow": "DIRECT"
    },
    "country": "BRA",
    "currency": "BRL",
    "amount": 1000.0,
    "accountNumber": "{{accountNumber}}",
    "confirmed": {
        "currency": "BRL",
        "amount": 1000.0,
        "fxQuote": 1.0
    },
    "payment": {
        "currency": "BRL",
        "fxQuote": 1.0,
        "financingFee": 0.0,
        "amount": 1000.0
    },
    "localTaxes": [
        {
            "code": "0028",
            "percentage": 3.5,
            "description": "NUEVO IOF",
            "currency": "BRL",
            "fxSource": 5.388318,
            "fxQuote": 0.0,
            "amount": 35.0,
            "account": "{{accountNumber}}"
        }
    ],
    "withHoldings": [],
    "fees": {
        "description": "Fee",
        "currency": "BRL",
        "fxSource": 5.388318,
        "fxQuote": 1.0,
        "amount": 0.0,
        "account": "{{accountNumber}}"
    },
    "status": {
        "code": "100",
        "description": "INPROGRESS",
        "detail": "The payin is pending the confirmation"
    },
    "qr": {
        "image": "https://api.stage.localpayment.com/api/images/QR/00020101021226880014br.gov.bcb.pix2566qrcode-h.fitbank.com.br%2FQR%2Fcob%2FC5F29B1D537A2040C62359BA425F7D5B09B5204000053039865802BR5912Localpayment6008CAMPINAS61081310582262070503%2A%2A%2A630475C7",
        "code": "00020101021226880014br.gov.bcb.pix2566qrcode-h.fitbank.com.br/QR/cob/C5F29B1D537A2040C62359BA425F7D5B09B5204000053039865802BR5912Localpayment6008CAMPINAS61081310582262070503***630475C7",
        "codeBase64": "iVBORw0KGgoAAAANSUhEUgAAAMgAAADIAQAAAACFI5MzAAAC4klEQVR4Xu2XMc7bMAyFaWjQZl9AgK6hTVdyLuDYF4ivpE3XMKAL2JsGwexjij9Oi3aIBBQdfiFIYn1B6JDU4wvx3xb9vvFa3+SbyPqXJFCXC3l1+nJjXiORbiCRj8CzVrNTD1dGbbHTQOiWt9Hx6WgI9tSmayRhI0/3YBfeet9Msj09z2TIl4EbCR8xsQRBUk3Hv2TnY4L6RHO7Hr9U7mOCldPC9mCLKu3+51YtCTTSdo94tqcr95AeAmtJNpOzs+M1IBnb5O36lYMaEjbEmXS5RfUg02V0ZQPJKAgN8ma7B3Vq6lsIq5kSYBft7rZR895CgplIsoimvmVcm943ELZLNkNQKz7i1e54+cpoDcnmHkwvYqCOqFamoYUEfDd6x0Jjdo++tkcLyfah0Ttp19vopXeuTqwgEXuli+mIuHe7hPTqxBrC6fQ0+jLpbYCguisHNSQkXEH5iNLpkIO33qkg2SKpeH3oQsQPr96y8zmJG5GCtOxEkza3cN11DZGjRkNGX6sD0qJLE+GCidH755nzpteShgZi7ngrcUBEZq44FSSjMpg/ZSTqibqATDSQ5zmDBiwyOnjNfNWngiCOL9B4aPPpZeSOb3fwOSk9ld49vYmIlp1fcSqIFFmm0IThw+bdodQQDAoHI4CDq3BiDkhpG5k9dFTKsuMc++3q+ArCdsV4hETphF9/vmlVDYl2pkIOMB3BkDbXHVQQ5hNjltPuCA2+ZF5lr5aISdw6eAovskf6rXcqSOCTYCswxCDJCHLloIbARHhCRjG9V5YcvHxiFYGIliHbNdhd0x05aCHBHhmeAjpqH26biPAPoJ5gRVQ7iU/0Uqu3an9OICpIqlcLDOwzBy+tqiHw15AEBxsrXhga//JiVYRuUbQKaopmhJq+eqeSYOw4PhDH4xK2opGg+3DUEnRr95ZlVRPYavwjQRycYIjf5a9riNRHPOwQ4KHEeF5uo4L8eX2TbyLrfyY/AFFaGvzwyar/AAAAAElFTkSuQmCC",
        "expirationDate": "2026-01-15T23:59:59",
        "paymentInstructions": "<div><b>Two ways to pay:</b></div><div><ul><li>Scan the QR code:</li></ul></div><div>Open your bank app → Scan → Pay</div><div>-OR-</div><div><ul><li>Copy &amp; paste (“Copia e Cola”)</li></ul></div><div>Copy “Copia e Cola” ID→ Open your bank app → Paste → Pay</div>"
    },
    "merchant": {
        "type": "COMPANY",
        "name": "Merchant",
        "document": {
            "type": "CNPJ",
            "id": "34669130000133"
        },
        "email": "info@email.com"
    },
    "payer": {
        "bank": {
            "name": "Bank name",
            "code": "341",
            "branch": {
                "code": "0004",
                "name": "Santander"
            },
            "account": {
                "type": "s",
                "number": "000000000"
            }
        },
        "type": "COMPANY",
        "name": "Payer Name",
        "lastname": "BRASIL",
        "document": {
            "type": "CNPJ",
            "id": "34669131234567"
        },
        "email": "user@example.com"
    },
    "intermediaries": [],
    "date": {
        "creationDate": "2026-01-08T15:01:33.44+00:00",
        "processedDate": "2026-01-08T15:01:37.6484808",
        "expirationDate": "2026-01-15T23:59:59"
    },
    "paymentInstructions": "<div><b>Two ways to pay:</b></div><div><ul><li>Scan the QR code:</li></ul></div><div>Open your bank app → Scan → Pay</div><div>-OR-</div><div><ul><li>Copy &amp; paste (“Copia e Cola”)</li></ul></div><div>Copy “Copia e Cola” ID→ Open your bank app → Paste → Pay</div>",
    "errors": []
}
```

### Campos de respuesta clave

| Parámetro | Descripción | Caso de uso |
| - | - | - |
| `qr.image` | Imagen PNG del código QR codificada en Base64. | Visualización directa sin generación adicional. |
| `qr.code` | Carga útil Raw Pix en estándar EMVCo. | Esta cadena de texto se puede mostrar como un código QR o presentarse como un código de texto para que el cliente lo copie y pegue en su aplicación bancaria (Copia e Cola). |
| `qr.codeBase64` | Carga útil QR alternativa codificada en base64. | Copia de seguridad para la representación personalizada de códigos QR. |
| `qr.expirationDate` | Marca de tiempo en la que el código QR deja de ser válido. | Muestra un temporizador de cuenta regresiva y gestiona la lógica de expiración. |
| `externalId` | Tu número de referencia original. | Conciliación interna y cotejo de pedidos. |
| `status.code` | Estado actual de la transacción (`100` = `INPROGRESS`) | Determinar los siguientes pasos en el flujo de pagos. |
| `date.creationDate` | Cuando se creó la transacción. | Análisis y seguimiento del rendimiento. |

#### Respuesta de error

Cuando falle la generación del pago Pix para Brasil, recibirás información de error específica:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "ce0aaa1a-4532-43b9-930a-26e780aba99b",
  "status": {
    "code": "812",
    "description": "REJECTED"
  },
  "errors": [
    {
      "code": "812",
      "detail": "External Id already used - duplication"
    }
  ]
}
```

***

## Paso 3. Presenta el pago con Pix.

Puedes presentar el pago de Pix a tu cliente de dos maneras. La respuesta de la API proporciona los datos necesarios para ambas.

### Opción A: Mostrar como código QR

1. **Generar el código QR:** Utiliza la cadena del campo `qr.code` de la respuesta de la API para generar una imagen de código QR escaneable con cualquier biblioteca de QR.
2. **Escaneo por parte del cliente:** El cliente escanea el código QR con su aplicación bancaria.
3. **Autorizar:** El cliente confirma los detalles del pago y autoriza la transferencia dentro de su aplicación.
4. **Confirmación en tiempo real**: Localpayment recibe una notificación de pago instantánea.
5. **Actualización de estado**: Tu sistema recibe un webhook con la confirmación del pago.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/394b3fdfbeba2cbacc7141ef18cf19061ddf9e2eefee79d1502da0f5c88e50a8-qr-bra.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=eb4f15fb05d974faad84ea221108773d)

#### Mejores prácticas para la visualización de códigos QR

* Tamaño mínimo de pantalla: 250x250 píxeles para escaneo móvil.
* Mantén una relación de aspecto de 1:1 sin distorsión.
* Asegúrate de que haya un alto contraste (fondo oscuro sobre fondo claro).
* Agrega una zona de silencio (borde blanco) alrededor del código QR.
* Incluye texto alternativo (por ejemplo, "Pago mediante código QR").
* Mostrar instrucciones de pago claras.
* Gestionar el tiempo de vida (TTL) y la expiración.

### Opción B: Mostrar como un código para copiar y pegar (Copia e Cola)

1. **Presentar el código:** Muestra a tu cliente la cadena completa del campo `qr.code` como texto seleccionable.
2. **Copia y pega por parte del cliente:** El cliente copia el código completo y abre su aplicación bancaria o de billetera digital.
3. **Pegar y pagar:** El cliente pega el código en el campo "Pagar con código Pix" o similar de la aplicación para cargar los detalles del pago.
4. **Autorizar:** El cliente revisa y autoriza la transferencia.
5. **Confirmación en tiempo real**: Localpayment recibe una notificación de pago instantánea.
6. **Actualización de estado**: Tu sistema recibe un webhook con la confirmación del pago.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/ea6d8e8edff3b9c964eeeb700f2ed6cdcbf8c9354f5f6cf375304cc02bb5e0f0-pix-copia-e-cola.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=dbc93d945dba5d5dbbc37fede1827bcb)

***

## Paso 4. Seguimiento del estado de la transacción

Supervisa el progreso de tu pago a Pix mediante estos métodos:

> [card] [Webhooks (recomendado)](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Recibe notificaciones en tiempo real cuando cambie el estado de la transacción. Más eficiente para entornos de producción.

> [card] [Endpoint de la API de estado](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Consulta el estado de las transacciones mediante programación. Útil para sondear o recuperar notificaciones de webhook perdidas.

> [card] [Vista del Business Portal](https://docs.localpayment.com/es/docs/dashboard-overview.md)
>
> Interfaz visual para el seguimiento de transacciones. Ideal para la supervisión manual y el análisis detallado de las transacciones.

### Códigos de estado comunes

La API de Localpayment proporciona varios códigos de estado para indicar el progreso y el resultado del pago en la respuesta.

| Código | Estado | Descripción |
| :- | :- | :- |
| `103` | `APPROVED` | El payin se confirmó, pero aún no se ha abonado. |
| `200` | `Completed` | El payin se ha completado. |
| `811` | `Rejected` | La cantidad solicitada es mayor o menor que los valores máximos/mínimos permitidos. |

> [!NOTE]
>
> **Referencia completa**
>
> Consulta todos los códigos de estado en nuestra [documentación sobre el estado de las transacciones](https://docs.localpayment.com/es/reference/transaction-status-error-codes).

***

## Probando tu integración

### Entorno de pruebas

Utiliza el entorno de prueba para realizar las pruebas:

```
https://api.stage.localpayment.com/api/payin/
```

### Escenarios de prueba con QR

Verifica que tu integración gestione estos escenarios:

1. **Pago exitoso**: Pago de Pix completado con liquidación instantánea.
2. **Caducidad del código QR**: Gestiona correctamente los pagos Pix caducados.
3. **Múltiples intentos de pago**: Se escaneó el mismo código QR varias veces.
4. **Actualizaciones de estado**: Gestión de webhooks y sondeo de estado.

***

## Próximos pasos

Tras implementar los pagos de Pix, ten en cuenta estas funcionalidades adicionales:

> [card] [Reembolsar la transacción](https://docs.localpayment.com/es/docs/refund-apm-payment.md)
>
> Si es necesario, puedes reembolsar el pago al cliente. Consulta la documentación para obtener más detalles.

> [card] [Revisar los detalles de la transacción](https://docs.localpayment.com/es/reference/get-transaction-status.md)
>
> Puedes recuperar información sobre las transacciones utilizando la API de Localpayment para obtener información detallada.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.