Skip to main content

Guides

This guide walks through how to integrate Softpay using the ePay API for physical terminals, with a focus on getting app switching to behave reliably and predictably.

Our APIs enforce per-merchant rate limits across endpoint categories. Responses include standard headers such as X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and Retry-After to help you handle retries.

Reference the most common ePay API error codes, their meaning, and how they should be handled in client integrations.

Updating Payment Method for a Subscription

Merchants can update the payment method of an existing subscription by initiating a payment session and referencing the subscription ID.

Vipps MobilePay Campaign Functionality

Campaigns are a way to make the user feel a little special in the agreement sign up process. With the campaign functionality merchants can present their users a special offer at sign up

Using the Idempotency-Key Header

Learn how to safely retry requests without creating duplicate payments or operations by using the Idempotency-Key header to ensure consistent, reliable API behavior.

Automatic Cleanup

Learn how ePay automatically cleans up old and unused stored payment methods and inactive subscriptions.

Integrating with e-conomic

Learn how to set up the e-conomic integration, configure payment links, and automatically create journal drafts for invoices and webshop transactions.

Prevent Cloudflare from Blocking ePay Webhooks

This guide explains how to create a Custom Rule in Cloudflare to allow your ePay callback URL to pass without being blocked.

Acquirer specifics

This guide explains specialties for specific acquirers - mostly related to reference/order id