Skip to main content

Payment Service API Overview

Payment Service API is designed for server-to-server integrations.

Base Routes​

  • /integration/invoices
  • /integration/fees

Auth Model​

Headers required on every request:

  • x-depay-timestamp
  • x-depay-signature

Server validates signature recovery, timestamp window, and replay uniqueness.

For exact signing format and message structure, see Payment Service Request Signing.

Action Values​

  • invoice.create
  • invoice.status
  • invoice.delete
  • invoice.list
  • fee.set-meta
  • fee.set-payout-meta

Default Invoice Expiration​

  • 1 hour from creation unless explicit expiresAt is provided.

Integration Notes​

  • Keep action value aligned with endpoint intent.
  • Canonical JSON used for signature must match request payload exactly.
  • Regenerate signature when timestamp changes.