Beta · Udviklerplatform

Byg med Payfriend

REST API og MCP-server til håndtering af fakturaer, kunder, betalinger og inkassoflows. Integrér direkte eller lad AI-agenter styre dine workflows.

payfriend-api
$ curl -H "Authorization: Bearer YOUR_TOKEN" https://app.payfriend.io/api/v1/invoices/stats
// Response
{
  "total_count": 847,  "total_amount": 2458350.00,  "overdue_count": 23,  "overdue_amount": 156200.50,  "paid_this_month": 412800.00,  "currency": "DKK"}
Hurtig start

Kom i gang p\u00e5 f\u00e5 minutter

Opret et API-token, send din f\u00f8rste foresp\u00f8rgsel, og begynd at bygge.

1

Opret et token

Gå til Indstillinger → Integrationer i Payfriend-dashboardet. Opret et token med de rettigheder du har brug for.

2

Send en forespørgsel

Brug dit token som Bearer-token i Authorization-headeren. Alle endpoints returnerer JSON.

3

Byg din integration

Brug REST API’et til custom integrationer, eller MCP-serveren til at lade AI-agenter styre dine workflows.

Autentificering

Token-baseret adgang

Alle API-kald kræver et token. REST API bruger Authorization: Bearer, mens MCP-endpoints bruger X-MCP-Token. Opret tokens under Indstillinger → Integrationer.

Afgrænsede rettigheder — opret skrivebeskyttede eller fuld-adgang tokens

SHA-256 hashed — token-værdier gemmes aldrig i klartekst

Valgfri udløbsdato — tilbagekald når som helst fra dashboardet

Token-rettigheder

customers:read / customers:writeLæs og administrér kunder
invoices:read / invoices:writeLæs og administrér fakturaer
payments:read / payments:writeLæs og registrér betalinger
flows:read / flows:writeLæs og administrér inkassoflows
mcp:accessAdgang til MCP-endpoints
*Fuld adgang (alle rettigheder)
REST API
curl -X GET https://app.payfriend.io/api/v1/customers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
MCP Endpoint
curl -X POST https://app.payfriend.io/mcp/v1/customers/list \
  -H "X-MCP-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json"
Svar-format (REST)
{
  "success": ,
  "data": { ... },
  "message": "OK"
}
REST API

API-reference

38 endpoints fordelt på 8 ressourcegrupper. Alle svar er JSON med standard HTTP-statuskoder.

Base URL: https://app.payfriend.io/api/v1

Customers

7 endpoints

GET/customers
GET/customers/{id}
POST/customers
PUT/customers/{id}
DELETE/customers/{id}
POST/customers/{id}/pause
POST/customers/{id}/resume

Customer Groups

7 endpoints

GET/customer-groups
GET/customer-groups/{id}
POST/customer-groups
PUT/customer-groups/{id}
DELETE/customer-groups/{id}
POST/customer-groups/{id}/members
DELETE/customer-groups/{id}/members

Invoices

6 endpoints

GET/invoices
GET/invoices/stats
GET/invoices/{id}
POST/invoices
PATCH/invoices/{id}/status
POST/invoices/{id}/mark-paid

Payments

3 endpoints

GET/payments
GET/payments/{id}
POST/payments

Collection Flows

7 endpoints

GET/flows
GET/flows/{id}
POST/flows
PUT/flows/{id}
POST/flows/{id}/activate
POST/flows/{id}/deactivate
GET/flows/{id}/executions

Credit Notes

3 endpoints

GET/credit-notes
GET/credit-notes/{id}
POST/credit-notes

Suppliers

4 endpoints

GET/suppliers
GET/suppliers/{id}
POST/suppliers
PUT/suppliers/{id}

Collection Stats

1 endpoints

GET/collection/stats
curl -X GET "https://app.payfriend.io/api/v1/invoices?status=overdue&page=1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
MCP Server

AI-native med MCP

Forbind Claude, Cursor eller enhver MCP-kompatibel klient. 33værktøjer til at styre hele din inkasso-workflow via samtale.

claude mcp add payfriend -s user -- npx -y payfriend-mcp --token=YOUR_TOKEN

# Verify connection
claude mcp list
# payfriend: Connected

payfriend-mcp på npm

Customers

5 tools
customers_list
customers_get
customers_create
customers_update
customers_search

Invoices

6 tools
invoices_list
invoices_get
invoices_create
invoices_update_status
invoices_mark_paid
invoices_stats

Payments

2 tools
payments_list
payments_register

Flows

5 tools
flows_list
flows_get
flows_activate
flows_deactivate
flows_executions

Credit Notes

3 tools
credit_notes_list
credit_notes_get
credit_notes_create

Executions

3 tools
executions_pause
executions_resume
executions_cancel

Products

6 tools
products_list
products_get
products_create
products_update
products_delete
products_sync

CVR

2 tools
cvr_search
cvr_lookup

Stats

1 tool
collection_stats

Tal helt naturligt

>"Vis mig alle forfaldne fakturaer"
>"Opret en kunde: Acme ApS, CVR 12345678"
>"Markér faktura 42 som betalt"
>"Opret en kreditnota på 5.000 DKK til Acme"
>"Pausér inkasso-eksekvering 17"
>"Hvad er status på min inkasso lige nu?"
>"Søg efter virksomheder med CVR 12345678"
>"Synkronisér produkter fra ERP"

Klar til at integrere?

Opret dit API-token og begynd at bygge. Beta-adgang inkluderer fuld API- og MCP-adgang.