Settlements

Settlement Status

Status
Description
PARAMETERS_REQUIRED
Information is required. Must be specified through /input_parameters
READY
All information for the settlement has been received. Waiting for the other settlement to be READY or COMPLETE
WAITING_USER
Waiting for the user to take some action not related to the API (eg initiate a blockchain transfer for funding)
WAITING_EXTERNAL
Waiting for some external process.
WAITING_INTERNAL
Waiting for some internal process.
COMPLETE
Settlement is complete
MANUAL_INTERVENTION_REQUIRED
Some error has occoured and the transaction has started in some way (ie funds are locked).
CANCELLED
Some error has occoured or the transaction has timed out and no funds are locked.

Parameters

In the general case, each settlement has four steps, allowing the API to accommodate a wide variety of methods.
post
https://partners.liquid.com
​/api​/v1​/settlement​/method
Define Method
1
POST ​/api​/v1​/settlement​/method
2
3
{
4
"transaction_id": "59356d64-d843-4f6e-99e7-2893b198e364",
5
"method": "BLOCKCHAIN_TRANSFER",
6
"direction": "PAYOUT",
7
"input_parameters": {
8
"wallet_address": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy"
9
}
10
}
11
12
13
RESPONSE 202
14
15
{
16
"success": true,
17
"payload": {
18
"settlement_instruction_id": "1cfbbd0b-3ddc-40b6-9676-3cf91ea6949c",
19
"transaction_id": "59356d64-d843-4f6e-99e7-2893b198e364",
20
"currency": "BTC",
21
"direction": "PAYOUT",
22
"method": "BLOCKCHAIN_TRANSFER",
23
"status": "WAITING_EXTERNAL",
24
"quantity": "0.008",
25
"required_input": {
26
"wallet_address": {
27
"label": "Wallet Address",
28
"required": true,
29
"validation": "^[13][a-km-zA-HJ-NP-Z1-9]{25,34}quot;
30
}
31
},
32
"expires": {
33
"unix_ms": 1583138106331,
34
"iso8601": "2020-03-02T08:35:06.331Z",
35
"ttl_ms": 20000
36
}
37
}
38
}
Copied!
post
https://partners.liquid.com
/api/v1/settlement/parameters
Input Parameters
1
POST /api/v1/settlement/parameters
2
3
{
4
"settlement_instruction_id": "4e18c3eb-2039-4441-a033-16cfec8ec058",
5
"input_parameters": {
6
"wallet_address": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy"
7
}
8
}
9
10
11
RESPONSE 202
12
13
{
14
"success": true,
15
"payload": {
16
"settlement_instruction_id": "4e18c3eb-2039-4441-a033-16cfec8ec058",
17
"transaction_id": "59356d64-d843-4f6e-99e7-2893b198e364",
18
"currency": "BTC",
19
"direction": "PAYOUT",
20
"method": "BLOCKCHAIN_TRANSFER",
21
"status": "WAITING_EXTERNAL",
22
"quantity": "0.008",
23
"input_parameters": {
24
"wallet_address": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy"
25
},
26
"expires": {
27
"unix_ms": 1583138106331,
28
"iso8601": "2020-03-02T08:35:06.331Z",
29
"ttl_ms": 20000
30
}
31
}
32
}
Copied!

No Setup Parameters

For settlement methods where no setup parameters are provided by the server, input parameters and can be optionally supplied when specifying the settlement method.
post
https://partners.liquid.com
/api/v1/settlement/method
Define Method and Input Parameters
1
POST ​/api​/v1​/settlement​/method
2
3
{
4
"transaction_id": "59356d64-d843-4f6e-99e7-2893b198e364",
5
"method": "BLOCKCHAIN_TRANSFER",
6
"direction": "PAYOUT",
7
"input_parameters": {
8
"account_key": {
9
"type": "WALLET_ADDRESS",
10
"value": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy"
11
}
12
}
13
}
14
15
16
RESPONSE 201
17
18
{
19
"success": true,
20
"payload": {
21
"settlement_instruction_id": "1cfbbd0b-3ddc-40b6-9676-3cf91ea6949c",
22
"transaction_id": "59356d64-d843-4f6e-99e7-2893b198e364",
23
"currency": "BCH",
24
"direction": "FUNDING",
25
"method": "BLOCKCHAIN_TRANSFER",
26
"status": "WAITING_EXTERNAL",
27
"quantity": "0.023470",
28
"received_input": {
29
"account_key": {
30
"type": "WALLET_ADDRESS",
31
"value": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy"
32
}
33
},
34
"expires": {
35
"unix_ms": 1583138106331,
36
"iso8601": "2020-03-02T08:35:06.331Z",
37
"ttl_ms": 20000
38
}
39
}
40
}
Copied!
Last modified 6mo ago