Crear cuentas

En esta sección trataremos como crear cuentas de marketplace como plataforma, vía API.

una cuenta puede interactuar de distintas formas en nuestro servicio dependiendo de las características de esta, te recomendamos visitar la sección sobre los tipos de cuentas para saber más al respecto.

Para crear una cuenta debes enviar el siguiente POST https://playground.qvo.cl/accounts. Debes declarar en el body de tu consulta los siguientes parámetros:

  • Nombre del comercio name.
  • Tipo de cuenta kind, las posibles opciones son custom, recipient y Std.
  • Correo electrónico del comercio que inscribes email.
  • Teléfono de contacto phone.

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.

 curl --request POST "https://playground.qvo.cl/accounts" \
    -H "Authorization: Bearer <COPIA TU API TOKEN AQUÍ>" \
    -d kind=’custom.’ \
    -d custom_attributes=’{"email": "brucewayne@wayneenterprises.com","name": "Wayne Enterprises","phone": "1 6548 7946 1366"}’
<?php
  require 'guzzle.phar';

  $client = new GuzzleHttp\Client();

  $response = $client->request('POST', 'https://playground.qvo.cl/accounts', [
    'json' => [
  'kind': 'custom',
  'custom_attributes':  [
      'email': 'brucewayne@wayneenterprises.com',
      'name': 'Wayne Enterprises',
      'phone': '1 6548 7946 1366'
    ]
],
    'headers' => [
      'Authorization' => 'Bearer <COPIA TU API TOKEN AQUÍ>'
    ]
  ]);

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

fetch('https://playground.qvo.cl/accounts, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <COPIA TU API TOKEN AQUÍ>'
  },
  body: {
    kind: ‘custom’,
    custom_attributes:  ‘{
      "email": "brucewayne@wayneenterprises.com",
      "name": "Wayne Enterprises",
      "phone": "1 6548 7946 1366"
    }’
}).then(function(response) {
  console.log(response);
});
require 'rest-client'
require 'json'

result =
  RestClient.post 'https://playground.qvo.cl/accounts', {
    kind: ‘custom’,
    custom_attributes:  ‘{
      "email": "brucewayne@wayneenterprises.com",
      "name": "Wayne Enterprises",
      "phone": "1 6548 7946 1366"
    }’
}, {
    Authorization: 'Bearer <COPIA TU API TOKEN AQUÍ>'
  }

p JSON.parse(result)
import requests

r = requests.post('https://playground.qvo.cl/accounts', params={
    kind: ‘custom’,
    custom_attributes:  ‘{
      "email": "brucewayne@wayneenterprises.com",
      "name": "Wayne Enterprises",
      "phone": "1 6548 7946 1366"
    }’
}, headers= {
  Authorization: 'Bearer <COPIA TU API TOKEN AQUÍ>'
})

print r.json()

Recibirás una respuesta como esta por parte de nuestra API:

{
    "id": "acc_0-c9p_yoeC3vjWjQEkAOFA",
    "status": "unverified",
    "kind": "custom",
    "child": {
        "id": "com_kkfAQrf14ywpY26nZPqebQ",
        "api_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjb21tZXJjZV9pZCI6ImNvbV9ra2ZBUXJmMTR5d3BZMjZuWlBxZWJRIiwiYXBpX3Rva2VuIjp0cnVlfQ.8fh5RIMCQWpSGjaP_SuYvBuBzzH6G2ipDgDJRxO_rsQ",
        "public_key": "obdjeFBnVK4LTHQWiQHQAg",
        "name": "Wayne Enterprises",
        "email": "brucewayne@wayneenterprises.com",
        "phone": "1 6548 7946 1366",
        "prefered_currency": "CLP",
        "preferences": {
            "email_display": {
                "main_color": "#3091c8",
                "button_color": "#3091c8"
            },
            "email_delivery": {
                "receipt": true,
                "charge_request": true,
                "charge_request_success_notification": true,
                "subscription_charge_success_notification": true,
                "subscription_request": true,
                "trial_ending_notification": true,
                "unpaid_subscription_notification": true
            }
        },
        "webhook_url": null,
        "webhook_unreachable": false,
        "balance": 0,
        "billing_information": null,
        "bank_account": null
    },
    "created_at": "2019-02-14T18:17:13.018Z",
    "updated_at": "2019-02-14T18:17:13.018Z"
}

En el caso de las cuentas custom, la plataforma debe subir a QVO documentación que acredite al usuario de la cuenta como un comercio establecido. Visita la sección de developers validar cuenta para saber más al respecto.

ℹ 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.

También te invitamos visitar la referencia completa, desata toda la potencia de nuestra API explorando.


Ejemplos