Transferir balance a una cuenta

En esta sección trataremos como puedes transferir balance a una cuenta marketplace e incrementar su balance.

Para hacer una transferencia tienes que enviar el siguientes POST https://playground.qvo.cl/transfers, debes declarar en el body de tu consulta los siguientes parámetros:

  • El ID de la cuenta receptora de la transferencia destination.
  • El monto a transferir amount.
  • Tipo de dinero currency (siempre es CLP).
  • la razón de transferencia description.

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/transfers" \
    -H "Authorization: Bearer <COPIA TU API TOKEN AQUÍ>" \
    -d destination: ‘acc_0-c9p_yoeC3vjWjQEkAOFA’\
    -d amount: 1000\
    -d currency: ‘CLP’\
    -d description: ‘Toma todo mi dinero’\
    -d metadata: ‘{"key": "value"}’
}
 <?php
  require 'guzzle.phar';

  $client = new GuzzleHttp\Client();

  $response = $client->request('POST', 'https://playground.qvo.cl/transfers', [
    'json' => [
      'destination' => '<COPIA AQUI EL ID DE TU COMERCIO HIJO QVO-Account>',
      'amount' => 1000,
      ‘currency’=> ‘CLP’,
      ‘description’=>’Toma todo mi dinero’,
      ‘metadata’=>[‘key’: ‘value’]
    ],
    'headers' => [
      'Authorization' => 'Bearer <COPIA TU API TOKEN AQUÍ>'
    ]
  ]);

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

fetch('https://playground.qvo.cl/transfers', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <COPIA TU API TOKEN AQUÍ>'
  },
  body: {
    destination: '<COPIA AQUI EL ID DE TU COMERCIO HIJO QVO-Account>',
    amount:1000,
    currency:’CLP’,
    description:’Toma todo mi dinero’,
    metadata:{key: ‘value’}
}).then(function(response) {
  console.log(response);
});
require 'rest-client'
require 'json'

result =
  RestClient.post 'https://playground.qvo.cl/customers', {
    destination: '<COPIA AQUI EL ID DE TU COMERCIO HIJO QVO-Account>',
    amount:1000,
    currency:’CLP’,
    description:’Toma todo mi dinero’,
    metadata:{key: ‘value’}
}, {
    Authorization: 'Bearer <COPIA TU API TOKEN AQUÍ>'
  }

p JSON.parse(result)
import requests

r = requests.post('https://playground.qvo.cl/customers', params={
    destination: '<COPIA AQUI EL ID DE TU COMERCIO HIJO QVO-Account>',
    amount:1000,
    currency:’CLP’,
    description:’Toma todo mi dinero’,
    metadata:{key: ‘value’}
}, headers= {
  Authorization: 'Bearer <COPIA TU API TOKEN AQUÍ>'
})

print r.json()

Recibirás una respuesta similar a la siguiente:

{
  "id": "trf_nnMxchF4po8k9uUYnYMqEg",
  "destination_id": "acc_0-c9p_yoeC3vjWjQEkAOFA",
  "amount": "1000.0",
  "currency": "CLP",
  "status": "transfered",
  "description": "Toma todo mi dinero",
  "metadata": {
      "key": "value"
  },
  "reversals": [],
  "created_at": "2019-02-18T19:32:20.723Z",
  "updated_at": "2019-02-18T19:32:20.723Z"
}

La respuesta indica la información de la transacción y el estado de ésta, en caso de no disponer suficiente balance para efectuar la operación la API arrojará un error en la respuesta.

ℹ 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