sumup

Blueprint SumUp terminal and online checkout flows with SDKs and APIs.

Updated Dec 28, 2023
One-click install
npx skills add https://github.com/Immanuel-Detmold/cafe --skill sumup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sumup
Source: https://github.com/Immanuel-Detmold/cafe/tree/main/.agents/skills/sumup
Command: npx skills add https://github.com/Immanuel-Detmold/cafe --skill sumup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

SumUp provides a consolidated guide for building and debugging end-to-end checkout flows that cover both terminal (card-present) and online (card-not-present) scenarios using SumUp SDKs and APIs. It helps teams implement checkout creation, payment processing, reader pairing, Card Widget integrations, Cloud API reader checkouts, and authorization setups with API keys or OAuth and Affiliate Keys.

Core Features & Use Cases

  • Terminal payments (native mobile SDKs, Cloud API for Solo, or Payment Switch) for in-person checkout flows.
  • Online payments (Card Widget and API-orchestrated checkout flow) for card-not-present scenarios.
  • Guidance on credential setup, flow selection, and end-to-end orchestration, including 3DS and webhook handling, with references to the SumUp playbook.

Quick Start

Implement a complete SumUp checkout flow end-to-end by selecting the integration path (terminal or online), creating a unique checkout reference, and validating status via backend reads and webhooks.

Frequently Asked Questions about sumup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate SumUp checkout for both terminal and online payments?

SumUp checkout integration requires selecting a terminal or online flow path, creating a unique checkout_reference, and validating status via backend reads and webhooks. This blueprint covers card-present SDKs and card-not-present API orchestration end-to-end.

What credentials do I need to set up a SumUp terminal checkout?

SumUp terminal checkout requires your merchant_code, API key or OAuth tokens, and specific affiliate keys for card-present transactions. You must also ensure currency alignment and configure webhook endpoints to process payment statuses correctly.

Can I use the SumUp Cloud API for Solo terminal checkouts instead of native mobile SDKs?

Yes, the SumUp Cloud API supports Solo terminal checkouts as an alternative to native iOS and Android SDKs. This allows you to orchestrate card-present reader checkouts directly from your backend without relying on mobile application integrations.

How does 3DS and webhook handling work for online SumUp payments?

Online SumUp payments use the Checkouts API or Card Widget to initiate 3DS authentication, with webhook endpoints receiving asynchronous status updates. Your backend must validate these webhooks and handle idempotent requests to ensure consistent payment state.

What is the best way to orchestrate a SumUp online checkout flow via the Card Widget?

The best way to orchestrate a SumUp online checkout is using the Card Widget for frontend card capture combined with the Checkouts API for backend processing. You generate a unique checkout_reference, submit payment details, and verify the final status through webhook notifications.