Skip to main content

Payment Service API Fees

Base route: /integration/fees

All requests are signed and include timestamp headers.

POST /integration/fees/set-meta​

Submit owner-signed SetFee data for gasless execution.

{
  "ownerAddress": "0x501BEF961A6f40E063efD6048768b0BC35ab1428",
  "chainId": 8453,
  "feeBps": 200,
  "nonce": "7",
  "deadline": "1714203600",
  "signature": "0x..."
}
curl -X POST '<BASE_URL>/integration/fees/set-meta' \
  -H 'Content-Type: application/json' \
  -H 'x-depay-timestamp: <TIMESTAMP_MS>' \
  -H 'x-depay-signature: <REQUEST_SIGNATURE>' \
  -d '{
    "ownerAddress": "<OWNER_ADDRESS>",
    "chainId": 8453,
    "feeBps": 200,
    "nonce": "7",
    "deadline": "1714203600",
    "signature": "<SET_FEE_EIP712_SIGNATURE>"
  }'

POST /integration/fees/set-payout-meta​

Submit owner-signed SetPayout data for gasless execution.

{
  "ownerAddress": "0x501BEF961A6f40E063efD6048768b0BC35ab1428",
  "chainId": 8453,
  "payoutAddress": "0xAaaAaAaaAaAaAaaAaAAAAAAAAaaaAaAaAaaAaaAa",
  "nonce": "8",
  "deadline": "1714207200",
  "signature": "0x..."
}
curl -X POST '<BASE_URL>/integration/fees/set-payout-meta' \
  -H 'Content-Type: application/json' \
  -H 'x-depay-timestamp: <TIMESTAMP_MS>' \
  -H 'x-depay-signature: <REQUEST_SIGNATURE>' \
  -d '{
    "ownerAddress": "<OWNER_ADDRESS>",
    "chainId": 8453,
    "payoutAddress": "<PAYOUT_ADDRESS>",
    "nonce": "8",
    "deadline": "1714207200",
    "signature": "<SET_PAYOUT_EIP712_SIGNATURE>"
  }'

Validation Rules​

  1. Nonce must match on-chain expected value.
  2. Deadline must be valid at submission time.
  3. EIP-712 owner signature must match payload.

Common Failure Cases​

  • nonce mismatch
  • expired deadline
  • invalid owner signature