Skip to main content

​
What is the Partner API?

The Partner API lets partners onboard their merchants onto AcountPay and accept QR-based bank payments at physical terminals. Your merchants’ customers scan a QR code, pick their bank, and pay — all in a few seconds.
The Partner API is designed for POS providers, payment integrators, and platforms that manage multiple merchants.

​
How It Works

​
Quick Start

​
1. Sign up on the Partner Dashboard

Register at partner.acountpay.com. Your account will be reviewed and approved by our team.

​
2. Generate API credentials

Once approved, go to API Credentials in the Partner Dashboard and generate a client ID and secret.

​
3. Onboard a merchant

Create a merchant and share the onboarding link: 
curl -X POST https://api.acountpay.com/v1/partner/merchants \
  -H "X-Partner-Client-Id: your-client-id" \
  -H "X-Partner-Client-Secret: your-client-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Restaurant XYZ",
    "contactEmail": "owner@restaurant-xyz.dk"
  }'
The merchant completes onboarding via the returned onboardingUrl.

​
4. Create a payment

Once the merchant is active, create payments from your POS: 
curl -X POST https://api.acountpay.com/v1/partner/payments \
  -H "X-Partner-Client-Id: your-client-id" \
  -H "X-Partner-Client-Secret: your-client-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantClientId": "merchant-uuid-here",
    "amount": 149.50,
    "referenceNumber": "ORDER-123",
    "description": "Table 5"
  }'
Response: 
{
  "paymentId": 456,
  "paymentUrl": "https://pos.acountpay.com/pay?token=...",
  "status": "pending",
  "amount": 149.50,
  "currency": "DKK",
  "referenceNumber": "ORDER-123"
}

​
5. Display QR code

Render the paymentUrl as a QR code on your POS terminal. Any QR library works — you just encode the URL string.

​
6. Get notified

Set up a webhook to receive instant payment.completed notifications, or poll GET /partner/payments/{id}/status.

​
Base URL

https://api.acountpay.com/v1

​
Next Steps