Skip to main content

Reserve transaction using wallet allowance

PUT https://wallet.paysera.com/rest/v1/transaction/{transactionKey}/reserve/{walletId}

Reserve transaction - accept and lock funds using the specified wallet's active allowance.

The walletId path parameter indicates which wallet's account pays for the transaction: the client must already have an active allowance for that wallet, and funds are reserved directly from it. No request body is required.

Note: Only new or waiting transactions can be reserved.

Authorization​

This endpoint requires MAC (Message Authentication Code) authentication.

Authorization Header Format:

Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"

Example:

Authorization: MAC id="a9b8c7d6e5f4g3h2", ts="1234567890", nonce="xyz123abc456def", mac="dGhpcyBpcyBhIHJhbmRvbSBtYWMgaGFzaCB2YWx1ZQ==", ext="body_hash=cmFuZG9tQm9keUhhc2hWYWx1ZQ%3D%3D"

For more details, see the Authentication section.

Parameters​

Path Parameters​

NameTypeRequiredDescription
transactionKeystring✓Transaction key
walletIdstring✓Wallet identifier (integer or 'me') whose allowance pays for the transaction

Example​

Request​

PUT https://wallet.paysera.com/rest/v1/transaction/{transactionKey}/reserve/{walletId}
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"

Response​

{
  "transaction_key": "rN8kTqXz",
  "created_at": 1355314332,
  "status": "reserved",
  "type": "automatic",
  "wallet": 45123,
  "valid_for_payment_card_debit": false,
  "reserve": {
    "until": 1355400732,
    "for": 86400
  },
  "auto_confirm": false,
  "project_id": 1234,
  "payments": [
    {
      "id": 2987,
      "transaction_key": "rN8kTqXz",
      "created_at": 1355314332,
      "status": "reserved",
      "cancelable": false,
      "price": 1,
      "currency": "EUR",
      "price_decimal": "0.01",
      "wallet": 45123,
      "freeze": {
        "for": 3600
      },
      "freeze_for": 1,
      "description": "Payment for order No. 1234",
      "parameters": {
        "orderid": 1234
      },
      "transfer_id": 84532,
      "beneficiary": {
        "id": 60123,
        "email": "john@example.com"
      }
    }
  ],
  "inquiries": []
}

AUTHORIZATION: HTTP

REQUEST

Base URL
https://wallet.paysera.com

RESPONSE

Transaction reserved successfully
{
  "transaction_key": "rN8kTqXz",
  "created_at": 1355314332,
  "status": "reserved",
  "type": "automatic",
  "wallet": 45123,
  "valid_for_payment_card_debit": false,
  "reserve": {
    "until": 1355400732,
    "for": 86400
  },
  "auto_confirm": false,
  "project_id": 1234,
  "payments": [
    {
      "id": 2987,
      "transaction_key": "rN8kTqXz",
      "created_at": 1355314332,
      "status": "reserved",
      "cancelable": false,
      "price": 1,
      "currency": "EUR",
      "price_decimal": "0.01",
      "wallet": 45123,
      "freeze": {
        "for": 3600
      },
      "freeze_for": 1,
      "description": "Payment for order No. 1234",
      "parameters": {
        "orderid": 1234
      },
      "transfer_id": 84532,
      "beneficiary": {
        "id": 60123,
        "email": "john@example.com"
      }
    }
  ],
  "inquiries": []
}