Cards

See Cards for the funding model.

get_card_account_status

Parameters: none.

{ "onboard_status": "active", "balance_ars": 45000, "active_cards_count": 2 }

issue_card

Parameter	Type	Required	Description
`limit_ars`	number	✓	Card spending limit in ARS, debited from the card account balance
`label`	string		Optional label
`idempotency_key`	string	✓	Unique key to prevent duplicate issuance
`disable_after_first_use`	boolean		Default `true` (single-use). Pass `false` for a reusable card.

{ "card_id": "3f2a...", "last_four": "4242", "status": "active", "limit_ars": 5000 }

list_cards

Parameter	Type	Required	Description
`status`	string		Filter: `active`, `cancelled`, `creating`, `disabled`
`limit`	integer		Default `20`

{ "cards": [{ "id": "...", "label": null, "last_four": "4242", "status": "active", "limit_ars": 5000, "spent_ars": 1200 }], "count": 1 }

get_card

Parameter	Type	Required	Description
`card_id`	string	✓	Card UUID

Returns { "card": {...}, "transactions": [...last 5] }.

cancel_card

Parameter	Type	Required	Description
`card_id`	string	✓	Card UUID

Refunds limit_ars - spent_ars to the card account.

{ "refunded_ars": 3800 }

get_card_secure_token

Parameter	Type	Required	Description
`card_id`	string	✓	Card UUID

Returns a single-use iframe URL to view PAN/CVV — see Cards → viewing sensitive data.

{ "iframe_url": "https://secure-card-viewer.example/v1/...", "expires_in_seconds": 300 }

fund_card_account

Parameter	Type	Required	Description
`amount_ars`	number	✓	Amount to move from the wallet CVU into the card account
`idempotency_key`	string	✓	Unique key

{ "new_balance_ars": 50000 }

withdraw_card_account

Parameter	Type	Required	Description
`amount_ars`	number	✓	Amount to move from the card account back to the wallet CVU
`idempotency_key`	string	✓	Unique key

{ "new_balance_ars": 20000, "provider_transfer_id": "..." }

list_card_transactions

Parameter	Type	Required	Description
`card_id`	string		Omit to list across all of the user’s cards
`limit`	integer		Default `20`

{
  "transactions": [
    { "ID": "...", "TransactionType": "purchase", "Status": "settled", "AmountARS": 1200, "MerchantName": "MERCADOLIBRE", "CreatedAt": "..." }
  ],
  "count": 1
}