Cuenca – Python client library

Installation

pip install cuenca

Authentication

The preferred way to configure the credentials for the client is to set the CUENCA_API_KEY and CUENCA_API_SECRET environment variables. The client library will automatically configure based on the values of those variables.

To configure manually:

import cuenca

cuenca.configure(api_key='PKxxxx', api_secret='yyyyyy')

Jwt

JWT tokens can also be used if your credentials have enough permissions. To do so, you may include the parameter use_jwt as part of your configure

import cuenca

cuenca.configure(use_jwt=True)

A new token will be created at this moment and automatically renewed before sending any request if there is less than 5 minutes to be expired according to its payload data.

Transfers

Create transfer

import cuenca

cuenca.configure(sandbox=True)  # if using sandbox

local_transfer_id = '078efdc20bab456285437309c4b75673'

transfer = cuenca.Transfer.create(
    recipient_name='Benito Juárez',
    account_number='646180157042875763',  # CLABE or card number
    amount=12345,  # Mx$123.45
    descriptor='sending money',  # As it'll appear for the customer
    idempotency_key=local_transfer_id
)

# To get updated status
transfer.refresh()

Retrieve by `id`

import cuenca

transfer = cuenca.Transfer.retrieve('tr_123')

Query by `idempotency_key`, `account_number` and `status`

Results are always returned in descending order of created_at

The methods that can be used:

one() - returns a single result. Raises NoResultFound if there are no results and MultipleResultsFound if there are more than one
first() - returns the first result or None if there aren't any
all() - returns a generator of all matching results. Pagination is handled automatically as you iterate over the response
count() - returns an integer with the count of the matching results

import cuenca
from cuenca.types import Status

# find the unique transfer using the idempotency key
local_transfer_id = '078efdc20bab456285437309c4b75673'
transfer = cuenca.Transfer.one(idempotency_key=local_transfer_id)

# returns a generator of all succeeded transfers to the specific account
transfers = cuenca.Transfer.all(
    account_number='646180157000000004',
    status=Status.succeeded
)

# the total number of succeeded transfers
count = cuenca.Transfer.count(status=Status.succeeded)

Balance

Current balance

import cuenca

# balance is the amount in cents
balance = cuenca.get_balance()

Api Keys

Create new `ApiKey` and deactivate old

import cuenca

# Create new ApiKey
new = cuenca.ApiKey.create()

# Have to use the new key to deactivate the old key
old_id = cuenca.session.auth[0]
cuenca.session.configure(new.id, new.secret)
cuenca.ApiKey.deactivate(old_id, 60)  # revoke prior API key in an hour

Create a new password

cuenca.UserCredential.create(password='1234567890')

To update your password

cuenca.UserCredential.update(password='1234567890')

To reset password

cuenca.UserCredential.update(password=None)

cuenca.UserLogin.create(password='1234567890')
...  # authenticated operation
cuenca.UserLogin.logout()

Create login token for biometrics

# Must be logged in
cuenca.UserLogin.create(password='1234567890')
token = cuenca.LoginToken.create()
cuenca.UserLogin.logout()

# Then you can use the token which lasts for 7 days
cuenca.configure(login_token=token)
...  # authenticated operation

Release files for cuenca 2.2.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cuenca 2.2.5
File	Size	Uploaded
cuenca-2.2.5.tar.gz	41.5 kB	Sep 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cuenca 2.2.5
File	Interpreter	ABI	Platform	Reset
cuenca-2.2.5-py3-none-any.whl 75.8 kB Sep 15, 2026	Python 3	none	any	Details

Total release size: 117.3 kB

Release files / cuenca-2.2.5.tar.gz

Download URL	cuenca-2.2.5.tar.gz
Size	41.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`5ce998a64c71c231f86b5795f1ee3623a4bfb53eebb9faf0de470d12a90e471d`
BLAKE2b-256 checksum How to use checksums	`90e134c631d96c3a8e7a3954f3b8199b4b9084b3ca66fc9f78f1c7660cc85f5b`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / cuenca-2.2.5-py3-none-any.whl

Download URL	cuenca-2.2.5-py3-none-any.whl
Size	75.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b5f8b565ec278be0925f85c3086b2a3a7c5026f79f13fe2dad4248638d0bef39`
BLAKE2b-256 checksum How to use checksums	`fa8d6d1d25b30713bd61dbe539e775d4aac03853888d4b7da507e001e9343457`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`