Skip to main content

Accept in-person card payments

Merchants only

This section only applies to merchants accepting card payments. Visit the card payments section for information about payments made with cards from a Swan account.

Step 1: Set up the development environment​

Install the Stripe Terminal SDK and configure your app with the required Apple entitlements and permissions.

→ Set up the development environment

Step 2: Request a merchant profile​

Before accepting in-person card payments, you need a merchant profile.

→ Request a merchant profile

Step 3: Request the payment method​

Request the in-person card payment method to enable your merchants to accept card payments.

→ Request the in-person card payment method

Step 4: Initialize the device​

Set up the connection token provider and connect your device to the Stripe Terminal reader.

→ Initialize the device for payments

Step 5: Create in-person card payments​

Call the API to create payment intents and use the Stripe SDK to process payments.

→ Create in-person card payments

Step 6: Issue a refund​

Refunds not supported

Refunds are currently not supported for in-person card payments. To initiate a refund, ask your merchant to submit a request to the Swan Support team.

Step 7: Test in the Sandbox​

Use Swan's Testing API to simulate payment authorization, rejection, and settlement in a Sandbox environment.

→ Sandbox