Crear cliente

En esta sección trataremos como registrar clientes en tu cuenta de QVO, vpia API. Un objeto cliente te permite asignar cobros a un cliente y suscribirlo a cobros recurrentes. Así puedes agrupar mejor tus transacciones y tener el detalle de los pagos por cliente.

Para crear un cliente debes hacer la siguiente llamada POST https://playground.qvo.cl/customers, debes declarar en el body de tu consulta los siguientes parámetros:

  • Nombre del cliente name
  • Email del cliente email

No te olvides de declarar tu API token en el header de la consulta a nuestra API. Como en el ejemplo, donde debes reemplazar <COPIA TU API TOKEN AQUÍ> por tu credencial.

ℹ Sí requieres forzar la creación de un cliente en una de las cuentas de tu plataforma marketplace, debes especificar dentro del header de la consulta a nuestra API la variable QVO-account (el ID de la cuenta que será forzada), adicional al API Token de tu cuenta.

  curl --request POST "https://playground.qvo.cl/customers" \
    -H "Authorization: Bearer <COPIA TU API TOKEN AQUÍ>" \
    -d name="Walter Jr." \
    -d email="walterjr@white.com"
  <?php
  require 'guzzle.phar';

  $client = new GuzzleHttp\Client();

  $response = $client->request('POST', 'https://playground.qvo.cl/customers', [
    'json' => [
      'name' => 'Walter Jr.',
      'email' => 'walterjr@white.com'
    ],
    'headers' => [
      'Authorization' => 'Bearer <COPIA TU API TOKEN AQUÍ>'
    ]
  ]);

  var_dump($response->json());
  ?>
const fetch = require('node-fetch-json');

fetch('https://playground.qvo.cl/customers', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <COPIA TU API TOKEN AQUÍ>'
  },
  body: {
    name: 'Walter Jr.',
    id: 'walterjr@white.com'
}).then(function(response) {
  console.log(response);
});
require 'rest-client'
require 'json'

result =
  RestClient.post 'https://playground.qvo.cl/customers', {
    name: 'Walter Jr.',
    id: 'walterjr@white.com'
  }, {
    Authorization: 'Bearer <COPIA TU API TOKEN AQUÍ>'
  }

p JSON.parse(result)
import requests

r = requests.post('https://playground.qvo.cl/customers', params={
    name: 'Walter Jr.',
    id: 'walterjr@white.com'
}, headers= {
  Authorization: 'Bearer <COPIA TU API TOKEN AQUÍ>'
})

print r.json()

Recibirás una respuesta similar a la siguiente:

{
    "id": "cus_6DSTOGks6Z4UML_aPvgBCA",
    "default_payment_method": null,
    "name": "Walter Jr.",
    "email": "walterjr@white.com",
    "credits": 0,
    "subscriptions": [],
    "cards": [],
    "transactions": [],
    "created_at": "2017-10-30T20:23:46.630Z",
    "updated_at": "2017-10-30T20:23:46.630Z"
}

Esta respuesta indica los parámetros con los que fue creado el cliente y el identificador id asignado por QVO. Te recomendamos almacenar este id, es necesario para obtener información sobre el cliente y suscribirlo a planes.

ℹ Las llamadas de este tutorial usan la URL de prueba https://playground.qvo.cl. Sin embargo, cuando tengas tu cuenta real (de producción) debes usar la URL https://api.qvo.cl

Sigue viendo otras secciones de QVO Marketplace para developers, o desata toda la potencia de la API explorando la referencia completa.


Ejemplos