RevKeen Docs
Api reference

Get external payment methods (temporary credentials)

Fetch payment methods using one-shot credentials supplied in the request body. Used by the activation wizard before credentials are stored, so the merchant can preview the mappings they'll need to configure. Credentials are not persisted by this call.


Related endpoints

  • POST /integrations/{provider}/activate — Activate integration
  • POST /integrations/{provider}/deactivate — Deactivate integration
  • GET /integrations/{provider} — Get integration status
  • POST /integrations/{provider}/test — Test integration credentials
  • POST /integrations/{provider}/sync — Trigger manual sync
  • GET /integrations — List all integrations
  • PUT /integrations/{provider}/status — Update integration status
  • PUT /integrations/{provider}/sync-toggle — Toggle integration sync

Common errors

  • 401 unauthenticated — missing, malformed, or revoked API key.

Idempotency

Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.

POST
/integrations/{provider}/payment-methods
x-api-key<token>

Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.

In: header

Path Parameters

provider*string
Value in"practicehub" | "wodify" | "terminal"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://api.revkeen.com/v2/integrations/practicehub/payment-methods" \  -H "x-api-key: $REVKEEN_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "baseUrl": "https://example.com",    "apiKey": "string"  }'
{
  "success": true,
  "data": [
    {
      "id": 0,
      "name": "string",
      "active": true,
      "sort_order": 0
    }
  ]
}
Empty
Empty