{"title":"Oracle Opera","category":"default","creationDate":1776961628,"content":"<div class=\"additional-info-block output-inline\">\n<div class=\"additional-info-block__body\"><p><img style=\"width: 50px;\" alt=\"\" src=\"\/user\/pages\/docs\/05.plugins\/11.oracle-opera\/oracle-hospitality.svg?decoding=auto&amp;fetchpriority=auto\" \/>&nbsp; <strong>Read more<\/strong><\/p><p>Learn more about <a href=\"https:\/\/www.adyen.com\/partners\/oracle-hospitality\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Oracle Hospitality<\/a> in our Partner Directory.<\/p><\/div><\/div>\n\n<p>Oracle Opera is a <a href=\"https:\/\/www.oracle.com\/hospitality\/\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">property management platform<\/a>, providing enterprise <a href=\"\/pt\/get-started-with-adyen\/adyen-glossary\/#point-of-sale-pos\">point-of-sale (POS)<\/a> and back-office functionality to support a wide range of hospitality and property management operations.<\/p>\n<p>Adyen payment terminals use Oracle Payment Interface (OPI) 6.2 to integrate to Oracle Opera. With Opera, you can tokenize your guest's payment information and store the tokens in your Oracle database.<\/p>\n<p>You can also create OPI tokens for ecommerce transactions. See <a href=\"#opi-token-ecommerce\">get an OPI token for online payments<\/a> for more information.<\/p>\n<h2>Supported versions<\/h2>\n<p>You can use our plugin to integrate with all Opera workstations that are compatible with OPI. With our plugin, we can support on-premise, hosted, and cloud setups.<\/p>\n<h2>Get started<\/h2>\n<p>Before you begin to integrate, make sure you have followed the <a href=\"\/pt\/get-started-with-adyen\">Get started with Adyen guide<\/a> to:<\/p>\n<ul>\n<li>Get an overview of the steps needed to accept live payments.<\/li>\n<li>Create your test account.<\/li>\n<\/ul>\n<p>After you have created your test account, contact the <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to enable OPI in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/p>\n<h2>How it works<\/h2>\n<p>OPI sends all transaction messages directly from your Opera workstation to Adyen's payment terminal.<\/p>\n<p><a rel=\"lightbox\" href=\"\/user\/pages\/docs\/05.plugins\/11.oracle-opera\/Screenshot 2020-01-30 at 11.28.37.png\" src=\"\">\n  <img alt=\"Diagram\" src=\"\/images\/e\/5\/4\/7\/8\/e54788ecb135ef7ecc6af8b01139821a3e2cb179-screenshot-2020-01-30-at-112837.png\" \/>\n<\/a><\/p>\n<h2>Features<\/h2>\n<p>With Adyen's plugin, you can use the following transaction types provided by Oracle:<\/p>\n<ul>\n<li><strong>Pre-Authorization<\/strong>: performed when a guest checks-in. An amount is held temporarily for authorization, but it is not a transaction charge.<\/li>\n<li><strong>Top-up Authorization<\/strong>: at the end of each day, the pre-authorized amount can be increased with a top-up transaction.<\/li>\n<li><strong>Authorization Release<\/strong>: returns the pre-authorized amount to the guest's account.<\/li>\n<li><strong>Sales Completion<\/strong>: performed when a guest checks out. The transaction is completed by charging the final amount.<\/li>\n<li><strong>Sale\/Purchase<\/strong>: charges the guest's card directly without a pre-authorization.<\/li>\n<li><strong>Refund<\/strong>: returns the authorized amount to the guest's account.<\/li>\n<li><strong>Void<\/strong>: reverses the original Sale\/Purchase or Sales Completion transaction. This transaction type is only supported within the same settlement day.<\/li>\n<li><strong>Reversal<\/strong>: if the connection between the Oracle Hospitality POS system and the OPI terminates before the financial transaction is complete, or the transaction times out, then the OPI reverses the transaction made.<\/li>\n<li><strong>Get Token<\/strong>: requests the cardholder data entered into the terminal. The data is sent to Adyen and exchanged for a token. The token can then be used for further top-ups or final settlement.<\/li>\n<li><strong>Get Token Bulk<\/strong>: exchanges a single token or swaps the entire OPERA database of card data for a token. This transaction type is used for:\n<ul>\n<li>Migration of payment data when you move to Adyen's services.<\/li>\n<li>Reservations from third parties.<\/li>\n<li>Manual card entry in Opera for phone reservations.<\/li>\n<\/ul><\/li>\n<\/ul>\n<h2 id=\"opi-token-ecommerce\">Get an OPI token for online payments<\/h2>\n<p>Aside from POS payments, you can also create OPI tokens for online payments that your guests make. This way, you can fully benefit from an omnichannel strategy and tokenize guest payment information from multiple channels.<\/p>\n<p>To be able to retrieve OPI tokens for ecommerce payments, contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>. They can activate the correct settings for your merchant account.<\/p>\n<p>Once the settings in your account are active, you can request an OPI token in your  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> request. The response will return an OPI token that you can use in your Oracle Opera integration. Store the OPI token in your Oracle database.<\/p>\n<p>To return the <code>recurringDetailReference<\/code> in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> response, follow the steps in <a href=\"\/pt\/online-payments\/tokenization\/create-tokens\">Create tokens<\/a>.<\/p>\n<p>To get an OPI token, in your  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> request, specify the following:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: left;\">Setting<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/CheckoutService\/latest\/post\/payments__reqParam_additionalData-AdditionalDataOpi-opi-includeTransToken\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">additionalData.opi.includeTransToken<\/a><\/td>\n<td style=\"text-align: left;\"><strong>true<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-shopperInteraction\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">shopperInteraction<\/a><\/td>\n<td style=\"text-align: left;\"><strong>Ecommerce<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-shopperReference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">shopperReference<\/a><\/td>\n<td style=\"text-align: left;\"><strong>not_provided<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/CheckoutService\/latest\/post\/payments__reqParam_recurringProcessingModel\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">recurringProcessingModel<\/a><\/td>\n<td style=\"text-align: left;\"><strong>CardOnFile<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-storePaymentMethod\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">storePaymentMethod<\/a><\/td>\n<td style=\"text-align: left;\"><strong>true<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>For example:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'\/payments request'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n\\\"amount\\\":{\\n      \\\"value\\\":\\\"1000\\\",\\n      \\\"currency\\\":\\\"EUR\\\"\\n      },\\n\\\"reference\\\":\\\"YOUR_ORDER_NUMBER\\\",\\n\\\"merchantAccount\\\":\\\"YOUR_MERCHANT_ACOUNT\\\",\\n\\\"paymentMethod\\\": {\\n      \\\"type\\\": \\\"scheme\\\",\\n      \\\"encryptedCardNumber\\\": \\\"test_4111111111111111\\\",\\n      \\\"encryptedExpiryMonth\\\": \\\"test_03\\\",\\n      \\\"encryptedExpiryYear\\\": \\\"test_2030\\\",\\n      \\\"encryptedSecurityCode\\\": \\\"test_737\\\"\\n      },\\n\\\"shopperInteraction\\\":\\\"Ecommerce\\\",\\n\\\"shopperReference\\\":\\\"not_provided\\\",\\n\\\"recurringProcessingModel\\\": \\\"CardOnFile\\\",\\n\\\"storePaymentMethod\\\": true,\\n\\\"additionalData\\\":{\\n      \\\"opi.includeTransToken\\\": true\\n      }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'\/payments response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"additionalData\\\":{\\n      \\\"opi.transToken\\\":\\\"GENERATED_OPI_TOKEN\\\",\\n      \\\"recurring.recurringDetailReference\\\":\\\"8415698462516992\\\",\\n      \\\"recurring.shopperReference\\\":\\\"GENERATED_UNIQUE_SHOPPER_ID\\\",\\n      ...\\n  },\\n  \\\"pspReference\\\":\\\"8515815919501547\\\",\\n  \\\"resultCode\\\":\\\"Authorised\\\",\\n  \\\"amount\\\": {\\n      \\\"currency\\\": \\\"EUR\\\",\\n      \\\"value\\\": 1000\\n  },\\n  \\\"merchantReference\\\": \\\"YOUR_ORDER_NUMBER\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>","url":"https:\/\/docs.adyen.com\/pt\/plugins\/oracle-opera","articleFields":{"description":"Use Oracle Opera to process payments for your hospitality business.","last_edit_on":"14-01-2021 16:14"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/oracle-opera","title":"Oracle Opera","content":"\n&nbsp; Read moreLearn more about Oracle Hospitality in our Partner Directory.\n\nOracle Opera is a property management platform, providing enterprise point-of-sale (POS) and back-office functionality to support a wide range of hospitality and property management operations.\nAdyen payment terminals use Oracle Payment Interface (OPI) 6.2 to integrate to Oracle Opera. With Opera, you can tokenize your guest's payment information and store the tokens in your Oracle database.\nYou can also create OPI tokens for ecommerce transactions. See get an OPI token for online payments for more information.\nSupported versions\nYou can use our plugin to integrate with all Opera workstations that are compatible with OPI. With our plugin, we can support on-premise, hosted, and cloud setups.\nGet started\nBefore you begin to integrate, make sure you have followed the Get started with Adyen guide to:\n\nGet an overview of the steps needed to accept live payments.\nCreate your test account.\n\nAfter you have created your test account, contact the Support Team to enable OPI in your Customer Area.\nHow it works\nOPI sends all transaction messages directly from your Opera workstation to Adyen's payment terminal.\n\n  \n\nFeatures\nWith Adyen's plugin, you can use the following transaction types provided by Oracle:\n\nPre-Authorization: performed when a guest checks-in. An amount is held temporarily for authorization, but it is not a transaction charge.\nTop-up Authorization: at the end of each day, the pre-authorized amount can be increased with a top-up transaction.\nAuthorization Release: returns the pre-authorized amount to the guest's account.\nSales Completion: performed when a guest checks out. The transaction is completed by charging the final amount.\nSale\/Purchase: charges the guest's card directly without a pre-authorization.\nRefund: returns the authorized amount to the guest's account.\nVoid: reverses the original Sale\/Purchase or Sales Completion transaction. This transaction type is only supported within the same settlement day.\nReversal: if the connection between the Oracle Hospitality POS system and the OPI terminates before the financial transaction is complete, or the transaction times out, then the OPI reverses the transaction made.\nGet Token: requests the cardholder data entered into the terminal. The data is sent to Adyen and exchanged for a token. The token can then be used for further top-ups or final settlement.\nGet Token Bulk: exchanges a single token or swaps the entire OPERA database of card data for a token. This transaction type is used for:\n\nMigration of payment data when you move to Adyen's services.\nReservations from third parties.\nManual card entry in Opera for phone reservations.\n\n\nGet an OPI token for online payments\nAside from POS payments, you can also create OPI tokens for online payments that your guests make. This way, you can fully benefit from an omnichannel strategy and tokenize guest payment information from multiple channels.\nTo be able to retrieve OPI tokens for ecommerce payments, contact our Support Team. They can activate the correct settings for your merchant account.\nOnce the settings in your account are active, you can request an OPI token in your  \/payments request. The response will return an OPI token that you can use in your Oracle Opera integration. Store the OPI token in your Oracle database.\nTo return the recurringDetailReference in the  \/payments response, follow the steps in Create tokens.\nTo get an OPI token, in your  \/payments request, specify the following:\n\n\n\nParameter\nSetting\n\n\n\n\nadditionalData.opi.includeTransToken\ntrue\n\n\n shopperInteraction\nEcommerce\n\n\n shopperReference\nnot_provided\n\n\nrecurringProcessingModel\nCardOnFile\n\n\n storePaymentMethod\ntrue\n\n\n\nFor example:\n\n    \n\n\n    \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Oracle Opera"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/plugins","lvl2":"\/pt\/plugins\/oracle-opera"},"levels":3,"category":"Plugins","category_color":"green","tags":["Oracle","Opera"]},"articleFiles":{"Screenshot 2020-01-30 at 11.28.37.png":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.plugins\/11.oracle-opera\/Screenshot 2020-01-30 at 11.28.37.png\" \/>","oracle-hospitality.svg":"<img style=\"width: 50px;\" alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.plugins\/11.oracle-opera\/oracle-hospitality.svg?decoding=auto&amp;fetchpriority=auto\" \/>"}}