POST
https://api.stableyard.fi
/
sdk
/
v1
/
settle
curl -X POST https://api.stableyard.fi/sdk/v1/settle \
  -H "x-sdk-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "quoteId": "quote_xyz789",
      "nonce": "123456",
      "deadline": 1705315200
    },
    "signature": "0x...",
    "domain": {
      "name": "Stableyard",
      "version": "1",
      "chainId": 8453,
      "verifyingContract": "0x..."
    },
    "types": {
      "Settlement": [
        { "name": "quoteId", "type": "string" },
        { "name": "nonce", "type": "uint256" },
        { "name": "deadline", "type": "uint256" }
      ]
    }
  }'
{
  "success": true,
  "data": {
    "message": "Settlement initiated",
    "transactionId": "tx_abc123xyz",
    "status": "pending"
  },
  "requestId": "req_xyz789"
}
Execute a payment settlement using a previously created quote.

Authentication

x-sdk-key
string
required
Your API authentication key

Body Parameters

payload
object
required
Quote payload from the /quote response containing quoteId, nonce, deadline
signature
string
required
EIP-712 signature from the user authorizing the payment
domain
object
required
EIP-712 domain parameters (name, version, chainId, verifyingContract)
types
object
required
EIP-712 type definitions for the settlement message

Response

success
boolean
Indicates if the request was successful
data
object
Settlement result
curl -X POST https://api.stableyard.fi/sdk/v1/settle \
  -H "x-sdk-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "quoteId": "quote_xyz789",
      "nonce": "123456",
      "deadline": 1705315200
    },
    "signature": "0x...",
    "domain": {
      "name": "Stableyard",
      "version": "1",
      "chainId": 8453,
      "verifyingContract": "0x..."
    },
    "types": {
      "Settlement": [
        { "name": "quoteId", "type": "string" },
        { "name": "nonce", "type": "uint256" },
        { "name": "deadline", "type": "uint256" }
      ]
    }
  }'
{
  "success": true,
  "data": {
    "message": "Settlement initiated",
    "transactionId": "tx_abc123xyz",
    "status": "pending"
  },
  "requestId": "req_xyz789"
}
Settlements are final. Ensure quote details are correct before signing.