Skip to main content
GET
/
v1
/
partner
/
merchants
/
{merchantId}
/
card-payments
/
terminals
curl "https://api.acountpay.com/v1/partner/merchants/42/card-payments/terminals?terminalType=SelfHostedPage" \
  -H "X-Partner-Client-Id: your-client-id" \
  -H "X-Partner-Client-Secret: your-client-secret"
{
  "terminals": [
    {
      "terminalId": "term_abc123",
      "terminalType": "SelfHostedPage",
      "terminalStatus": "ACTIVE",
      "terminalPublicKey": "pk_live_abc123def456..."
    },
    {
      "terminalId": "term_def456",
      "terminalType": "checkoutX",
      "terminalStatus": "ACTIVE",
      "terminalName": "Store iPad"
    }
  ],
  "total": 2
}

Authentication

X-Partner-Client-Id
string
required
Your partner client ID
X-Partner-Client-Secret
string
required
Your partner client secret

Path Parameters

merchantId
integer
required
The numeric merchant ID

Query Parameters

terminalType
string
Filter by terminal type (e.g. SelfHostedPage, PaymentPage, MerchantInitiated, checkoutX)

Response

terminals
array
List of terminals registered for this merchant. Each terminal includes:
  • terminalId — Unique terminal identifier
  • terminalType — Terminal type (SelfHostedPage, PaymentPage, MerchantInitiated, checkoutX, etc.)
  • terminalStatus — Current status (ACTIVE, REGISTERED, INACTIVE)
  • terminalName — Display name (if set)
  • terminalPublicKey — Public key for SDK initialization (online terminals only)
total
integer
Total number of terminals
curl "https://api.acountpay.com/v1/partner/merchants/42/card-payments/terminals?terminalType=SelfHostedPage" \
  -H "X-Partner-Client-Id: your-client-id" \
  -H "X-Partner-Client-Secret: your-client-secret"
{
  "terminals": [
    {
      "terminalId": "term_abc123",
      "terminalType": "SelfHostedPage",
      "terminalStatus": "ACTIVE",
      "terminalPublicKey": "pk_live_abc123def456..."
    },
    {
      "terminalId": "term_def456",
      "terminalType": "checkoutX",
      "terminalStatus": "ACTIVE",
      "terminalName": "Store iPad"
    }
  ],
  "total": 2
}