Getting started

This guide gets your server talking to the Doggie Pay Integration API. By the end you will:

1. Choose the right product rail (Checkout vs Customers)
2. Create API keys and understand auth headers
3. Call a read endpoint successfully

Base URL

https://api.doggiepay.com

All merchant Integration paths are under /v1/* (not /v1/portal/* and not /ops/*).

1. Choose your product rail

• Checkout → next guide: Accept a payment
• Customers → dedicated guides (create customer, deposits, withdrawals)
• Both rails share auth, Request-Id, and Webhooks

Doggie Pay credits your merchant crypto balance. End-user balances (if any) live in your system.

2. Prerequisites

1. Create a merchant at merchant.doggiepay.com
2. In the portal, create a Secret key (dp_live_sk_…) — store only on your server (env / KMS)
3. Optionally create a Publishable key (dp_live_pk_…) for browser-safe allowlisted calls
4. Configure a Webhook URL and save the one-time webhook_secret (whsec_…) — see Webhooks

Never put a Secret key in a mobile app, SPA, or public repo.

3. Authentication

Credentials

Publishable key allowlist

All other Integration routes require a Secret key.

Required headers (Integration)

Authorization: Bearer dp_live_sk_YOUR_SECRET
X-DoggiePay-Request-Id: 550e8400-e29b-41d4-a716-446655440000
Content-Type: application/json

Idempotency: On create/update, retries after timeouts should reuse the same Request-Id (or Idempotency-Key) and the same body. A replay with a different body returns 409 request_id_conflict.

4. Response envelope

Success:

{
  "data": { },
  "error": null
}

Error:

{
  "data": null,
  "error": {
    "code": "unauthorized",
    "message": "Bearer token required"
  }
}

5. Your first request

List enabled chain aliases (Secret or Publishable):

curl -sS https://api.doggiepay.com/v1/chains \
  -H "Authorization: Bearer dp_live_sk_YOUR_SECRET" \
  -H "X-DoggiePay-Request-Id: $(uuidgen | tr '[:upper:]' '[:lower:]')"

Example data:

{
  "chains": ["ETH", "BASE"]
}

List tokens (optional ?currency=USDC):

curl -sS "https://api.doggiepay.com/v1/tokens?currency=USDC" \
  -H "Authorization: Bearer dp_live_sk_YOUR_SECRET" \
  -H "X-DoggiePay-Request-Id: $(uuidgen | tr '[:upper:]' '[:lower:]')"

6. Common error codes

7. Next steps

1. Accept a payment with Checkout — create a session and open Hosted Checkout
2. Webhooks — verify signatures and mark the order paid on checkout.paid
3. Install @doggiepay/checkout when you embed a pay button in your frontend

Hosts