Customer Base

Con Customer Base, puedes proporcionar la funcionalidad de administración de suscripción y facturación a tus clientes sin necesidad de desarrollarlo tú mismo. Después de configurar e integrarlo en tu sitio web o aplicación, los clientes pueden modificar sus suscripciones y detalles de facturación. Consulta la sección de instalación para comenzar.
Las capacidades de Customer Base permiten a tus clientes:
Administrar suscripción
Ver su historial de facturas pagadas, vencidas y por vencer
Administrar tarjeta próximamente
Cancelar suscripción próximamente
Configuración
Sorry. We are still documenting this section.
Instalación
Descubre cómo configurar Customer Base y ponerlo a disposición de tus clientes.
1. Copiar el Tag HTML para el widget de Piriod
Copia la etiqueta HTML en todos los lugares de tu sitio web o aplicación donde deseas que Customer Base se visualize.
1
<div id="piriod-widget"></div>
Copied!
2. Copiar el fragmento de JavaScript
Copia y pega el fragmento justo después de la etiqueta </body> en todas las páginas en las que deseas que Customer Base aparezca para tu cliente.
1
<script>
2
  window.piriodSettings = {
3
    service: "customerBase",
4
    customerBaseId: "your Customer Base publishable_key attribute",
5
    sessionKey: "session token (required if use existing authentication)"
6
  };
7
​
8
  (function () { var s=document.createElement("script"); s.src="https://js.piriod.com/embed/piriod-embed.umd.min.js"; s.async=true; s.type="text/javascript"; var x=document.getElementsByTagName("script")[0]; x.parentNode.insertBefore(s, x); })();
9
</script>
Copied!
3. Crear una sesión para tu cliente
Una sesión de Customer Base brinda:
1.
La seguridad necesaria para que la información de tu cliente esté a salvo.
2.
La flexibilidad para que elijas el método más cómodo para que puedas autenticar a tu cliente, ya sea por su Tax ID, usuario y contraseña, etc.
Para crear una sesión, necesitas el ID de tu cliente y un return_url, este último se utiliza para redireccionar a tu cliente una vez la sesión expira, es obligatoria siempre y cuando no hayas registrado una por defecto en la configuración de Customer Base.
Implementa un servicio del lado del servidor que te permita crear una sesión para Customer Base. Por ejemplo en Python:
1
import requests
2
​
3
url = f'https://api.piriod.com/customer_base/sessions/'
4
headers = {
5
  'Authorization': f'Token {api_key}',
6
  'x-simple-workspace': '{organization_id}'
7
}
8
payload = {
9
  'base': 'bas_aiFqLDu2cUmDpWQjV1',
10
  'customer': 'cus_18NSMz56sIVMsXo6Fy',
11
  'return_url': 'https://dashboard.myproduct.com/',
12
}
13
r = requests.post(url=url, json=payload, headers=headers)
Copied!
En el cuerpo de la respuesta, hay un atributo llamado key, devuelve este valor al lado del cliente para enviarlo a través de window.piriodSettings
1
{
2
    "id": "ses_DyHrsrQjkUSSqYuosg",
3
    "is_active": "",
4
    "key": "1d4e158b-1bc3-4a17-896e-be180b8299b4",
5
    "return_url": "https://dashboard.myproduct.com/",
6
    "test_mode": false,
7
    "created": "2020-09-01T14:48:30.116162-04:00",
8
    "base": {
9
        "id": "bas_aiFqLDu2cUmDpWQjV1",
10
        "menu_items": [],
11
        "auth_scheme": "existing",
12
        "display_invoices": true,
13
        "enable_hosted": false,
14
        "hosted_page_description": "",
15
        "hosted_page_layout": "vertical",
16
        "hosted_page_title": "",
17
        "name": "New customer base",
18
        "privacy_police_url": "",
19
        "publishable_key": "bas_aiFqLDu2cUmDpWQjV11d4e158b1bc3DyHrsrQjkUSSqYuosg",
20
        "return_url": "https://dashboard.myproduct.com/"
21
        "terms_of_service_url": "",
22
        "test_mode": false,
23
        "created": "2020-09-01T14:48:30.116162-04:00",
24
        "updated": "2020-09-01T14:48:30.116162-04:00"
25
    }
26
    "customer": "cus_18NSMz56sIVMsXo6Fy"
27
}
Copied!
Envía el atributo key devuelto por la solicitud a través de window.piriodSettings
1
<script>
2
  window.piriodSettings = {
3
    service: "customerBase",
4
    customerBaseId: "bas_aiFqLDu2cUmDpWQjV11d4e158b1bc3DyHrsrQjkUSSqYuosg",
5
    sessionKey: "1d4e158b-1bc3-4a17-896e-be180b8299b4" // paste key attribute
6
  };
7
</script>
Copied!
Una vez terminada esta instalación el widget de Piriod será capaz de mostrar en una interfaz de usuario toda la información y acciones permitidas en la configuración de Customer Base.

Configuración de la organización - Anterior

Cuenta de usuario

Próximo - Aplicaciones

Signup Forms

Última actualización 2d ago

Copiar enlace

Contenidos

Configuración

Instalación