Reserve transaction
PUT https://wallet.paysera.com/rest/v1/transaction/{transactionKey}/reserve
Reserve transaction - accept and lock funds.
This is the most complex endpoint with multiple reservation methods:
- PIN code
- SMS code
- Reservation code from generator
- Payer information
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​
| Name | Type | Required | Description |
|---|---|---|---|
transactionKey | string | ✓ | Transaction key |
Request Body​
| Field | Type | Required | Description |
|---|---|---|---|
payer | object | Payer information (email, phone, or wallet_id) | |
wallet_id | integer | Wallet ID to reserve from | |
pin_code | string | PIN code for reservation | |
sms_code | string | SMS confirmation code | |
code | string | Reservation code from generator | |
inquiries | array | Answers to inquiries | |
revoke_transaction_key | string | Transaction to revoke before accepting | |
notification | boolean | Subscribe to reservation notifications | |
payment_prices | object | Payment price adjustments | |
payment_funds_sources | object | Payment funds sources |
Example​
Request​
PUT https://wallet.paysera.com/rest/v1/transaction/{transactionKey}/reserve
Content-Type: application/json
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"
{
"wallet_id": 14471,
"pin_code": "1234"
}
Response​
{}
AUTHORIZATION: HTTP
REQUEST
Base URL
https://wallet.paysera.com
Body REQUIRED
{
"wallet_id": 14471,
"pin_code": "1234"
}
RESPONSE
Transaction reserved successfully
{}