BLOCKCHAIN_TRANSFER

Status Transitions
Event
Status
Description
Settlement Created
WAITING_USER
Waiting for on chain transactions to be broadcast. Settlement will skip the READY state and immediately begin monitoring mempool for related transactions.
Transaction seen in mempool
WAITING_EXTERNAL
Transactions observed in mempool with sufficient network fee. Gross value of transactions must sum to expected funding quantity.
Transactions confirmed.
COMPLETE
Transactions have been confirmed a sufficient number of times.
Settlement timed out
CANCELLED
Settlement automatically cancelled as no  mempool transaction observed within two hours.
Excess quantity received
MANUAL_INTERVENTION_REQUIRED
Gross value of transactions exceed expected funding quantity and allow_at_best_recovery is set to false. Settlement must be manually recovered by Liquid support.
Parameters
Setup Parameters
Field
Type
Description
Always Present
account_key
WALLET_ADDRESS
Customer wallet address
true
transaction_key
MEMO_ID
Memo/comment 
false
Input Parameters
None
Result Parameters
Field
Type
Description
Always Present
transaction_key
TRANSACTION_HASH
Transaction Hash
true
​
Example Status Response
GET https://partners.liquid.com/api/v1/transaction/status/3be28d7a-dc2a-4318-b9e8-3d21c1a1d221
1
{
2
  "success": true,
3
  "environment": "PRODUCTION",
4
  "message": "Transaction created. Transaction is filled. Payout has been delivered.",
5
  "payload": {
6
    "transaction_id": "3be28d7a-dc2a-4318-b9e8-3d21c1a1d221",
7
    "api_key": "ef6cf2a7-a6e8-48d1-8c8a-677187dfcd8f",
8
    "status": "FILLED",
9
    "funding_settlement": {
10
      "settlement_instruction_id": "c5937977-d8f2-460a-86a1-3bb24e53e1dc",
11
      "transaction_id": "3be28d7a-dc2a-4318-b9e8-3d21c1a1d221",
12
      "currency": "DASH",
13
      "direction": "FUNDING",
14
      "method": "BLOCKCHAIN_TRANSFER",
15
      "quantity": "0.0010",
16
      "status": "COMPLETE",
17
      "expires": {
18
        "unix_ms": 1589273179767,
19
        "iso8601": "2020-05-12T08:46:19.767Z",
20
        "ttl_ms": 20000
21
      },
22
      "setup_parameters": {
23
        "wallet_address": "Xq33CwAcmgMZqBcENK7sVLFvfpv8yY6cjj"        
24
      },
25
      "result_parameters": {
26
        "wallet_address": "Xq33CwAcmgMZqBcENK7sVLFvfpv8yY6cjj",
27
        "transaction_hash": "7fee4ecf4c55a7924993dad7123f439867e8394754ec791c279cf0807af66ff9"
28
      },
29
      "_links": {
30
        "status": {
31
          "href": "https://partners.liquid.com/api/v1/settlement/status/c5937977-d8f2-460a-86a1-3bb24e53e1dc"
32
        },
33
        "bip21": {
34
          "href": "dash:Xq33CwAcmgMZqBcENK7sVLFvfpv8yY6cjj?amount=0.0010"
35
        },
36
        "bip21_qr_img": {
37
          "href": "https://partners.liquid.com/api/v1/method/qr/c5937977-d8f2-460a-86a1-3bb24e53e1dc"
38
        }
39
      }
40
    },
41
    "payout_settlement": {
42
      "settlement_instruction_id": "e875f3dd-d451-45df-a11f-9d1a31cd0353",
43
      "transaction_id": "3be28d7a-dc2a-4318-b9e8-3d21c1a1d221",
44
      "currency": "BCH",
45
      "direction": "PAYOUT",
46
      "method": "BLOCKCHAIN_TRANSFER",
47
      "quantity": "0.0002840",
48
      "status": "COMPLETE",
49
      "expires": {
50
        "unix_ms": 1589273169343,
51
        "iso8601": "2020-05-12T08:46:09.343Z",
52
        "ttl_ms": 20000
53
      },
54
      "input_parameters": {
55
        "wallet_address": "qqunjlfcuq0kz26e0223kl08nhdt2eldev4jdvyak6"
56
      },
57
      "result_parameters": {
58
        "wallet_address": "16DaPMKt6vHmTB3qpdLPf9CFBBhBZG2Gou",
59
        "transaction_hash": "73bb2bc17cb8278fbb7373687a4c56e46c3dd8b8517dee4dee394ef186955c6e"
60
      },
61
      "_links": {
62
        "status": {
63
          "href": "https://partners.liquid.com/api/v1/settlement/status/e875f3dd-d451-45df-a11f-9d1a31cd0353"
64
        }
65
      }
66
    },
67
    "_links": {
68
      "status": {
69
        "href": "https://partners.liquid.com/api/v1/transaction/status/3be28d7a-dc2a-4318-b9e8-3d21c1a1d221"
70
      }
71
    }
72
  }
73
}
Copied!

Settlements - Previous

Funding Methods

BLOCKCHAIN_DELEGATED_BROADCAST

Last modified 7mo ago

Copy link

Contents

Status Transitions

Parameters

Example Status Response