Paga a plazos
Integración básica
tip
Si usas la configuración básica, podrás personalizarlo desde el panel de control, en la vista de personalización del widget en la pestaña correspondiente al valor de data-view.
<div
data-aplazame-widget-instalments
data-amount="15900"
data-currency="EUR"
data-country="ES"
data-view="product"></div>
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| data-amount | decimal | Sí | Cantidad a financiar en céntimos. Este campo se puede omitir si se usa data-price. |
| data-currency | ISO 4217 | Sí | Moneda en la que se venderá el artículo. |
| data-country | ISO 3166-1 | Sí | País donde aplicará la venta. |
| data-view | enum | No | Vista dónde se incluye el widget, corresponde con la pestaña de personalización del panel de control. Los posibles valores son: product, cart. Por omisión se usará: product. |
Simulación
<div
data-aplazame-widget-instalments
data-amount="15900"
data-currency="EUR"
data-country="ES"
data-view="product"></div>
Integración avanzada
nota
Además de los parámetros obligatorios de la integración básica, se usará automáticamente la configuración avanzada al incluir algún data-option-*.
Los valores por defecto en ese caso, son los que se muestran en esta documentación.
Ten en cuenta que al cambiar los valores en el formulario, se actualizarán en el código de ejemplo.
<div
data-aplazame-widget-instalments
data-amount="5900"
data-currency="EUR"
data-country="ES"
data-type="button"
data-article-id="l33t"
data-option-text-color="#333A3E"
data-option-btn-text-color="#FFFFFF"
data-option-btn-bg-color="#267BBD"
data-option-branding="true"
data-option-downpayment-info="true"
data-option-title-smart="true"
data-option-disable-modal="false"
data-option-legal-advice="true"
data-option-url-more-info-hide-mobile="true"
data-option-title-default="Págalo a plazos"
data-option-title-zero-interest="Consíguelo sin intereses"
data-option-legal-text="${ simulator_legal_text }"
data-option-url-more-info="https://www.aplazame.com"
data-option-default-instalments="6"
data-option-out-of-limits="hide">
</div>
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| data-type | enum | No | Permite elegir el tipo de widget. Las opciones son: text, button, select, big-button. Por omisión se usará el que se haya definido en el panel de control. |
| data-article-id | texto | No | El identificador del artículo. No puede tener espacios. En caso de tener una campaña parcial que incluya el mismo, el widget podrá indicar dicha campaña. Se pueden incluir varios artículos en caso de requerirlo. |
| data-option-text-color | color css | No | Establece el color del texto que queda fuera del botón. |
| data-option-btn-text-color | color css | No | Establece el color del texto del botón. |
| data-option-btn-bg-color | color css | No | Establece el color del fondo del botón. |
| data-option-branding | boolean | No | Indica si debe mostrarse o no el logotipo de Aplazame en la parte inferior del widget. |
| data-option-downpayment-info | boolean | No | Indica si debe mostrarse o no el importe del pago inicial en la parte superior del widget. |
| data-option-title-smart | boolean | No | Indica si debe mostrarse o no el texto en la parte superior del widget. Este texto cambiará en función de si hay alguna campaña sin intereses activa. Texto normal: Págalo a plazos Texto sin intereses: ¡Consíguelo sin intereses!. |
| data-option-title-default | texto | No | Esta opción permite personalizar el texto que aparece encima del widget cuando no hay campañas sin intereses activa. |
| data-option-title-zero-interest | texto | No | Esta opción permite personalizar el texto que aparece encima del widget cuando hay campañas sin intereses activa. |
| data-option-custom-styles | boolean | No | Indica si los estilos se heredan de la tienda true o se usan los de Aplazame false. |
| data-option-disable-modal | boolean | No | Indica si debe dejar de mostrarse la modal de información para los tipos text y button. El valor por omisión es false. |
| data-option-legal-advice | boolean | No | Indica si debe mostrarse el texto legal justo después del widget. El valor por omisión es false. |
| data-option-legal-text | texto | No | Esta opción permite personalizar el texto legal que aparece debajo del widget. |
| data-option-url-more-info | texto | No | Esta opción permite personalizar la página destino del botón ‘¿Quieres saber más?’ |
| data-option-url-more-info-hide-mobile | boolean | No | Esta opción permite ocultar el botón ‘¿Quieres saber más?’. Únicamente en versión mobile. |
| data-option-default-instalments | decimal | No | Permite configurar el número de cuotas seleccionadas que mostrará el widget por defecto. |
| data-option-out-of-limits | texto | No | Permite mostrar un widget diferente si el importe del producto (o carrito) está fuera de los límites configurados para tener Aplazame como método de pago. Con este widget, el cliente sabrá que aumentando el importe de la compra podrá financiarla (o pagarla en 4 pagos sin intereses). Si queremos que salga el widget alternativo, el valor debe ser 'show', por defecto el valor es 'hide'. |
tip
Si deseas configurar el widget de acuerdo a tus necesidades, puedes usar la configuración avanzada y decidir qué valores quieres aplicar y con qué look and feel.
- Configura los distintos parámetros de acuerdo a tus necesidades. Aplica los colores que desees, elige la alineaci ón y decide si quieres que tu widget use la funcionalidad de título inteligente y el branding de Aplazame o no.
- El código de ejemplo de tu widget se irá actualizando en función de los valores que definas. Una vez tengas el diseño que buscabas, sólo tienes que copiar el código para llevártelo a tu tienda online y ¡listo!
Incluir varios artículos
En el caso de incluir el widget en el carrito o en el resumen del pedido, es posible que se quiera indicar si alguno de los artículos está en periodo de campaña. El parámetro data-article-id se puede usar para este propósito.
<div data-aplazame-widget-instalments
...
data-article-id="article_id: price*qty" >
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| article_id | texto | Sí | El identificador del artículo. No puede tener espacios. |
| price | decimal | Sí | Cantidad a financiar en céntimos. |
| qty | decimal | No | La cantidad de un determinado artículo. |
Ejemplo del snippet con valores:
<div data-aplazame-widget-instalments
...
data-article-id="art46: 12495, art1337: 5600*2" >
Configurador
<div
data-aplazame-widget-instalments
data-country="ES"
data-amount="12900"
data-type="button"
data-option-text-color="#ff0000"
data-option-btn-text-color="#00ff00"
data-option-btn-bg-color="#267BBD"
data-option-align="center"
data-option-branding="true"
data-downpayment-info="true"
data-option-title-smart="true"
data-option-disable-modal="false"
data-option-title-default="Págalo a plazos"
data-option-title-zero-interest="Consíguelo sin intereses"
></div>
Simulación mediante API
Es posible consultar una simulación de las cuotas disponibles mediante una consulta a la API. Es necesario enviar la cabecera Authorization con la public_key del merchant como valor.
Ejemplo:
GET /instalment-plan-simulator HTTP/1.1
Authorization: Bearer api_public_key
Host: api.aplazame.com
curl 'https://api.aplazame.com/instalment-plan-simulator?amount=12345' \
-H 'authorization: Bearer 12093289b594f50d3971e4719eedd5c314ceb6ba'
Los parámetros soportados son:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| amount | decimal | Sí | Cantidad a financiar en céntimos. |
| currency | ISO 4217 | No | Moneda en la que se venderá el artículo. EUR por omisión. |
| country | ISO 3166-1 | No | País donde aplicará la venta. ES por omisión. |
| view | enum | No | Vista dónde se incluye el widget, corresponde con la pestaña de personalización del panel de control. Los posibles valores son: product, cart. Por omisión se usará: product. |
| payday | decimal | No | El día de pago. Se usa el configurado en el merchant por omisión. |
En caso de necesitar enviar artículos en campaña, puede utilizarse con el método POST:
curl -X POST 'https://api.aplazame.com/instalment-plan-simulator?view=product' \
-H 'accept-language: pt-PT,es;q=0.9,en;q=0.8' \
-H 'authorization: Bearer 12093289b594f50d3971e4719eedd5c314ceb6ba' \
-H 'content-type: application/json' \
--data-raw '{"order":{"articles":[{"id":"10870079","price":"109900"}],"currency":"EUR","total_amount":"109900"}}'
Se devuelven todas las combinaciones de día de pago y número de cuotas.