Transfer Wallet Balance

POST

/chizpay/v1.0/wallet-transactions

Transfers balance from one user wallet to another through paired internal ledger rows. Requests must be signed with HMAC-SHA256 using the ChizPay signing secret, and include a fresh nonce and timestamp (epoch milliseconds) within the server's replay window (default 5 minutes).

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Successful response.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.chizmis.com/chizpay/v1.0/wallet-transactions' \
--header 'authorization;' \
--header 'Content-Type: application/json' \
--data '{
    "senderAccountId": 1001,
    "receiverAccountId": 2002,
    "amount": 50,
    "referenceNumber": "transfer_20260506_0001",
    "nonce": "b3d9a8f2-7fb2-4f45-a22a-2c52b602ef74",
    "timestamp": 1778062500000,
    "signature": "5a7f3e2b9c4a1d8e6f0b2a5c7d9e1f3a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4"
}'

Response Example

200 - Success

{
    "success": true,
    "response": {
        "senderTx": {
            "id": 50101,
            "accountId": 1001,
            "walletId": 9123,
            "type": "SEND",
            "bound": "OUT",
            "amount": 50,
            "status": "COMPLETED",
            "referenceNumber": "transfer_20260506_0001"
        },
        "receiverTx": {
            "id": 50102,
            "accountId": 2002,
            "walletId": 8450,
            "type": "RECEIVE",
            "bound": "IN",
            "amount": 50,
            "status": "COMPLETED",
            "referenceNumber": "transfer_20260506_0001"
        }
    }
}

Modified at 2026-08-06 06:07:58

Get Wallet by Account ID

Get Wallet Transaction History