---
title: Integración Embebida
slug: o0tUiZo2GPtxNOanhK8UD
description: Learn how to seamlessly integrate Mobbex checkout and subscription solutions into your website with the user-friendly Embed SDK. This comprehensive document covers implementation guides, version details, and code snippets for embedding. Discover the creat
icon: 🔥
createdAt: 2021-01-25T20:04:46.000Z
---

El SDK para Embeber le permite embeber de manera fácil y rápida nuestra solución de checkout en cualquier sitio web.

## Creación

La inserción del embebido comienza al crear el Checkout vía API. En este punto, es necesario añadir dentro del nodo **`options`** los atributos `domain`, `embed` y `embedVersion`. Este último es opcional, si no se pasa por defecto siempre tomará la última versión.

```json
"options":{
    "embed": true,
    "domain": "eldominiodelsitio.com.ar",
    "embedVersion": "1.2.0"
}
```

# Implementación del Embebido

## Versión

La versión actual del SDK es: 1.2.0.



## Insertar en el sitio de manera Fija en la Cabecera

```html
 <script type="text/javascript" src="https://api-rapipago-dev.sugaway.io/p/embed/lib.js"></script>
```

## Insertar en el sitio dinámicamente en el Body

Cargá nuestra librería Javascript en tu sitio:

```html
<html>
    <body>
        <script type="text/javascript">
            var script = document.createElement("script");
            script.src = "https://api-rapipago-dev.sugaway.io/p/embed/lib.js";
            script.async = true;
            script.type = "text/javascript";
            script.addEventListener("load", () => {
                // Realizá la acción que sea necesaria aca :)
            
            });
            document.body.appendChild(script);
        </script>
    </body>
</html>
```

# Creación y Eventos

El modal de pagos puede ser abierto utilizando  a través del propio código. Es necesario definir algunas propiedades y renderizar los objetos correspondientes.

## Documento HTML

Dentro del body del HTML donde se vaya a insertar el modal, es necesario definir un `div` con la propiedad `id` en función del tipo de apertura que se vaya a utilizar.

```html
<div id="gire-container"></div>
```

## JavaScript

Es necesario definir una variable que contiene todos los manejadores de eventos para el Modal. Ejemplos de Checkout y Checkout con medios de Pago:

### Ejemplo Checkout

```javascript
var embed = window.GireDevEmbed.init({
    onResult: (data) => {
        // OnResult es llamado cuando se toca el Botón Cerrar
        window.GireDevEmbed.close();
    },
    onPayment: (data) => { },
    onOpen: () => { },
    onClose: (cancelled) => {
        location.reload();
    },
    onError: (error) => {
        console.error('ERROR: ', error);
    },
});

embed.open({ type: 'checkout', id: 'XXXXXXXXX'});
```

### Ejemplo Checkout con Medios de Pago

```javascript
var embed = window.GireDevEmbed.init({
    onResult: (data) => {
        // OnResult es llamado cuando se toca el Botón Cerrar
        window.GireDevEmbed.close();
    },
    onPayment: (data) => { },
    onOpen: () => { },
    onClose: (cancelled) => {
        location.reload();
    },
    onError: (error) => {
        console.error('ERROR: ', error);
    },
});

embed.open({ type: 'checkout', id: 'XXXXXXXXX', paymentMethod: 'arg.qr' });
```



## Resultado de la operación

El resultado de la operación de ejemplo será obtenido dentro del método `onPayment` del botón.

```json
{
    "id": "kS6D18unD",
    "status": {
        "code": "2",
        "text": "En Espera",
        "message": "El cupón vence a los 5 días de emitido."
    }
}
```

# Opciones

Las siguientes opciones pueden ser provistas al contenedor de Gire en la renderización o inicialización:

### Inicializadores

`type`: sólo acepta:
&#x20;-`checkout`

`paymentMethod`: permite filtrar el tipo de medio de pago (aplica a checkout).

### Callbacks

`onPayment`: (data) => \{ }
`onError`: (error) => \{ }
`onOpen`: () => \{ }
`onClose`: (cancelled) => \{ }

El método `onClose` será llamado al cerrar el modal de pagos. La variable cancelled será true o false dependiendo de que el modal haya sido cerrado antes de realizar la operación o después, respectivamente.

El método `onPayment` será llamado al procesarse una operación, independientemente del método `onClose`, y contendrá dentro de la variable `data` toda la información relacionada al estado de dicha operación.

Esto le permitirá mostrar las diferentes opciones en botones separados en su e-commerce y también poder lanzar la integración embebida directamente en un medio de pago. Por ejemplo, quiero colocar un botón de "Pagá con QR" separado y que el usuario al clickear abra directamente el pago con QR en vez de llegar a la pantalla de todos los medios de pago, para esto al crear el "embebido" en las opciones voy a utilizar el "Grupo (group)" y el "subgrupo (subgroup)" de esta manera "qr\:arg\_interoperable" (conjugando ambos separándolos por dos puntos al medio). Esto hará que al abrir el embebido vaya directamente a la opción de pagar con QR.

# Creación de Servicio para Embeber

Sólo se deben crear Checkouts del lado Servidor y compartir únicamente el ID o UID generado por Gire.

### Checkout Ejemplo

Esto es un ejemplo de la utilización de las opciones especiales en PHP. La creación del checkout siempre debe realizarse desde el lado servidor, ya que sino quedarían expuestas las credenciales de su cuenta. Para más ejemplos ver la documentación de [Checkout](https://docs.bdp.gire.com/WDAYpKYAjXvLsFv1sXlV6).

```php
<?php

$request = new HttpRequest();
$request->setUrl('https://api.bdp.gire.com/p/checkout');
$request->setMethod(HTTP_METH_POST);

$request->setHeaders(array(
  'cache-control' => 'no-cache',
  'Content-Type' => 'application/json',
  'x-lang' => 'es',
  'x-access-token' => 'd31f0721-2f85-44e7-bcc6-15e19d1a53cc',
  'x-api-key' => 'zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj'
));

$request->setBody('{
    "total": 100.2,
    "currency": "ARS",
    "reference": "2982-2XtPXlgSaWccqUyobuv4sEmLYMV0N6oX6MoridMw",
    "description": "Descripción de la Venta",
    "items": [{
        "quantity": 2,
        "description": "Mi Producto",
        "total": 50
    }, {
        "quantity": 1,
        "description": "Mi otro producto",
        "total": 50.2
    }],
    "options": {
        "domain": "midominio.com",
        "embed": true,
        "embedVersion": "1.2.0"    
    },
    "return_url": "https://gire.com/sale/return?session=56789",
    "webhook": "https://gire.com/sale/webhook?user=1234"
}');

try {
  $response = $request->send();

  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
?>
```

