Guides
Find implementation guides, integration notes and platform-specific references.
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.
Rate Limits
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.
Integrating with e-conomic
This guide explains how to set up the e-conomic integration, allowing you to automatically include payment links on invoices using our payment platform and generate journal drafts in e-conomic when payments are received.
Error Codes
Reference the most common ePay API error codes, their meaning, and how they should be handled in client integrations.
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.
SoftPay
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.
Automatic Cleanup
Learn how ePay automatically cleans up old and unused stored payment methods and inactive subscriptions.
Acquirer specifics
This guide explains specialties for specific acquirers - mostly related to reference/order id.
Vipps MobilePay Subscription Cancelled Webhook
If a customer cancels a subscription in the MobilePay app, the subscription will be disabled in ePay. To be notified about this, create a webhook subscribed to the event subscription.disabled.v1. This webhook is useful when you need to update your own subscription state immediately after the customer has canceled outside your own system.