Lock payment
Lock payment
Locking validates the bill data and reserves the execution context—including any FX conversion—before payment is confirmed. The lock response contains a code and a price guarantee valid until expireAt.
Lock request
curl -X POST https://sandbox.manteca.dev/crypto/v2/bill-locks \
-H "md-api-key: $MD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"userAnyId": "100036128",
"billId": "fc69e897-0854-4b9f-8454-076ebd03b41c-0",
"against": "USDT",
"amount": 7000,
"sender": {
"name": "JANE",
"surname": "DOE",
"exchange": "ARGENTINA",
"legalId": "00000000000"
}
}'Lock response
{
"code": "fa44218d-7b3c-4a1e-bc9f-2d5e8f01c3a7",
"userId": "6931d911f67f71eca0e7f9a0",
"userNumberId": "100036128",
"paymentAsset": "ARS",
"paymentAgainst": "USDT",
"paymentAssetAmount": "7000.00",
"paymentAgainstAmount": "5.49019608",
"paymentPrice": "1275.00000000",
"expireAt": "2026-10-22T18:30:00.000-03:00",
"creationTime": "2025-12-04T16:16:14.959-03:00"
}Response fields
| Field | Description |
|---|---|
code | Lock identifier; pass as billCode to POST /v2/synthetics/bill-payment |
paymentAsset | Currency the bill is settled in (matches the bill's asset) |
paymentAgainst | Currency debited from the user's balance |
paymentAssetAmount | Amount paid to the biller |
paymentAgainstAmount | Amount debited from the user (after FX conversion if applicable) |
paymentPrice | Exchange rate used for conversion |
expireAt | Lock expiry as an ISO 8601 date; expired locks must be recreated |
creationTime | ISO 8601 timestamp of lock creation |
Request fields
| Field | Required | Description |
|---|---|---|
userAnyId | Conditional | Required under the End-user model to identify the user. Optional under the Principal Accounts model. The end-user is declared via sender. |
billId | Yes | id from the IBill response |
against | Yes | Asset to debit (ARS, MXN, COP, PEN, CLP, USDT, USDC, or crypto). If different from the bill's asset, FX conversion is applied automatically |
amount | Conditional | Required for OPEN and FIXED bill types; omit for CLOSED |
sender | Yes | Payer identity for compliance |
sender.name | Yes | First name |
sender.surname | Yes | Last name |
sender.exchange | Yes | Payer's country |
sender.legalId | Yes | National ID or tax number |
Notes
Lock TTL. expireAt is an ISO 8601 date, for example 2026-10-22T18:30:00.000-03:00. Locks typically expire within minutes. If expired, create a new lock before executing.
FX conversion. When against differs from the bill's asset (e.g., debiting USDT to pay an ARS bill), the conversion is handled automatically. paymentPrice shows the rate locked in.
Read back a lock. If needed, retrieve lock details with GET /v2/bill-locks/{code}.
Continue to Make a payment with the code from this response.
Updated 27 days ago
Did this page help you?