Confirma Payment Platform
    • Developer Guide
    • Changelog
    • Basic Flow Guide
    • Viva Developers' Guide
    • Epassi Developers' Guide
    • Retain24 Developers' Guide
    • Resurs Developers' Guide
    • SoftPay Developers' Guide
    • Worldline Developers' Guide
    • Nexi 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)
        • Update transaction status
        • Save a receipt for a transaction
        • Get merchant receipt for a transaction
      • 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
      • ApplicationMessageDto
      • BooleanResponseDto
      • BrandColour
      • CancelIntentDto
      • CancelIntentDtoResponseDto
      • ClientOverrideDto
      • CollectionPromptChannel
      • CollectionPromptChannelDto
      • ClientCredentialTokenRequestDto
      • CreateAccountRequestDto
      • CreateAccountResponseDto
      • CreateAccountResponseDtoResponseDto
      • CurrencyCodes
      • CustomerDisplayType
      • CustomerInfoDto
      • DeviceConfiguration
      • DeviceSpecificationDto
      • ErrorResponseDto
      • GenericRefundPaymentIntentDto
      • POSType
      • PanEntryMode
      • PaymentIntentDto
      • EndDayRequestDto
      • PaymentAdditionalInfoDto
      • PaymentChannelType
      • ReasonCode
      • RefundPaymentIntentDto
      • ReportResponseDto
      • TransactionStatusDto
      • PaymentChannelOptionsDto
      • PaymentChannelConfigurationFieldsDto
      • PaymentChannelMetaData
      • PaymentChannelOptionsForGenericRefundDto
      • PaymentChannelOptionsForRefundDto
      • WorldLineChannelOptions
      • WorldLineRefundOptions
      • PaymentIntentDtoResponseDto
      • PaymentMethod
      • PaymentMethodDto
      • PaymentStatus
      • PrintResponseDto
      • ReportResponseDtoResponseDto
      • ReportType
      • SaveOnsiteTerminalReportDto
      • TokenRequestDto
      • TokenResponseDto
      • TokenResponseDtoResponseDto
      • TransactionStatusDtoResponseDto
      • UpdateTransactionDto
      • VivaChannelOptions
      • TerminalDetailsResponseDto
      • NetsBaxiChannelOptions
      • TerminalStatus
      • TransactionType
      • TerminalDetailsResponseDtoResponseDto
      • CreatePaymentIntentDto
      • ContentDto
      • OnsiteTerminalReportDto
      • CreateGiftCardRequestDto
      • OnsiteTerminalReportDtoResponseDto
      • DiscountDetailsDto
      • DiscountType
      • EpassiChannelOptions
      • GiftCardDetailsDto
      • GiftCardDetailsDtoResponseDto
      • GiftCardPersonalizedMessageLengthDto
      • GiftCardPreviewDto
      • GiftCardStatus
      • GiftCardTemplateDetailsDto
      • GiftCardTemplateDetailsDtoListResponseDto
      • GiftCardTemplateDetailsDtoResponseDto
      • NotificationChannel
      • NotificationOptions
      • TopupGiftCardRequestDto
      • ObjectResponseDto
      • PaymentChannelOptionsDto
      • ReceiptResponseDto
      • ReceiptResponseDtoResponseDto
      • ReceiptType
      • SaveOnsiteTerminalReceiptDto
      • VivaIsvSettingsDto
      • GetCardDetailsRequestDto
      • CustomerType
      • OrderItemDto
      • OrderItemType
      • PaymentFlowType
      • PaymentSubStatus
      • ResursChannelOptions
      • CountryCode
      • LegalLink
      • PaymentMethodBasicInfoResponseDto
      • PaymentMethodBasicInfoResponseDtoListResponseDto
      • PaymentMethodContentResponseDto
      • PaymentMethodContentResponseDtoResponseDto
      • PriceSignagePreview
      • StoreDetailsDto
      • StoreDetailsDtoListResponseDto
      • AddressDto
      • AvailablePaymentChannelDetailDto
      • AvailablePaymentChannelDetailDtoListResponseDto
      • PaymentChannelConfigurationSchemaDto
      • PaymentChannelConfigurationSchemaDtoResponseDto
      • PaymentChannelMetaDataVerifoneVim
      • StringObjectDictionaryResponseDto
      • StringResponseDto
      • VerifoneVimChannelOptions
      • MerchantsInformationDto
      • MerchantsInformationDtoListResponseDto
      • SoftPayChannelOptions
      • Tip
      • SupportedPaymentChannelDto
      • SupportedPaymentChannelDtoListResponseDto
      • Void
      • NexiChannelOptions
      • PaymentChannelMetaDataWorldline
      • PaymentChannelMetaDataWorldline
      • PrintOnTerminalRequestDto
      • PrintOnTerminalRequestDto
      • PrintOnTerminalResponseDto
      • PrintOnTerminalResponseDto
      • PrintOnTerminalResponseDtoResponseDto
      • PrintOnTerminalResponseDtoResponseDto
      • Retain24ChannelOptions
      • Retain24ChannelOptions
      • WorldLineChannelOptions
      • WorldLineRefundOptions
      • EndDayResponseDto
      • PrintOnTerminalRequestDto

    Changelog

    Changes and upgrades to Confirma Payment Platform#

    [1.17.0] - 2026-04-09#

    โ˜๏ธ Centurio (Cloud API)#

    ๐Ÿ’ณ Nexi#

    Update Nexi Terminal Authentication via all request headers to pass username and password.

    ๐Ÿ’ณ Worldline#

    Update Worldline options to use a standard name as worldlineOptions.

    ๐Ÿ’ณ Epassi#

    Update Epassi Demo mode on production for testing to work as intended with new bug fixes

    ๐Ÿ› ๏ธ Improvements#

    Update centurio to persist client request definitions forever under additional info column.

    [1.16.0] - 2026-03-04#

    โ˜๏ธ Centurio (Cloud API)#

    ๐Ÿ’ณ Payment Channels#

    ๐Ÿ’ณ Nexi#

    Introduced Nexi payment channel support.
    Added CRUD management for Nexi payment channel configurations.

    ๐Ÿ’ณ Worldline#

    Implemented Worldline integration with Optio.
    Added improvements and stability fixes for Worldline integration.

    ๐Ÿ’ณ Verifone#

    Fixed race condition in Verifone tasks.
    Improved handling of unreachable Verifone host errors.
    Fixed EOD issue in VIM where LastSentEcrTransactionId becomes null.

    ๐Ÿ’ณ Retain24#

    Fixed null exception when retrieving card expiry date.
    Enabled activation for inactive cards.
    Added account-specific certificate selection for HTTP requests.
    Added multiple certificate username support mapped to account IDs.

    ๐Ÿ’ป Optio (Local API)#

    ๐Ÿ› ๏ธ Improvements#

    Added Optio enhancements for control panel.
    Improved control panel functionality and stability.
    Fixed control panel data loading issue on first startup.
    Added correct UTC time handling and epoch time return for EndDay response.
    Improved status message handling to reduce database updates.

    ๐Ÿ“Š Analytics Dashboard#

    Added currency standardization and selection support.
    Implemented time-aligned comparison percentages for transaction analytics.
    Improved analytics performance and dashboard visualizations.
    Updated Transactions Per Minute chart selector UI.

    โš™๏ธ Platform & Infrastructure#

    Added distributed caching for Centurio services.
    Enabled payment channel demo mode in production.
    Implemented demo mode payment flow adjustments.
    Upgraded Common Library dependencies.
    Improved system probe tuning and monitoring.
    Fixed transaction substatus update issues.

    ๐Ÿ” Security#

    Added user authentication and API protection.

    ๐Ÿงช Stability & Performance#

    Performed load testing and resolved load-related issues in Payment API.
    Conducted production maintenance and system improvements.

    ๐Ÿงพ Support Improvements#

    Added ability for support specialists to view transaction failure reasons in the dashboard.

    [1.15.8] - 2026-01-15#

    ๐Ÿ’ป Optio (Local API)#

    Reduce number of DB updates when payment is in processing - additional status messages kept temporary and return only during polling

    โ˜๏ธ Centurio (Cloud API)#

    Bug fix when cancelling optio transaction

    ๐Ÿ’ณ Retain24#

    Enhanced Retain24 to support account-specific api requests to give flexibity in chosing different certificates as needed for all requests based on AccountId

    [1.15.0] - 2025-11-24#

    โ˜๏ธ Centurio (Cloud API)#

    ๐Ÿ’ณ Retain24#

    New property "Loadable" added while "Reloaded" is deprecated in the response.
    Get a Card

    [1.14.4] - 2025-11-21#

    โ˜๏ธ Centurio (Cloud API)#

    ๐Ÿ’ณ Retain24#

    Enabled card top for inactive cards (If they are not closed or canceled)
    Top Up a Card

    [1.14.2] - 2025-11-20#

    โ˜๏ธ Centurio (Cloud API)#

    ๐Ÿ’ณ Retain24#

    Fixed internal server error bug in
    Validate a Card

    [1.14.1] - 2025-11-19#

    ๐Ÿ’ป Optio Control Panel#

    Fixed caddy certificate validation issue when using SSL

    [1.14.0] - 2025-11-18#

    ๐Ÿ’ป Optio (Local API)#

    Filtered Nets payment processing for Norwegian display text

    [1.13.0] - 2025-11-13#

    ๐Ÿ’ป Optio (Local API)#

    Cancellations are denied for transactions which are in final processing state by payment channels (Verifone Vim, Nets Baxi)

    [1.12.0] - 2025-11-12#

    โ˜๏ธ Centurio (Cloud API)#

    Added Payment Channel Management Endpoint for ConfirmaPay POS
    Fixed Softpay deep-link issues

    ๐Ÿ’ป Optio (Local API)#

    ๐Ÿ› ๏ธ General Improvements#

    Optimized latest version download process to reduce resource usage
    Removed forced application exit on unhandled global exceptions
    Opened required firewall ports on installation
    Enabled .ps1 extension file association rules on installation

    ๐ŸŒ Caddy (HTTPS Reverse Proxy)#

    Disabled automatic redirects for ports 80 and 443 to prevent clashes with other app listeners on POS machines

    โš™๏ธ Crona POS Support#

    Added CORS configuration
    Implemented listening on multiple URLs
    Removed device ID validation to allow multiple ECRs to use a single terminal

    ๐Ÿ’ณ Verifone Vim#

    Added signature requirement in transaction status endpoint for magstripe transactions
    Added descriptive error message for card expired and insufficient funds
    Modified atย 2026-04-09 05:39:51
    Previous
    Developer Guide
    Next
    Basic Flow Guide
    Built with