Validación de cuenta

En esta sección trataremos como validar una cuenta custom vía API.

sí una cuenta no es validada, esta no puede ser utilizada en ninguna operación de cobro en nuestro servicio.

ℹ Otros tipos de cuentas pasan por procesos de validación externos a la API, gestionados por QVO.

Para validar una cuenta debes registrar, a través de la API, la documentación necesaria que demuestre que el usuario de la cuenta posee personalidad natural o jurídica, y tenga inicio de actividades ante Servicios de Impuestos Internos de Chile SII.

La validación tiene 3 campos, 2 obligatorios y 1 opcional dependiendo de la validación. la documentación que debes enviar es la siguiente:

Empresa Constituida:

  • Escritura o Constitución de sociedad company_certificate
  • Inicio de actividades o una boleta o factura tax_certificate
  • Cédula de identidad del representante legal legal_representative_id

Persona Natural:

  • Cédula de identidad legal_representative_id
  • Inicio de actividades o una boleta tax_certificate

Para subir la documentación debes enviar el siguiente POST https://playground.qvo.cl/accounts/{QVO-account}/validations?=", en la URL de la consulta debes cambiar las siguientes variables:

  • el ID de la cuenta {QVO-account}

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 -X POST "https://playground.qvo.cl/accounts/acc_0-c9p_yoeC3vjWjQEkAOFA/validations?=" \
  -H "Authorization: Bearer <COPIA TU API TOKEN AQUÍ>" \
  -F company_certificate=’/pdf/company_certificate.pdf' \
  -F tax_certificate=’/pdf/tax_certificate.pdf' \
  -F legal_representative_id=’/pdf/legal_representative_id.pdf' 
<?php
  require 'guzzle.phar';

  $client = new GuzzleHttp\Client();
  $company_certificate = fopen('/pdf/company_certificate.pdf', 'r');
  $tax_certificate = fopen('/pdf/tax_certificate.pdf', 'r');
  $legal_representative_id = fopen('/pdf/legal_representative_id.pdf', 'r');

  $response = $client->request('POST', 'https://playground.qvo.clhttps://playground.qvo.cl/accounts/acc_0-c9p_yoeC3vjWjQEkAOFA/validations?=', [
    'json' => [
      'company_certificate' => $company_certificate,
      'tax_certificate' =>$tax_certificate,
      'legal_representative_id' =>  $legal_representative_id,
    ],
    'headers' => [
      'Authorization' => 'Bearer <COPIA TU API TOKEN AQUÍ>'
    ]
  ]);

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

const company_certificate = fs.readFileSync('/pdf/company_certificate.pdf');
const tax_certificate = fs.readFileSync('/pdf/tax_certificate.pdf');
const legal_representative_id = fs.readFileSync('/pdf/legal_representative_id.pdf');

fetch('https://playground.qvo.cl/accounts/acc_0-c9p_yoeC3vjWjQEkAOFA/validations?=', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <COPIA TU API TOKEN AQUÍ>'
  },
  body: {
  company_certificate: {
    data: company_certificate,
    name: 'company_certificate.pdf',
    type: 'application.octet-stream',
  },
ax_certificate: {
    data: ax_certificate,
    name: 'ax_certificate.pdf',
    type: 'application.octet-stream',
  }
 legal_representative_id: {
    data: legal_representative_id,
    name: 'legal_representative_id.pdf',
    type: 'application.octet-stream',
  }

}).then(function(response) {
  console.log(response);
});
require 'rest-client'
require 'json'

result =
  RestClient.post 'https://playground.qvo.cl/accounts/acc_0-c9p_yoeC3vjWjQEkAOFA/validations?=', {
    company_certificate: File.new("/pdf/company_certificate.pdf"),
    tax_certificate: File.new("/pdf/tax_certificate.pdf"),
    legal_representative_id: File.new("/pdf/legal_representative_id.pdf"),
  }, {
    Authorization: 'Bearer <COPIA TU API TOKEN AQUÍ>'
  }

p JSON.parse(result)

import requests
       with open('/pdf/company_certificate.pdf', 'rb') as a, open('/pdf/company_certificate.pdf', 'rb') as b, open('/pdf/company_certificate.pdf', 'rb') as c :
    r = requests.post('https://playground.qvo.cl/accounts/acc_0-c9p_yoeC3vjWjQEkAOFA/validations?=', params={
            company_certificate: a,
            tax_certificat: b',
                legal_representative_id: c,
    }, headers= {
          Authorization: 'Bearer <COPIA TU API TOKEN AQUÍ>'
    })

print r.json()

Una vez subas la documentación QVO dará entendido que la plataforma ha validado la cuenta, por lo que el status de la cuenta pasará estas de unverified a verified.

Por lo anterior, la cuenta custom queda sujeto a la gestión y decisión de su plataforma, y a su vez, la plataforma es responsable de la legalidad de toda la actividad transaccional de su cuenta custom.

ℹ 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