Crear cobro

POST/v1/cobros

201. Te devolvemos el link en url. Montos como string. success_url y error_url, si van, tienen que ser https.

Campo	Envío
concepto	sí	Texto que ve quien paga
monto	sí	String decimal, ej. `15000.00`
vencimiento	no	ISO 8601. Si no va, 7 días
tarjeta	no	Boolean. Default true
qr	no	Boolean. Default true
transferencia	no	Boolean. Default true
referencia	no	Tu id interno
success_url	no	https solamente
error_url	no	https solamente

curl -X POST https://api.tikipay.ar/v1/cobros \
  -H "Authorization: Bearer tiki_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "concepto": "Factura 1001",
    "monto": "15000.00",
    "vencimiento": "2026-10-01T18:00:00-03:00",
    "tarjeta": true,
    "qr": true,
    "transferencia": true,
    "referencia": "FAC-1001",
    "success_url": "https://tudominio.com/ok",
    "error_url": "https://tudominio.com/error"
  }'

require 'Tiki.php';
$tiki = new TikiPay('tiki_test_xxx', 'https://api.tikipay.ar');
$r = $tiki->crearCobro(array(
  'concepto' => 'Factura 1001',
  'monto' => '15000.00',
  'vencimiento' => '2026-10-01T18:00:00-03:00',
  'tarjeta' => true,
  'qr' => true,
  'transferencia' => true,
  'referencia' => 'FAC-1001',
  'success_url' => 'https://tudominio.com/ok',
  'error_url' => 'https://tudominio.com/error'
));
echo $r['data']['data']['url'];

const tiki = new TikiPay('tiki_test_xxx', 'https://api.tikipay.ar');
const r = await tiki.crearCobro({
  concepto: 'Factura 1001',
  monto: '15000.00',
  vencimiento: '2026-10-01T18:00:00-03:00',
  tarjeta: true,
  qr: true,
  transferencia: true,
  referencia: 'FAC-1001',
  success_url: 'https://tudominio.com/ok',
  error_url: 'https://tudominio.com/error'
});
console.log(r.data.data.url);

HTTP/1.1 201 Created

{
  "data": {
    "id": 12,
    "codigo": "TKI1-AB12CD34",
    "concepto": "Factura 1001",
    "monto": "15000.00",
    "monto_cobrado": "0.00",
    "estado": "PENDIENTE",
    "url": "https://pagos.ejemplo.com/d/TKI1-AB12CD34",
    "cvu": null,
    "qr": null,
    "referencia": "FAC-1001",
    "medios": { "tarjeta": true, "qr": true, "transferencia": true },
    "vencimiento": "2026-10-01 18:00:00",
    "success_url": "https://tudominio.com/ok",
    "error_url": "https://tudominio.com/error",
    "created_at": "2026-09-11 20:00:00",
    "updated_at": "2026-09-11 20:00:00"
  }
}

Respuesta es el JSON HTTP. El SDK lo envuelve en { http, data }.

Objeto cobro

Crear, listar, ver y actualizar devuelven el mismo objeto.

Campo
id	Entero interno
codigo	Código público
concepto	Lo que ve quien paga
monto	String decimal
monto_cobrado	String decimal. Empieza en 0.00
estado	PENDIENTE, EN_PROCESO, PAGADA, PAGADA_PARCIALMENTE, CANCELADO, DEVUELTA, DEVUELTA_PARCIALMENTE
url	Link para pagar
cvu / qr	Pueden ir null hasta que estén listos
referencia	Tu id, o null
medios	tarjeta, qr, transferencia
vencimiento	Puede ir null
success_url / error_url	Pueden ir null
created_at / updated_at	Fecha local