> For the complete documentation index, see [llms.txt](https://aplazo.gitbook.io/aplazo-integrations/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aplazo.gitbook.io/aplazo-integrations/espanol/in-store-api/primeros-pasos.md).

# Primeros Pasos

Consider these points about the In-Store API integration path:

## Obtener Credenciales

Antes de comenzar, necesitarás las credenciales para autenticar tus peticiones a nuestra API.

* Inicialmente, te proporcionaremos un Merchant ID y un API Token.
* Una vez que completes el proceso de onboarding con nuestro equipo comercial y estés listo para adentrarte en los detalles técnicos, te compartiremos tus credenciales.
* Si lo necesitas, envía un correo a <soporte-integraciones@aplazo.mx> para pedir tus credenciales.

***

## Autenticación

A diferencia de nuestra API Online, la *In-Store API* no requiere generar un token de autenticación. Todas las peticiones deben incluir las siguientes cabeceras:

* `api_token: {yourAPIToken}`
* `merchant_id: {yourMerchantId}`

**Ejemplo de Petición**

```bash
curl --location 'https://merchant.aplazo.net/merchant/create-branch' \
--header 'merchant_id: 1234' \
--header 'api_token: fbb6fe4d-7c63-4dbe-bfd9-cd0f945af8c5' \
--header 'Content-Type: application/json' \
--data '{
    "branches": [
        "Tienda Norte",
        "Tienda Sur"
    ]
}'
```

Asegúrate de reemplazar el `api_token` y el `merchant_id` de ejemplo con tus propias credenciales.

***

## Ambientes

### **Pruebas**

Puedes probar y validar todos los escenarios en nuestro entorno de desarrollo antes de pasar a producción.

| Endpoint                                                                                                                        | Descripción                                                                | Servidor                                                    |
| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------- |
| [`POST` /api/pos/loan](/aplazo-integrations/espanol/referencia-de-api/in-store-api/crea-un-pago.md)                             | Crea un nuevo pago.                                                        | [https://api.aplazo.net](https://api.aplazo.net/)           |
| [`GET` /api/pos/loan/{cartId}](/aplazo-integrations/espanol/referencia-de-api/in-store-api/consulta-el-estado-de-un-pago.md)    | Consulta el estado de un pago-                                             | [https://api.aplazo.net](https://api.aplazo.net/)           |
| [`POST` /api/pos/loan/cancel](/aplazo-integrations/espanol/referencia-de-api/in-store-api/cancela-un-pago.md)                   | Cancela un pago.                                                           | [https://api.aplazo.net](https://api.aplazo.net/)           |
| [`POST` /api/pos/loan/refund](/aplazo-integrations/espanol/referencia-de-api/in-store-api/solicita-un-reembolso.md)             | Solicita un reembolso total o parcial.                                     | [https://api.aplazo.net](https://api.aplazo.net/)           |
| [`GET` /api/pos/loan/refund/{cartId}](/aplazo-integrations/espanol/referencia-de-api/in-store-api/get-refund-status.md)         | Consulta el historial de reembolsos.                                       | [https://api.aplazo.net](https://api.aplazo.net/)           |
| [`POST` /merchant/create-b](/aplazo-integrations/espanol/referencia-de-api/in-store-api/registra-una-sucursal.md)               | Registra tus sucursales y obtén el ID que Aplazo les asigna.               | [https://merchant.aplazo.net](https://merchant.aplazo.net/) |
| [`POST` /merchant/send-checkout/{cartId}](/aplazo-integrations/espanol/referencia-de-api/in-store-api/reenviar-link-de-pago.md) | Reenvía por SMS o Whatsapp la URL de pago al cliente.                      | [https://merchant.aplazo.net](https://merchant.aplazo.net/) |
| [`GET` /api/v1/loan/checkout-url](/aplazo-integrations/espanol/referencia-de-api/in-store-api/generar-codigo-qr.md)             | Genera un código QR con el link de pago para mostrar en el punto de venta. | [https://merchant.aplazo.net](https://merchant.aplazo.net/) |

### **Ambiente de Producción**

Después de realizar pruebas y certificar tu integración, puedes cambiar a producción y comenzar a ofrecer pagos a plazos a tus clientes.

{% hint style="warning" %}
Al cambiar a nuestro entorno de producción, reemplaza el dominio **.net** por **.mx**.
{% endhint %}

***

## Webhooks

Por cada petición de pago que envíes, deberás proporcionar a Aplazo la URL en la que deseas recibir *webhooks*.

Cuando un pago se complete, Aplazo enviará una notificación en tiempo real a tu endpoint configurado, permitiéndote mantener tu sistema actualizado.

### Seguridad

* **Lista blanca de IPs:** Si lo necesitas, puedes incluir en una lista blanca las direcciones IP estáticas desde dónde Aplazo envía webhooks.
* **Autenticación:** Aplazo admite el envío de encabezados de autenticación **Basic** o **Bearer** en los webhooks para mayor seguridad.

[\[Documentación de Webhooks →\]](/aplazo-integrations/espanol/referencia-de-api/webhook-de-confirmacion.md)