Sign in

v1

latestOpenAPI 3.1.02026-08-0671638.9 KB

Create Bulk Cash-In Operations

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
post/api/v1/cash/bulk_operations

Headers

X-Client-Idstring required

Client API key (32-character hex)

X-Signaturestring required

HMAC-SHA256 signature generated using api_secret

X-Timestampstring required

Unix timestamp (seconds since epoch)

Request body

quantityinteger required

Number of cash-in operations to create

expiration_datestring date required

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

Example request

{
  "quantity": 100,
  "expiration_date": "2025-01-20"
}

Response

Bulk operation request accepted and processing started

response_codestring

Response code ("0" for success)

response_textstring

Response message

Example response

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