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

FieldDescription
codeLock identifier; pass as billCode to POST /v2/synthetics/bill-payment
paymentAssetCurrency the bill is settled in (matches the bill's asset)
paymentAgainstCurrency debited from the user's balance
paymentAssetAmountAmount paid to the biller
paymentAgainstAmountAmount debited from the user (after FX conversion if applicable)
paymentPriceExchange rate used for conversion
expireAtLock expiry as an ISO 8601 date; expired locks must be recreated
creationTimeISO 8601 timestamp of lock creation

Request fields

FieldRequiredDescription
userAnyIdConditionalRequired under the End-user model to identify the user. Optional under the Principal Accounts model. The end-user is declared via sender.
billIdYesid from the IBill response
againstYesAsset to debit (ARS, MXN, COP, PEN, CLP, USDT, USDC, or crypto). If different from the bill's asset, FX conversion is applied automatically
amountConditionalRequired for OPEN and FIXED bill types; omit for CLOSED
senderYesPayer identity for compliance
sender.nameYesFirst name
sender.surnameYesLast name
sender.exchangeYesPayer's country
sender.legalIdYesNational 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.


Did this page help you?