API Reference

Create child balance from parent

post
https://sandcaas.undostres.com.mx/wallet/v1/composite-balance/parent//child

Creates a new child balance under an existing parent balance by allocating a portion of the parent's available credit.

The specified credit line (in Mexican cents) is immediately deducted from the parent’s available credit, and both balances are updated atomically to ensure consistency. The parent_id in the path is the external ID (UUID format), not the internal database ID.

The child balance becomes available for transactions as soon as it is created.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length ≤ 32

The composite balance parent’s unique identifier

Body Params
integer
required

The new balance’s credit line in Mexican cents. Must be smaller than or equal to the parent’s available amount

Headers
string
required

OAuth token belonging to the e-commerce

Responses

{
  "text": "Success",
  "timestamp": "2025-10-01T11:38:10.44960254-06:00",
  "endpoint": "/wallet/v1/composite-balance/parent/66acce83856147e791206ca90a6e4b6d/child",
  "error": {},
  "payload": {
    "child": {
      "id": 10249
    },
    "parent": {
      "available_credit": 350000
    }
  }
}

{
  "timestamp": "2025-10-01T11:42:09.889571305-06:00",
  "endpoint": "/wallet/v1/composite-balance/parent/66acce83856147e791206ca90a6e4b6e/child",
  "error": {
    "code": 5000,
    "text": "Validation Error",
    "hints": [
      "Validations for the request failed, please check the parameters and try again",
      "incorrect parent_id"
    ]
  },
  "payload": {}
}

Updated 7 months ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago

Did this page help you?