> ## 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.

# Debin (Argentina)

Localpayment permite a los comercios procesar transferencias bancarias instantáneas a través del sistema Debin (Débito Inmediato) de Argentina. Esta guía describe el proceso para iniciar pagos Debin 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 red de débito inmediato argentina.

> [!WARNING]
>
> **Importante**
>
> Los pagos de Debin caducan **2 días** después de la fecha de creación.

## Antes de comenzar

Asegúrate de tener:

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

***

## Paso 1. Crear pago Debin

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

> [!NOTE]
>
> La solicitud de pago solo puede realizarse a cuentas de CBU. Estos números de cuenta se distinguen porque sus tres primeros dígitos no comienzan con cero.

### Parámetros clave de la solicitud

La solicitud requiere varios objetos clave específicos para los pagos de Debin:

| Objeto | Descripción | Requerido |
| - | - | - |
| `paymentMethod.type` | Debe ser `BankTransfer`. | ✅ |
| `paymentMethod.code` | Debe ser `1040` para Debin. | ✅ |
| `payer` | Información de la cuenta bancaria del pagador. | ✅ |
| `merchant` | Datos del comerciante/negocio | ✅ |
| `amount` | Importe de la transacción | ✅ |
| `currency` | Código de moneda de la transacción | ✅ |
| `country` | Debe ser `ARG` | ✅ |

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

### 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 'content-type: application/json' \
     --header 'Authorization: Bearer <your_access_token>' \
     --data '
{
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1040",
    "flow": "DIRECT"
  },
  "currency": "ARS",
  "merchant": {
    "type": "COMPANY",
    "name": "Company"
  },
  "payer": {
    "type": "INDIVIDUAL",
    "document": {
      "type": "CUIL",
      "id": "20963514871"
    },
    "bank": {
      "account": {
        "type": "C",
        "number": "0070055930004044931234"
      },
      "name": "Galicia",
      "code": "007"
    },
    "name": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com"
  },
  "externalId": "0fcd5d00-a734-46d9-95d7-246126989132",
  "country": "ARG",
  "amount": 1800,
  "accountNumber": "{{yourAccountNumber}}",
  "conceptCode": "0038",
  "comment": "",
  "transactionType": "PayIn",
  "clientCode": "0028",
  "requireAuth": false,
  "file": false
}
'
```

***

> [!NOTE]
>
> El pago se considerará completado únicamente cuando el cliente lo acepte en su aplicación bancaria. Si el cliente lo rechaza, el pago será denegado. En caso contrario, el pago pasará al estado de caducado.

## Paso 2. Gestionar la respuesta.

### Respuesta exitosa

La creación exitosa de un pago Debin incluye los detalles de la solicitud de pago y el flujo de autorización:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "bb905b2f-e412-493f-a0a0-c3c03444e0c8",
  "internalId": "d05dab30-485f-473d-844c-041ed5355fc4",
  "paymentMethod": {
    "type": "BankTransfer",
    "code": "1040",
    "flow": "DIRECT"
  },
  "country": "ARG",
  "currency": "ARS",
  "amount": 2355,
  "accountNumber": "{{yourAccountNumber}}",
  "confirmed": {
    "currency": "ARS",
    "fxQuote": 1,
    "amount": 1
  },
  "payment": {
    "currency": "ARS",
    "fxQuote": 1,
    "financingFee": 0,
    "amount": 1
  },
  "localTaxes": [],
  "withHoldings": [],
  "fees": {
    "description": "Fee",
    "currency": "ARS",
    "fxSource": 1,
    "fxQuote": 1,
    "amount": 0,
    "account": "{{yourAccountNumber}}"
  },
  "status": {
    "code": "100",
    "description": "INPROGRESS",
    "detail": "The payin is pending the confirmation"
  },
  "merchant": {
    "type": "INDIVIDUAL",
    "name": "Company"
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "John",
    "lastName": "Doe",
    "document": {
      "type": "CUIL",
      "id": "20045113651"
    },
    "email": "john.doe@example.com",
    "bank": {
      "name": "QA TEST",
      "code": "322",
      "account": {
        "type": "S",
        "number": "3220001805117354710015"
      }
    }
  },
  "intermediaries": [],
  "date": {
    "creationDate": "2025-02-16T20:04:04.993",
    "processedDate": "2025-02-16T20:04:10.969",
    "expirationDate": "2025-02-23T20:04:05.553"
  },
  "errors": [],
  "redirectUrl": "https://web-checkout.stage.localpayment.com/redirect/L3ZlcmlmaWNhdGlvbi8wMTM5P2ludGVybmFsSWQ9MGRlNmI5MmQtYjY0Yi00YThhLThjNGEtYjczNDk3ZWRhZDQx"
}
```

### Campos de respuesta clave

| Parámetro | Descripción | Caso de uso |
| - | - | - |
| `redirectUrl` | URL a la que se redirigirá al pagador para su autorización. | Indica al cliente que complete el proceso de autorización de Debin. |
| `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. |
| `date.expirationDate` | Marca de tiempo ISO en la que la solicitud Debin deja de ser válida. | Muestra un temporizador de cuenta regresiva y gestiona la lógica de expiración. |

#### Respuesta de error

Cuando falla la creación de la solicitud Debin, recibirás información detallada sobre el error:

```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. Gestionar el flujo de autorización

1. **Iniciación del pago**: Tu aplicación envía una solicitud DEBIN a la API de Localpayment.

2. **Procesamiento de la red bancaria**: Localpayment canaliza el pago a través del sistema bancario argentino.

3. **Notificación al cliente**: El cliente recibe una alerta en tiempo real en su aplicación bancaria.

4. **Autorización de pago**: El cliente aprueba el pago directamente en la interfaz bancaria.

5. **Confirmación y Webhooks**: Localpayment envía un webhook instantáneo con el estado final del pago.

6. **Procesamiento de pedidos**: Tu aplicación actualiza el estado del pedido en función del resultado del pago.

***

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

Supervisa el progreso de los pagos de Debin 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 de Debin.

| Código | Estado | Descripción |
| :- | :- | :- |
| `100` | `INPROGRESS` | El pago está pendiente de confirmación. |
| `825` | `REJECTED` | Error del sistema al generar el pago. |

> [!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 de Debin

Verifica que tu integración gestione estos escenarios:

1. **Autorización exitosa**: Flujo de autorización de Debin completado.
2. **Caducidad de la autorización**: Gestionar las solicitudes de autorización caducadas.
3. **Actualizaciones de estado**: Gestión de webhooks y sondeo de estado.

***

## Próximos pasos

Tras implementar los pagos de Debin, 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.