Skip to main content
POST
/
v1
/
partner
/
merchants
/
{merchantId}
/
card-payments
/
online-terminals
curl -X POST https://api.acountpay.com/v1/partner/merchants/42/card-payments/online-terminals \
  -H "X-Partner-Client-Id: your-client-id" \
  -H "X-Partner-Client-Secret: your-client-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "onlineTerminalMode": "SelfHostedPage"
  }'

{
  "terminalId": "term_abc123",
  "terminalPublicKey": "pk_live_abc123def456...",
  "terminalType": "SelfHostedPage",
  "storeId": "sbs_def456"
}

​
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

​
Body Parameters

​
onlineTerminalMode
string
required
The type of online terminal to register. One of:
  • SelfHostedPage — Embed payment fields directly in the merchant’s website for full UI control
  • PaymentPage — Redirect customers to a hosted payment page (simplest integration)
  • MerchantInitiated — For recurring payments and subscriptions (requires initial customer authentication)
​
storeId
string
The store ID to register the terminal under. If omitted, the merchant’s default store is used.

​
Response

​
terminalId
string
The unique terminal identifier. Use this to reference the terminal in payment operations.
​
terminalPublicKey
string
The public key for initializing the Surfboard Online SDK on the merchant’s website. Required for SelfHostedPage and PaymentPage integrations.
​
terminalType
string
The terminal type that was created (matches the requested onlineTerminalMode)
​
storeId
string
The store ID the terminal was registered under
curl -X POST https://api.acountpay.com/v1/partner/merchants/42/card-payments/online-terminals \
  -H "X-Partner-Client-Id: your-client-id" \
  -H "X-Partner-Client-Secret: your-client-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "onlineTerminalMode": "SelfHostedPage"
  }'

{
  "terminalId": "term_abc123",
  "terminalPublicKey": "pk_live_abc123def456...",
  "terminalType": "SelfHostedPage",
  "storeId": "sbs_def456"
}