Accept in-person card payments
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.
During this phase, Swan manually sets up merchant profiles with the Stripe connection.
After requesting a profile, contact your Product Integration Manager with your merchant profile ID.
They will confirm when setup is complete and provide your $LOCATION_ID.
In a future release, the location ID will be available as mainLocationId on the InPersonCardMerchantPaymentMethod object.
Swan can configure up to 10 profiles per partner during early access.
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 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.
Bonus: Explore the Sandbox
Testing scenarios for in-person card payments are in development.