HIhifi
Settlement Rules

Create a settlement rule

Changed on

Create a new settlement rule for virtual accounts. Settlement rules define how fees are calculated and distributed when processing an onramp transaction.

post/v2/virtual-accounts/settlement-rules

Request

  • Base URL
    https://production.hifibridge.com
  • URL
    https://production.hifibridge.com/v2/virtual-accounts/settlement-rules
  • Auth
    HTTP bearer

Request body

requestIdstring required

Unique identifier for the request (recommend using uuid v4)

chain'BASE' | 'POLYGON' | 'ETHEREUM' | 'SOLANA' | 'TRON' | 'ARC' required

Blockchain network for the settlement rule, this should be the same as the blockchain network of the virtual account

includeHIFIFeeboolean required

Whether to include HiFi's fee in addition to custom rules, please contact HiFi support if you want to include HiFi's fee

Example request

{
  "requestId": "{{$guid}}",
  "chain": "BASE",
  "rules": [
    {
      "type": "PERCENTAGE",
      "calculationModel": "FIXED",
      "value": 0.001,
      "tiers": [
        {
          "min": "1000",
          "max": "2000",
          "value": 0.0005
        }
      ],
      "walletAddress": "0x15FB50680fEB2f726413416665c25f9B397b047b",
      "trigger": {
        "paymentRail": [
          "ACH"
        ]
      }
    }
  ]
}

Response

Success

idstring required

Unique identifier for the settlement rule

chain'BASE' | 'POLYGON' | 'ETHEREUM' | 'SOLANA' | 'TRON' | 'ARC' required

Blockchain network for the settlement rule

includeHIFIFeeboolean required

Whether to include HiFi's fee in addition to custom rules, please contact HiFi support if you want to include HiFi's fee

Example response

{
  "id": "15c786fb-de7a-520c-a4b3-f312d4a122d2",
  "chain": "BASE",
  "rules": [
    {
      "type": "PERCENTAGE",
      "calculationModel": "FIXED",
      "value": 0.001,
      "tiers": [
        {
          "min": "1000",
          "max": "2000",
          "value": 0.0005
        }
      ],
      "walletAddress": "0x15FB50680fEB2f726413416665c25f9B397b047b",
      "trigger": {
        "paymentRail": [
          "ACH"
        ]
      }
    }
  ]
}

Changes

  • 319fa6bd5bc6Revision changes
    • warning

      added the new ARC enum value to the response property for the response status

    • info

      added the new optional request property //

    • info

      added the new ARC enum value to the request property

    • info

      added the optional property // to the response with the status