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

Nets Baxi Cloud Developers' Guide

Nets Baxi Cloud Developer's Guide#

Nets Baxi Cloud (also known as Nets Connect@Cloud) is a cloud-direct card payment channel. The physical terminal connects to Nets over the internet. Confirma Optio is not required. Confirma Centurio communicates with Nets Connect@Cloud on your behalf; transaction completion is delivered via Nets webhooks to Centurio.
Important: Migrating a Terminal from Onsite Nets Baxi to Nets Baxi Cloud
When a terminal is converted from onsite Nets Baxi to Nets Baxi Cloud / Nets Connect@Cloud, you must perform Reconciliation / End of Day (EOD) on the onsite setup before initiating any payment request on the cloud channel.
This is required to close and settle any open onsite batch before the terminal starts processing transactions through Nets Baxi Cloud.
Do not create a payment request with paymentChannelId = 13 until the onsite reconciliation / EOD has been completed successfully.
Complete Reconciliation / EOD on the existing onsite Nets Baxi setup first.
Confirm the onsite batch is closed successfully.
Configure the terminal for Nets Baxi Cloud / Nets Connect@Cloud.
Verify that the ECR indicator is GREEN on the terminal.
Start creating payment requests using paymentChannelId = 13 only after the above steps are completed.
Setup Instructions
Sandbox
Production
1.
Email your request to the support team to obtain sandbox credentials to use Nets Baxi Cloud payments - Obtain a token.
2.
Request Nets Connect@Cloud TEST credentials from support (demo username/password are configured server-side on your tenant).
3.
Obtain your Nets cloud terminal ID from support and configure the LANE3000 terminal for the TEST environment (see Terminal setup below).
4.
After saving terminal settings, verify the ECR indicator is GREEN on the terminal.
Now you are good to create a card payment and start integrating.
Terminal setup (LANE3000 - Cloud)
Configure the terminal from the Merchant menu on the LANE3000.
1
Power on the terminal. Swipe the Merchant Card (or press [Menu], then [8] for Merchant Menu and enter the 4-digit merchant code).
2
Press [6] for Parameter, then [1] Change, then [2] Communication. Set Comm. type to Ethernet or Wi-Fi.
3
Press [3] for Kasse/ECR. Set ECR to Yes, Comm. type to IP Wi-Fi or IP Ethernet, and ECR/TLS to Yes. Use the ECR IP addresses and port from the tables below.
4
Save settings and restart the terminal if required. ECR must be GREEN. If not, check firewall and network restrictions.
TEST environment
Production environment
SettingValue
Comm. typeEthernet or Wi-Fi
Host IP addr.91.102.24.111
Host IP Port9670 (Norway / TEST terminals)
ECRYes
ECR Comm. typeIP Wi-Fi or IP Ethernet
ECR/TLSYes
ECR IP Addr.13.248.144.66, 35.71.176.227
ECR IP port6001
When setup is complete, ECR should be GREEN on the terminal. If ECR is not green, check whether a firewall is blocking the connection and that you are using the correct TEST or PROD IP addresses.
For onsite Nets Baxi (Optio + local TCP), see the Nets Baxi Developers' Guide instead. That integration uses payment channel 4, not 13.
1. Request parameters
2. Payments Flow
3. End of Day (EOD)
4. Troubleshooting
Modified at 2026-06-12 11:30:35
Previous
Verifone Vim Developers' Guide
Next
v1
Built with