1. Payment Providers
Confirma Payment Platform
  • Developer Guide
  • Confirma Optio Setup Guide (Onsite-Terminal)
  • Basic Flow Guide
  • Changelog
  • Payment Providers
    • Viva Developers' Guide
    • Epassi Developers' Guide
    • Retain24 Developers' Guide
    • Resurs Developers' Guide
    • SoftPay Developers' Guide
    • Nets Baxi Developers' Guide
    • Worldline Developers' Guide
    • Nexi Developers' Guide
    • Verifone Vim Developers' Guide
    • Nets Baxi Cloud Developers' Guide
  • v1
    • Authentication
      • Obtain a token
    • Callback
      • Redirect transaction flow
    • Device
      • /{tenantCode}/v1/device/configuration
      • Terminal device details
      • Print receipt on Terminal
      • Print receipt on Terminal
    • GiftCard
      • Get the available templates
      • Get template by Id
      • Create and Issue a Card
      • Top Up a Card
      • Get a Card
      • Validate a Card
      • Cancel a card
      • Cancel the last topup of the card
    • Payment
      • Create a new payment request
      • Marks the day end
    • PaymentChannel
      • Get payment channel merchants
      • Get available payment channels
      • Get configured payment channels
      • Get payment channel configuration requirements
      • Save payment channel configuration
      • Enable payment channel
      • Disable payment channel
      • Create a new account
      • /{tenantCode}/v1/payment-channel/viva
      • Get payment channel stores
      • Get payment method basic details
      • Get payment method content
      • Get payment channel merchants
    • Report
      • Get End Of Day Reports
      • Save End Of Day Reports
      • Get End Of Day Reports by reference
      • Get Last End Of Day Report
    • Transaction
      • Get customer receipt for a transaction
      • Get the transaction status
      • Cancel a transaction
      • Refund a transaction
      • Generic Refund (Without existing Transaction Id)
      • Save a receipt for a transaction
      • Get merchant receipt for a transaction
      • Submit refund pin
    • Storage
      • Gets a secure update url for the storage
    • TenantWebhook
      • /{tenantCode}/v1/tenant-webhook/{provider}/viva/account
      • /{tenantCode}/v1/tenant-webhook/{provider}/viva/account
      • /{tenantCode}/v1/tenant-webhook/resurs/authorisation/transactions/{transactionUUID}
      • /{tenantCode}/v1/tenant-webhook/resurs/management/transactions/{transactionUUID}
    • Webhook
      • /v1/webhook/{provider}/viva/account
      • /v1/webhook/{provider}/viva/account
      • /v1/webhook/{provider}/viva/payment-created
      • /v1/webhook/{provider}/viva/payment-created
      • /v1/webhook/{provider}/viva/payment-failed
      • /v1/webhook/{provider}/viva/payment-failed
      • /v1/webhook/{provider}/viva/reversal-created
      • /v1/webhook/{provider}/viva/reversal-created
  • Schemas
    • v1
      • AdditionalPaymentMethods
      • SupportedPaymentChannel
      • ResponseDto
      • AdditionalPaymentMethods
      • SupportedPaymentChannelListResponseDto
      • AccountDetailsDto
      • AccountDetailsDtoListResponseDto
      • AddressDto
      • ApplicationMessageDto
      • AvailablePaymentChannelDetailDto
      • AvailablePaymentChannelDetailDtoListResponseDto
      • BooleanResponseDto
      • BrandColour
      • CancelIntentDto
      • CreateAccountRequestDto
      • CancelIntentDtoResponseDto
      • CreateAccountResponseDto
      • ClientCredentialTokenRequestDto
      • CreateAccountResponseDtoResponseDto
      • ClientOverrideDto
      • CollectionPromptChannel
      • CollectionPromptChannelDto
      • ContentDto
      • CountryCode
      • CreateGiftCardRequestDto
      • CreateNewAccountDto
      • CreateNewAccountResponseDto
      • CreateNewAccountResponseDtoResponseDto
      • CreatePaymentIntentDto
      • CurrencyCodes
      • CustomerDisplayType
      • CustomerInfoDto
      • WorldLineRefundOptions
      • CustomerType
      • DeviceConfiguration
      • DeviceSpecificationDto
      • DiscountDetailsDto
      • DiscountType
      • EndDayRequestDto
      • EndDayResponseDto
      • EndDayResponseDtoResponseDto
      • EpassiChannelOptions
      • ErrorResponseDto
      • GenericRefundPaymentIntentDto
      • GetCardDetailsRequestDto
      • TokenRequestDto
      • GiftCardDetailsDto
      • GiftCardDetailsDtoResponseDto
      • GiftCardPersonalizedMessageLengthDto
      • GiftCardPreviewDto
      • GiftCardStatus
      • GiftCardTemplateDetailsDto
      • GiftCardTemplateDetailsDtoListResponseDto
      • GiftCardTemplateDetailsDtoResponseDto
      • LegalLink
      • NetsBaxiChannelOptions
      • NetsBaxiCloudChannelOptions
      • NexiChannelOptions
      • OnsiteTerminalReportDto
      • NotificationChannel
      • OnsiteTerminalReportDtoResponseDto
      • NotificationOptions
      • ObjectResponseDto
      • OnboardCustomerRequestDto
      • OnboardCustomerResponseDto
      • OnboardCustomerResponseDtoResponseDto
      • OrderItemDto
      • OrderItemType
      • PaymentChannelType
      • POSType
      • PanEntryMode
      • PaymentAdditionalInfoDto
      • PaymentChannelAccountMetadata
      • PaymentChannelConfigurationFieldsDto
      • PaymentChannelConfigurationSchemaDto
      • PaymentChannelConfigurationSchemaDtoResponseDto
      • PaymentChannelMetaData
      • PaymentChannelMetaDataVerifoneVim
      • PaymentChannelMetaDataWestPay
      • PaymentChannelMetaDataWorldline
      • PaymentChannelOptionsDto
      • PaymentChannelOptionsForGenericRefundDto
      • PaymentChannelOptionsForRefundDto
      • PaymentFlowType
      • PaymentIntentDto
      • PaymentIntentDtoResponseDto
      • PaymentMethod
      • PaymentMethodBasicInfoResponseDto
      • PaymentMethodBasicInfoResponseDtoListResponseDto
      • PaymentMethodContentResponseDto
      • PaymentMethodContentResponseDtoResponseDto
      • PaymentMethodDto
      • PaymentStatus
      • PaymentSubStatus
      • PriceSignagePreview
      • PrintOnTerminalRequestDto
      • PrintOnTerminalResponseDto
      • PrintOnTerminalResponseDtoResponseDto
      • StoreDetailsDto
      • PrintResponseDto
      • StoreDetailsDtoListResponseDto
      • ReasonCode
      • ReceiptResponseDto
      • ReceiptResponseDtoResponseDto
      • ReceiptType
      • RefundPaymentIntentDto
      • RefundPaymentPinDto
      • ReportResponseDto
      • ReportResponseDtoResponseDto
      • ReportType
      • ResursChannelOptions
      • Retain24AccountOptions
      • Retain24ChannelOptions
      • SaveOnsiteTerminalReceiptDto
      • SaveOnsiteTerminalReportDto
      • MerchantsInformationDto
      • SoftPayChannelOptions
      • MerchantsInformationDtoListResponseDto
      • StringObjectDictionaryResponseDto
      • StringResponseDto
      • SupportedPaymentChannelDto
      • SupportedPaymentChannelDtoListResponseDto
      • TerminalDetailsResponseDto
      • TerminalDetailsResponseDtoResponseDto
      • TerminalStatus
      • Tip
      • TokenResponseDto
      • TokenResponseDtoResponseDto
      • TopupGiftCardRequestDto
      • TransactionStatusDto
      • TransactionType
      • TransactionStatusDtoResponseDto
      • UpdatePaymentChannelAccountDto
      • UpdateTransactionDto
      • VerifoneVimChannelOptions
      • VivaChannelOptions
      • VivaIsvSettingsDto
      • Void
      • WorldLineChannelOptions
      • PaymentChannelMetaDataWorldline
      • PrintOnTerminalRequestDto
      • PrintOnTerminalResponseDto
      • PrintOnTerminalResponseDtoResponseDto
      • Retain24ChannelOptions
      • WorldLineChannelOptions
      • WorldLineRefundOptions
      • PrintOnTerminalRequestDto
  1. Payment Providers

Epassi Developers' Guide

Epassi Developer's Guide#

Setup Instructions
Sandbox
Production
1.
Email your request to the support specifying the test mobile os type and your email to download the test apps (Epassi for partners and Epassi Configuration) from store. In response you will receive the Epassi PosName, User ID, Employee ID and Phone Number along with test apps access invitation to the email you specified.
Once the apps are installed, it’s important to change the environment server the app uses. Otherwise the production server will used.
Navigate System Settings -> (Apps if iOS 18) -> Epassi For Partners -> Developer -> Server URL and type in https://integration-testing.epassi.fi/api/
It’s recommended not to have installed Production Epassi app along with Epassi For Partners on one device.
Use the obtained User ID, Employee ID and Phone Number to sign in to the application.
When you login with phone number the OTP you need can be found from here: https://integration-testing-simulators.epassi.com/ui/otp
2.
Generating a QR code
Search for and click "Restaurant Deatnu"
Use the "Show code" button to see the QR Code
3.
Use the QR Code obtained in the field "qrCode" and the obtained PosName in the field "terminalId" as you request for payment using Create a new payment request
It is advisable to maintain unique Epassi PosName for each devices or use one for an entire store, whichever is convenient
Now you are good to create a payment request and start integrating
1. Cloud Api Integration
Modified at 2026-06-01 02:57:09
Previous
Viva Developers' Guide
Next
Retain24 Developers' Guide
Built with