MolnPayDocs
API reference

Deposits

GET/v1/deposits
AuthorizationBearer <token>

Authorization: Bearer mp<64 hex> for live, mptest<64 hex> for test.

The token is the prefix plus 64 lowercase hex characters (32 CSPRNG bytes) and nothing else — no separators, no embedded fields — so nothing in it needs quoting, escaping or encoding. Send it in the Authorization header and nowhere else. Never put it in a query string: URLs reach access logs, proxy logs, browser history and Referer headers, and a key that lands in any of those is a leaked key. A key's KIND (checkout, payout or wallet) is a property of the key, not of the string: it is chosen at creation, returned by GET /v1/ping, and decides which routes the key may reach.

The full key is shown exactly once, at creation. No endpoint can return it afterwards. Moving funds additionally requires signing to be enabled globally, for your project, and for that key — so a read-only key is a supported configuration.

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
Default25
cursor?string

Opaque cursor from the previous page's next_cursor.

customer_id?string
Formatuuid
wallet_id?string
Formatuuid
chain?string

Value in

  • "ethereum"
  • "bsc"
  • "polygon"
  • "arbitrum"
  • "base"
  • "avalanche"
  • "tron"
  • "solana"
  • "ton"
  • "bitcoin"
  • "dogecoin"
  • "optimism"
  • "linea"
  • "zksync"
  • "scroll"
status?string

Value in

  • "detected"
  • "confirmed"
  • "failed"
  • "orphaned"
since?string
Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/deposits"
{  "object": "list",  "has_more": true,  "next_cursor": "string",  "data": [    {      "object": "deposit",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",      "wallet_id": "d9a8fbfc-848f-43a2-9168-911ed3a04a48",      "chain": "ethereum",      "asset": {        "chain": "ethereum",        "symbol": "USDT",        "decimals": 6,        "contract": "string"      },      "amount": "1500000000000000000",      "amount_decimal": "string",      "tx_hash": "string",      "log_index": 0,      "from_address": "string",      "confirmations": 0,      "required_confirmations": 0,      "status": "detected",      "block_time": "2019-08-24T14:15:22Z",      "explorer_url": "string",      "ledger_tx_id": "0b1a05ef-3576-45c3-b8af-b818b0138be4",      "created_at": "2019-08-24T14:15:22Z"    }  ]}
GET/v1/deposits/{id}
AuthorizationBearer <token>

Authorization: Bearer mp<64 hex> for live, mptest<64 hex> for test.

The token is the prefix plus 64 lowercase hex characters (32 CSPRNG bytes) and nothing else — no separators, no embedded fields — so nothing in it needs quoting, escaping or encoding. Send it in the Authorization header and nowhere else. Never put it in a query string: URLs reach access logs, proxy logs, browser history and Referer headers, and a key that lands in any of those is a leaked key. A key's KIND (checkout, payout or wallet) is a property of the key, not of the string: it is chosen at creation, returned by GET /v1/ping, and decides which routes the key may reach.

The full key is shown exactly once, at creation. No endpoint can return it afterwards. Moving funds additionally requires signing to be enabled globally, for your project, and for that key — so a read-only key is a supported configuration.

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/deposits/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "object": "deposit",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",  "wallet_id": "d9a8fbfc-848f-43a2-9168-911ed3a04a48",  "chain": "ethereum",  "asset": {    "chain": "ethereum",    "symbol": "USDT",    "decimals": 6,    "contract": "string"  },  "amount": "1500000000000000000",  "amount_decimal": "string",  "tx_hash": "string",  "log_index": 0,  "from_address": "string",  "confirmations": 0,  "required_confirmations": 0,  "status": "detected",  "block_time": "2019-08-24T14:15:22Z",  "explorer_url": "string",  "ledger_tx_id": "0b1a05ef-3576-45c3-b8af-b818b0138be4",  "created_at": "2019-08-24T14:15:22Z"}