{"title":"Partially refund a balance","category":"default","creationDate":1776961627,"content":"

Object<\/h2>\n\n\n\n\n\n
Name<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
MerchantPos<\/code>\u00a0<\/td>\nPOS object representing the cash register application.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Method<\/h2>\n<\/colgroup>

Name<\/p><\/th>

Description<\/p><\/th><\/tr><\/thead>

RefundAtPspRequest<\/code><\/p><\/td>

Call used to initiate a par tial refund where the PSP reference is unknown.<\/p>

This can happen when the original sale transaction was performed offline, in which case there will be no PSPReference, since this is generated only in an online situation.<\/p><\/td><\/tr><\/tbody><\/table>\n

Parameters<\/h2>\n

There are two ways to perform a partial refund:<\/p>\n

1. the pspReference is known:<\/strong>\u00a0In this case, only the pspReference<\/code> needs to be provided, the properties TerminalId<\/code> and TenderReference<\/code> are not required.<\/p>\n

2. the pspReference is NOT known:<\/strong>\u00a0This can happen when the original Sale transaction was performed offline, in which case there will be no pspReference<\/code>, since this is generated only in an online situation.<\/p>\n

In this case, the properties TerminalId and TenderReference need to be provided, the property PspReference is not required.\u00a0<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
Name<\/th>\nType<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
merchantAccount<\/code><\/td>\nString<\/td>\n\"-white_check_mark-\"<\/td>\nThe merchantAccount<\/code> account to receive the money<\/td>\n<\/tr>\n
modificationCurrency<\/code><\/td>\nString<\/td>\n\"-white_check_mark-\"<\/td>\nThe currency of the refunded amount<\/td>\n<\/tr>\n
modificationAmount<\/code><\/td>\nlong<\/td>\n\"-white_check_mark-\"<\/td>\nThe refunded amount. Can be smaller than the initial amount, or in the limit defined per merchant<\/td>\n<\/tr>\n
merchantReference<\/code><\/td>\nString<\/td>\n\"-white_check_mark-\"<\/td>\nThe unique merchant reference<\/td>\n<\/tr>\n
pspReference<\/code><\/td>\nString<\/td>\n\"-x-\"<\/td>\nThe unique PSP reference.<\/td>\n<\/tr>\n
tenderReference<\/code><\/td>\nString<\/td>\n\"-x-\"<\/td>\nThe unique tender reference. In offline situation, the cash register may not have the PSP reference. The tenderReference<\/code> in combination with terminalId<\/code> need to be send in the request.<\/td>\n<\/tr>\n
terminalId<\/code><\/td>\nString<\/td>\n\"-x-\"<\/td>\nThe unique ID of the terminal on which the original transaction is performed.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Callback<\/h2>\n<\/colgroup>
Name<\/th>Description<\/th><\/tr><\/thead>

refundAtPspCallback<\/code><\/p><\/td>

Refund Callback returns the result of a partial refund, as well as any errors. Returns an adyenResult RefundAtPspResult<\/code> with the transaction result details<\/p><\/td><\/tr><\/tbody><\/table>","url":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/cancel-or-refund-a-transaction-jni\/partially-refund-a-balance-jni","articleFields":{"id":"34116783","type":"page","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/cancel-or-refund-a-transaction-jni\/partially-refund-a-balance-jni","title":"Partially refund a balance","content":"Object\n\n\n\nName\nDescription\n\n\n\n\nMerchantPos\u00a0\nPOS object representing the cash register application.\n\n\n\nMethod\nNameDescriptionRefundAtPspRequestCall used to initiate a par tial refund where the PSP reference is unknown.This can happen when the original sale transaction was performed offline, in which case there will be no PSPReference, since this is generated only in an online situation.\nParameters\nThere are two ways to perform a partial refund:\n1. the pspReference is known:\u00a0In this case, only the pspReference needs to be provided, the properties TerminalId and TenderReference are not required.\n2. the pspReference is NOT known:\u00a0This can happen when the original Sale transaction was performed offline, in which case there will be no pspReference, since this is generated only in an online situation.\nIn this case, the properties TerminalId and TenderReference need to be provided, the property PspReference is not required.\u00a0\n\n\n\nName\nType\nRequired\nDescription\n\n\n\n\nmerchantAccount\nString\n\nThe merchantAccount account to receive the money\n\n\nmodificationCurrency\nString\n\nThe currency of the refunded amount\n\n\nmodificationAmount\nlong\n\nThe refunded amount. Can be smaller than the initial amount, or in the limit defined per merchant\n\n\nmerchantReference\nString\n\nThe unique merchant reference\n\n\npspReference\nString\n\nThe unique PSP reference.\n\n\ntenderReference\nString\n\nThe unique tender reference. In offline situation, the cash register may not have the PSP reference. The tenderReference in combination with terminalId need to be send in the request.\n\n\nterminalId\nString\n\nThe unique ID of the terminal on which the original transaction is performed.\n\n\n\nCallback\nNameDescriptionrefundAtPspCallbackRefund Callback returns the result of a partial refund, as well as any errors. Returns an adyenResult RefundAtPspResult with the transaction result details","type":"page","locale":"en","boost":13,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"Deprecation of classic libraries","lvl3":"Library integrations","lvl4":"Java Native Interface integration","lvl5":"Key steps","lvl6":"Cancel or refund a transaction","lvl7":"Partially refund a balance"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation","lvl3":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations","lvl4":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration","lvl5":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni","lvl6":"https:\/\/docs.adyen.com\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/cancel-or-refund-a-transaction-jni","lvl7":"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/cancel-or-refund-a-transaction-jni\/partially-refund-a-balance-jni"},"levels":8,"category":"In-person payments","category_color":"green","tags":["Partially","refund","balance"]}}