Crear reclamo con comprobante adjunto

curl --request POST \
  --url https://hg.cash/api/v1/claims \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "550e8400-e29b-41d4-a716-446655440123",
  "from": "Juan Pérez",
  "to": "Mi cuenta HG",
  "operationNumber": "987654321",
  "coelsaCode": "67REZ8NPQDQ460QK94KVGO",
  "amount": 1500,
  "currency": "ARS",
  "file": {
    "contentBase64": "<bytes de PDF o imagen en base64>",
    "mimeType": "application/pdf",
    "filename": "comprobante.pdf"
  }
}
'

import requests

url = "https://hg.cash/api/v1/claims"

payload = {
    "accountId": "550e8400-e29b-41d4-a716-446655440123",
    "from": "Juan Pérez",
    "to": "Mi cuenta HG",
    "operationNumber": "987654321",
    "coelsaCode": "67REZ8NPQDQ460QK94KVGO",
    "amount": 1500,
    "currency": "ARS",
    "file": {
        "contentBase64": "<bytes de PDF o imagen en base64>",
        "mimeType": "application/pdf",
        "filename": "comprobante.pdf"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    accountId: '550e8400-e29b-41d4-a716-446655440123',
    from: 'Juan Pérez',
    to: 'Mi cuenta HG',
    operationNumber: '987654321',
    coelsaCode: '67REZ8NPQDQ460QK94KVGO',
    amount: 1500,
    currency: 'ARS',
    file: {
      contentBase64: '<bytes de PDF o imagen en base64>',
      mimeType: 'application/pdf',
      filename: 'comprobante.pdf'
    }
  })
};

fetch('https://hg.cash/api/v1/claims', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://hg.cash/api/v1/claims",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accountId' => '550e8400-e29b-41d4-a716-446655440123',
    'from' => 'Juan Pérez',
    'to' => 'Mi cuenta HG',
    'operationNumber' => '987654321',
    'coelsaCode' => '67REZ8NPQDQ460QK94KVGO',
    'amount' => 1500,
    'currency' => 'ARS',
    'file' => [
        'contentBase64' => '<bytes de PDF o imagen en base64>',
        'mimeType' => 'application/pdf',
        'filename' => 'comprobante.pdf'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://hg.cash/api/v1/claims"

	payload := strings.NewReader("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440123\",\n  \"from\": \"Juan Pérez\",\n  \"to\": \"Mi cuenta HG\",\n  \"operationNumber\": \"987654321\",\n  \"coelsaCode\": \"67REZ8NPQDQ460QK94KVGO\",\n  \"amount\": 1500,\n  \"currency\": \"ARS\",\n  \"file\": {\n    \"contentBase64\": \"<bytes de PDF o imagen en base64>\",\n    \"mimeType\": \"application/pdf\",\n    \"filename\": \"comprobante.pdf\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://hg.cash/api/v1/claims")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440123\",\n  \"from\": \"Juan Pérez\",\n  \"to\": \"Mi cuenta HG\",\n  \"operationNumber\": \"987654321\",\n  \"coelsaCode\": \"67REZ8NPQDQ460QK94KVGO\",\n  \"amount\": 1500,\n  \"currency\": \"ARS\",\n  \"file\": {\n    \"contentBase64\": \"<bytes de PDF o imagen en base64>\",\n    \"mimeType\": \"application/pdf\",\n    \"filename\": \"comprobante.pdf\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://hg.cash/api/v1/claims")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440123\",\n  \"from\": \"Juan Pérez\",\n  \"to\": \"Mi cuenta HG\",\n  \"operationNumber\": \"987654321\",\n  \"coelsaCode\": \"67REZ8NPQDQ460QK94KVGO\",\n  \"amount\": 1500,\n  \"currency\": \"ARS\",\n  \"file\": {\n    \"contentBase64\": \"<bytes de PDF o imagen en base64>\",\n    \"mimeType\": \"application/pdf\",\n    \"filename\": \"comprobante.pdf\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "OPEN",
  "operationNumber": "<string>",
  "coelsaCode": "<string>",
  "amount": "1500.00",
  "currency": "ARS",
  "extractedData": {
    "from": "<string>",
    "to": "<string>"
  },
  "originalFilename": "<string>",
  "mimeType": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Claims

Crear reclamo con comprobante adjunto

Crea un reclamo con la evidencia del comprobante de transferencia adjunta como PDF o JPEG codificado en base64. Todos los campos de metadatos deben enviarse de forma explícita; la API no analiza ni extrae datos del archivo. Las llamadas ADMIN deben incluir accountId. Las llamadas USER pueden omitir accountId o asociar el reclamo solo a su propia cuenta. Requiere que la función Reclamos (canAccessClaims) esté habilitada para quien llama.

POST

claims

curl --request POST \
  --url https://hg.cash/api/v1/claims \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "550e8400-e29b-41d4-a716-446655440123",
  "from": "Juan Pérez",
  "to": "Mi cuenta HG",
  "operationNumber": "987654321",
  "coelsaCode": "67REZ8NPQDQ460QK94KVGO",
  "amount": 1500,
  "currency": "ARS",
  "file": {
    "contentBase64": "<bytes de PDF o imagen en base64>",
    "mimeType": "application/pdf",
    "filename": "comprobante.pdf"
  }
}
'

import requests

url = "https://hg.cash/api/v1/claims"

payload = {
    "accountId": "550e8400-e29b-41d4-a716-446655440123",
    "from": "Juan Pérez",
    "to": "Mi cuenta HG",
    "operationNumber": "987654321",
    "coelsaCode": "67REZ8NPQDQ460QK94KVGO",
    "amount": 1500,
    "currency": "ARS",
    "file": {
        "contentBase64": "<bytes de PDF o imagen en base64>",
        "mimeType": "application/pdf",
        "filename": "comprobante.pdf"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    accountId: '550e8400-e29b-41d4-a716-446655440123',
    from: 'Juan Pérez',
    to: 'Mi cuenta HG',
    operationNumber: '987654321',
    coelsaCode: '67REZ8NPQDQ460QK94KVGO',
    amount: 1500,
    currency: 'ARS',
    file: {
      contentBase64: '<bytes de PDF o imagen en base64>',
      mimeType: 'application/pdf',
      filename: 'comprobante.pdf'
    }
  })
};

fetch('https://hg.cash/api/v1/claims', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://hg.cash/api/v1/claims",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accountId' => '550e8400-e29b-41d4-a716-446655440123',
    'from' => 'Juan Pérez',
    'to' => 'Mi cuenta HG',
    'operationNumber' => '987654321',
    'coelsaCode' => '67REZ8NPQDQ460QK94KVGO',
    'amount' => 1500,
    'currency' => 'ARS',
    'file' => [
        'contentBase64' => '<bytes de PDF o imagen en base64>',
        'mimeType' => 'application/pdf',
        'filename' => 'comprobante.pdf'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://hg.cash/api/v1/claims"

	payload := strings.NewReader("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440123\",\n  \"from\": \"Juan Pérez\",\n  \"to\": \"Mi cuenta HG\",\n  \"operationNumber\": \"987654321\",\n  \"coelsaCode\": \"67REZ8NPQDQ460QK94KVGO\",\n  \"amount\": 1500,\n  \"currency\": \"ARS\",\n  \"file\": {\n    \"contentBase64\": \"<bytes de PDF o imagen en base64>\",\n    \"mimeType\": \"application/pdf\",\n    \"filename\": \"comprobante.pdf\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://hg.cash/api/v1/claims")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440123\",\n  \"from\": \"Juan Pérez\",\n  \"to\": \"Mi cuenta HG\",\n  \"operationNumber\": \"987654321\",\n  \"coelsaCode\": \"67REZ8NPQDQ460QK94KVGO\",\n  \"amount\": 1500,\n  \"currency\": \"ARS\",\n  \"file\": {\n    \"contentBase64\": \"<bytes de PDF o imagen en base64>\",\n    \"mimeType\": \"application/pdf\",\n    \"filename\": \"comprobante.pdf\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://hg.cash/api/v1/claims")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440123\",\n  \"from\": \"Juan Pérez\",\n  \"to\": \"Mi cuenta HG\",\n  \"operationNumber\": \"987654321\",\n  \"coelsaCode\": \"67REZ8NPQDQ460QK94KVGO\",\n  \"amount\": 1500,\n  \"currency\": \"ARS\",\n  \"file\": {\n    \"contentBase64\": \"<bytes de PDF o imagen en base64>\",\n    \"mimeType\": \"application/pdf\",\n    \"filename\": \"comprobante.pdf\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "OPEN",
  "operationNumber": "<string>",
  "coelsaCode": "<string>",
  "amount": "1500.00",
  "currency": "ARS",
  "extractedData": {
    "from": "<string>",
    "to": "<string>"
  },
  "originalFilename": "<string>",
  "mimeType": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Autorizaciones

Authorization

string

header

requerido

Token de autenticación de API de usuario con formato cash_<64-char-hex>. Valor de ejemplo cash_16cdc3b6f83c72d9d2680adca4f430962981f6bf32613a129dded0aa060387d2.

Cuerpo

application/json

Datos para crear un reclamo con el comprobante de transferencia adjunto. Todos los metadatos se envían de forma explícita; la API no analiza ni extrae datos del archivo.

from

string

requerido

Cuenta de origen o nombre del pagador según el comprobante.

Ejemplo:

"Juan Pérez"

string

requerido

Nombre de la cuenta de destino según el comprobante.

Ejemplo:

"Mi cuenta HG"

operationNumber

string

requerido

Número de operación bancaria del comprobante.

Ejemplo:

"987654321"

coelsaCode

string

requerido

Código de identificación COELSA (exactamente 22 caracteres alfanuméricos en mayúsculas).

Pattern: ^[A-Z0-9]{22}$

Ejemplo:

"67REZ8NPQDQ460QK94KVGO"

amount

requerido

Monto positivo con como máximo 2 decimales.

Ejemplo:

1500

currency

enum<string>

requerido

Opciones disponibles:

ARS,

USD,

USDT

Ejemplo:

"ARS"

file

object

requerido

Show child attributes

accountId

string<uuid>

Obligatorio para llamadas ADMIN; opcional para USER (asocia el reclamo solo a tu propia cuenta).

Ejemplo:

"550e8400-e29b-41d4-a716-446655440123"

Respuesta

Creado

string<uuid>

requerido

status

enum<string>

requerido

Opciones disponibles:

OPEN,

UNDER_REVIEW,

RESOLVED,

REJECTED

operationNumber

string

requerido

coelsaCode

string

requerido

amount

string

requerido

Monto decimal con 2 decimales.

Ejemplo:

"1500.00"

currency

enum<string>

requerido

Opciones disponibles:

ARS,

USD,

USDT

extractedData

object

requerido

Show child attributes

originalFilename

string

requerido

mimeType

string

requerido

createdAt

string<date-time>

requerido

accountId

string<uuid> | null