> 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/online-api/primeros-pasos.md).

# Primeros Pasos

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

Todas las peticiones que envíes deben incluir un token válido en la cabecera. Este token lo obtienes enviando una petición a nuestro *endpoint* de [autenticación](/aplazo-integrations/espanol/referencia-de-api/online-api/autenticacion.md) usando tu Merchant ID y API Token.

{% hint style="warning" %}
**Importante:** Se debe generar un nuevo token en cada solicitud que envíes.
{% endhint %}

**Ejemplo**

```bash
curl --location 'https://api.aplazo.net/api/auth' \
--header 'Content-Type: application/json' \
--data '{
    "apiToken": "93e28f44-e352-42df-af84-7a9ffc9f5734",
    "merchantId": 2639
}'
```

**Respuesta**

```json
{
    "Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9..."
}
```

Cuando recibas el token, inclúyelo en la cabecera `Authorization` en tu próxima petición a la API, ejemplo:

```
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9...
```

Si necesitas hacer otra solicitud, genera un nuevo token repitiendo el proceso de autenticación.

***

## Ambientes

### Pruebas

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

| Endpoint                                                                                                                                                              | Descripción                                     | Servidor                                 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | ---------------------------------------- |
| [<mark style="color:blue;">`POST`</mark> /auth](/aplazo-integrations/espanol/referencia-de-api/online-api/autenticacion.md)                                           | Obtén un token para la autenticación            | <https://api.aplazo.net/api>             |
| [<mark style="color:blue;">`POST`</mark> /loan](/aplazo-integrations/espanol/referencia-de-api/online-api/crea-un-pago.md)                                            | Crear pago, obtener URL de pago para tu cliente | <https://api.aplazo.net/api>             |
| [<mark style="color:green;">`GET`</mark>  /v1/merchant/loan/cancel](/aplazo-integrations/espanol/referencia-de-api/online-api/cancela-un-pago.md)                     | Cancela un pago                                 | <https://refunds-bifrost.aplazo.net/api> |
| [<mark style="color:green;">`GET`</mark> /v1/loan/status](/aplazo-integrations/espanol/referencia-de-api/online-api/consulta-el-estado-de-un-pago.md)                 | Consulta el estado de un pago                   | <https://merchant.aplazo.net/api>        |
| [<mark style="color:blue;">`POST`</mark> /loan/refund-from-cart](/aplazo-integrations/espanol/referencia-de-api/online-api/solicita-un-reembolso.md)                  | Solicitar un reembolso parcial o total          | <https://merchant.aplazo.net/api>        |
| [<mark style="color:green;">`GET`</mark> /v1/merchant/refund/status](/aplazo-integrations/espanol/referencia-de-api/online-api/consulta-el-estado-de-un-reembolso.md) | Consulta el estado de un reembolso              | <https://merchant.aplazo.net/api>        |

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