Create Bulk Cash-In Operations

POST /api/v1/cash/bulk_operations

Base URL https://dev-api.finco.lat · operationId createBulkCashIn

Creates multiple cash-in operations in bulk. This endpoint accepts a quantity and expiration date, and will generate the specified number of cash-in references asynchronously.

Limits: 1 - 1000 operations per request
Processing: Operations are created asynchronously via background job
Use Case: Useful for pre-generating multiple payment references for distribution

Authorization

ClientAuth API key in header X-Client-Id

Client API key (32-character hex) obtained from client creation process. Must be used with X-Signature and X-Timestamp headers for HMAC authentication.

HMACSignature API key in header X-Signature

HMAC-SHA256 signature generated using your api_secret. Format: HMAC-SHA256(timestamp + "." + requestBody, api_secret)

Timestamp API key in header X-Timestamp

Unix timestamp (seconds since epoch) when the request was created. Used in HMAC signature generation to prevent replay attacks.

Request body application/json · required

quantity integer required

Number of cash-in operations to create

expiration_date string (date) required

Expiration date for all generated operations (YYYY-MM-DD)

Responses

201 Bulk operation request accepted and processing started application/json

response_code string

Response code ("0" for success)

response_text string

Response message

result object

bulk_id result.bulk_id string (uuid)

Unique identifier for tracking the bulk operation

400 Bad Request - Invalid operation parameters application/json

response_code string

Error code identifier

1 60 64

response_text string

Human-readable error message

result object

Additional error context

amount result.amount integer

Requested amount (if applicable)

external_user_id result.external_user_id string

User identifier (if applicable)

reference result.reference string

Reference number (if applicable)

401 Unauthorized - Invalid or missing authentication application/json

error string

Error message

This request is in the Monato · Cash Postman collection.Download collection

Request

# SIGNATURE = HMAC-SHA256(TIMESTAMP + "." + request body, api_secret)
curl -X POST "https://dev-api.finco.lat/api/v1/cash/bulk_operations" \
  -H "X-Client-Id: $CLIENT_ID" \
  -H "X-Signature: $SIGNATURE" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "Content-Type: application/json" \
  -d '{
  "quantity": 100,
  "expiration_date": "2025-01-20"
}'

import crypto from "node:crypto";

const body = JSON.stringify({
  "quantity": 100,
  "expiration_date": "2025-01-20"
});
const TIMESTAMP = Math.floor(Date.now() / 1000).toString();
const SIGNATURE = crypto.createHmac("sha256", API_SECRET).update(TIMESTAMP + "." + body).digest("hex");

const res = await fetch("https://dev-api.finco.lat/api/v1/cash/bulk_operations", {
  method: "POST",
  headers: {
    "X-Client-Id": CLIENT_ID,
    "X-Signature": SIGNATURE,
    "X-Timestamp": TIMESTAMP,
    "Content-Type": "application/json",
  },
  body,
});
const data = await res.json();

import requests
import hashlib
import hmac
import json
import time

payload = {
  "quantity": 100,
  "expiration_date": "2025-01-20"
}
body = json.dumps(payload, separators=(",", ":"))
TIMESTAMP = str(int(time.time()))
SIGNATURE = hmac.new(API_SECRET.encode(), f"{TIMESTAMP}.{body}".encode(), hashlib.sha256).hexdigest()

res = requests.post(
    "https://dev-api.finco.lat/api/v1/cash/bulk_operations",
    headers={
        "X-Client-Id": CLIENT_ID,
        "X-Signature": SIGNATURE,
        "X-Timestamp": TIMESTAMP,
        "Content-Type": "application/json",
    },
    data=body,
)
data = res.json()

Response

{
  "response_code": "0",
  "response_text": "Operacion bulk creada",
  "result": {
    "bulk_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

{
  "response_code": "60",
  "response_text": "Parámetros Incorrectos",
  "result": {
    "amount": 500,
    "external_user_id": "USER123456"
  }
}

{
  "response_code": "60",
  "response_text": "Parámetros Incorrectos, Monto invalido",
  "result": {
    "amount": 5,
    "external_user_id": "USER123456"
  }
}

{
  "response_code": "1",
  "response_text": "Operacion rechazada",
  "result": {
    "amount": 500,
    "external_user_id": "USER123456"
  }
}

{
  "error": "Unauthorized"
}