SumUp

This connector interacts with the SumUp API (developer.sumup.com).

Setup:

1. Log in to the SumUp Dashboard at https://me.sumup.com.
2. Navigate to Settings → For Developers (or Developer Portal).
3. Generate an API Key (Personal Access Token).
4. Set SUMUP_API_KEY.

Authentication: Authorization: Bearer ${SUMUP_API_KEY}.

Overview of capabilities:

• Retrieve authenticated merchant account and profile details.
• Query transaction history with date range, status, and pagination filters.
• Fetch specific transaction details by code or ID.
• List payouts and bank settlement batches.
• List customer checkouts and payment links.
• List operator subaccounts.

Read-only by design: SumUp is a payments account, so this connector only reads. It has no tools that refund, charge, create checkouts, start reader payments or change members; do those in the SumUp dashboard.

Merchant code: the current SumUp API addresses an account by its merchant code (e.g. MH4H92C7). Find it with sumup_get_merchant_profile (merchant_profile.merchant_code) or, when the key reaches several accounts, with sumup_list_memberships (resource.id). sumup_get_merchant shows the account.

Money in and out: sumup_list_merchant_transactions (v2.1, filters by time, status, type, payment type and user) and sumup_get_merchant_transaction replace the older sumup_list_transactions / sumup_get_transaction, which stay for existing setups. sumup_get_receipt returns the receipt of a transaction. sumup_list_merchant_payouts lists payouts and deductions (refunds, chargebacks) between two dates. Amounts are in major units (12.50 = 12.50 EUR); times are ISO 8601 in UTC.

Online payments: sumup_list_checkouts, sumup_get_checkout, sumup_list_payment_methods, and saved customers with sumup_get_customer and sumup_list_payment_instruments (tokenized cards, last four digits only).

Team and devices: sumup_list_members, sumup_get_member, sumup_list_roles, sumup_get_role, sumup_list_persons, sumup_get_person; card readers with sumup_list_readers, sumup_get_reader, sumup_get_reader_status and sumup_get_reader_checkout.

Paging: v2.1 transactions return links; take oldest_ref or newest_ref from the link href for the next page. Memberships and members page with offset and limit.

Errors: 401 means the API key is wrong or revoked; 403 that the key's user lacks the permission for that account; 404 an unknown merchant code or id.