{"title":"Release notes - iOS 1.20","category":"default","creationDate":1792753037,"content":"<h2 id=\"new-functionality\">New functionality<\/h2>\n<h3 id=\"example-application\">Example application<\/h3>\n<p>The iOS library package now includes the AdyenPOSExample application. This application implements key features of the Adyen iOS library.\u00a0<\/p>\n<h3 id=\"alipay-transactions\">Alipay transactions<\/h3>\n<p>Alipay payments can be initiated directly from the Cash register application. For this, two flows are possible:<\/p>\n<p><strong>Cash register initiates the Alipay transaction<\/strong><\/p>\n<ol>\n<li>Initiate the Alipay transaction on the Cash register.<\/li>\n<li>The Alipay QR code is shown on the terminal.<\/li>\n<li>The shopper needs to scan the QR code and to initiate the payment from their Alipay application.<\/li>\n<li>The terminal shows the result of the payment (APPROVED, DECLINED, CANCELLED).<\/li>\n<\/ol>\n<p><strong>Cash register scans the shopper barcode<\/strong><\/p>\n<ol>\n<li>Initiate Alipay transaction on the Cash register.<\/li>\n<li>Scan the shopper barcode from the Alipay app.<\/li>\n<li>The shopper may need to enter their pass code.<\/li>\n<li>The terminal shows the result from the payment (APPROVED, DECLINED, CANCELLED).<\/li>\n<\/ol>\n<div class=\"sc-notice info\"><div>\n<p>This functionality also requires you to update the terminal software.<\/p>\n<\/div><\/div>\n<p><strong><br \/>\nMethod<\/strong><\/p>\n<p><code>createSpecialTransactionRequest<\/code><\/p>\n<p><strong>Parameters (required)<\/strong><\/p>\n<table>\n<thead>\n<tr>\n<th>Parameters (required)<\/th>\n<th>Type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>merchantAccount<\/code><\/td>\n<td>String<\/td>\n<td>The merchant account, on which the transaction is processed.<\/td>\n<\/tr>\n<tr>\n<td><code>amount<\/code><\/td>\n<td>Number<\/td>\n<td>The amount of the transaction.<\/td>\n<\/tr>\n<tr>\n<td><code>currency<\/code><\/td>\n<td>String<\/td>\n<td>The currency of the transaction.<\/td>\n<\/tr>\n<tr>\n<td><code>transactionType<\/code><\/td>\n<td>String<\/td>\n<td>For the wallet transaction, populate with <strong>payment.<\/strong><\/td>\n<\/tr>\n<tr>\n<td><code>paymentMethodType<\/code><\/td>\n<td>String<\/td>\n<td>For Alipay transaction, populate with <strong>alipay<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td><code>merchantReference<\/code><\/td>\n<td>String<\/td>\n<td>The unique merchant reference for the transaction.<\/td>\n<\/tr>\n<tr>\n<td><code>handleReceipt<\/code><\/td>\n<td>Boolean<\/td>\n<td>Set this value to true, to handle the receipt.\u00a0\u00a0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Key-value pair options<\/strong><\/p>\n<table>\n<thead>\n<tr>\n<th>Key<\/th>\n<th>Value<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>cardNumber<\/code> (optional)<\/td>\n<td>The scanned number from the Alipay app (to be provided only when the Cash register scans the shopper barcode).<\/td>\n<\/tr>\n<tr>\n<td><code>forceEntryMode<\/code> (required)<\/td>\n<td>\"Keyed\"<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Callbacks<\/strong><\/p>\n<p>Implement the <code>ADYTransactionProcessorDelegate<\/code>, specifically the methods:<\/p>\n<ul>\n<li>(void)transactionComplete:(ADYTransactionData*)transaction<\/li>\n<li>(void)transactionRequiresPrintedReceipt:(ADYPrintReceiptRequest*)printReceiptRequest<\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/point-of-sale\/posmerchantcontent\/library-release-notes\/release-notes-ios-1-20","articleFields":{"id":"34112257","robots":"noindex,nofollow","type":"page","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/posmerchantcontent\/library-release-notes\/release-notes-ios-1-20","title":"Release notes - iOS 1.20","content":"New functionality\nExample application\nThe iOS library package now includes the AdyenPOSExample application. This application implements key features of the Adyen iOS library.\u00a0\nAlipay transactions\nAlipay payments can be initiated directly from the Cash register application. For this, two flows are possible:\nCash register initiates the Alipay transaction\n\nInitiate the Alipay transaction on the Cash register.\nThe Alipay QR code is shown on the terminal.\nThe shopper needs to scan the QR code and to initiate the payment from their Alipay application.\nThe terminal shows the result of the payment (APPROVED, DECLINED, CANCELLED).\n\nCash register scans the shopper barcode\n\nInitiate Alipay transaction on the Cash register.\nScan the shopper barcode from the Alipay app.\nThe shopper may need to enter their pass code.\nThe terminal shows the result from the payment (APPROVED, DECLINED, CANCELLED).\n\n\nThis functionality also requires you to update the terminal software.\n\n\nMethod\ncreateSpecialTransactionRequest\nParameters (required)\n\n\n\nParameters (required)\nType\nDescription\n\n\n\n\nmerchantAccount\nString\nThe merchant account, on which the transaction is processed.\n\n\namount\nNumber\nThe amount of the transaction.\n\n\ncurrency\nString\nThe currency of the transaction.\n\n\ntransactionType\nString\nFor the wallet transaction, populate with payment.\n\n\npaymentMethodType\nString\nFor Alipay transaction, populate with alipay.\n\n\nmerchantReference\nString\nThe unique merchant reference for the transaction.\n\n\nhandleReceipt\nBoolean\nSet this value to true, to handle the receipt.\u00a0\u00a0\n\n\n\nKey-value pair options\n\n\n\nKey\nValue\n\n\n\n\ncardNumber (optional)\nThe scanned number from the Alipay app (to be provided only when the Cash register scans the shopper barcode).\n\n\nforceEntryMode (required)\n\"Keyed\"\n\n\n\nCallbacks\nImplement the ADYTransactionProcessorDelegate, specifically the methods:\n\n(void)transactionComplete:(ADYTransactionData*)transaction\n(void)transactionRequiresPrintedReceipt:(ADYPrintReceiptRequest*)printReceiptRequest\n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"POSMerchantContent","lvl3":"Library release notes","lvl4":"Release notes - iOS 1.20"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/posmerchantcontent","lvl3":"https:\/\/docs.adyen.com\/point-of-sale\/posmerchantcontent\/library-release-notes","lvl4":"\/point-of-sale\/posmerchantcontent\/library-release-notes\/release-notes-ios-1-20"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Release","notes"]}}