Skip to main content
POST
/
v1
/
partner
/
merchants
/
{merchantId}
/
card-payments
/
terminals
/
interapp
curl -X POST https://api.acountpay.com/v1/partner/merchants/42/card-payments/terminals/interapp \
  -H "X-Partner-Client-Id: your-client-id" \
  -H "X-Partner-Client-Secret: your-client-secret" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "registrationCode": "A8K3M2",
  "registrationLink": "checkoutx://register?code=A8K3M2"
}

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

storeId
string
The store ID to register the terminal under. If omitted, the merchant’s default store is used.

Response

registrationCode
string
A short code the merchant enters in the CheckoutX app on their Android device to pair the terminal. Valid for approximately 120 seconds.
A deep link URL that can open the CheckoutX app directly (if available).

Flow

  1. Call this endpoint to generate a registration code
  2. The merchant enters the code in the CheckoutX app on their Android device
  3. The app pairs with the store and registers as a Tap to Pay terminal
  4. Poll the interapp status endpoint to check if registration completed
curl -X POST https://api.acountpay.com/v1/partner/merchants/42/card-payments/terminals/interapp \
  -H "X-Partner-Client-Id: your-client-id" \
  -H "X-Partner-Client-Secret: your-client-secret" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "registrationCode": "A8K3M2",
  "registrationLink": "checkoutx://register?code=A8K3M2"
}