Refund Flow
Stay organized with collections
Save and categorize content based on your preferences.
Refund Flow
Overview
The refund flow is used to return funds to a user after funds have been captured through the [funds transfer flow][Funds Transfer Flow]. The Payment Integrator implements the asynchronousRefund method which is used to initiate the refund. The final result of the refund is returned to Google with a call to refundResultNotification
A refund can be for an amount equal to or less than the original capture amount. Multiple partial refunds must be supported.
Acquirer reference number
The ARN (Acquirer Reference Number) is usually not known to the Payment Integrator until a few days after the refund is initiated. Once the value is known, the Payment Integrator must call the Google hosted [setAcquirerReferenceNumberForRefundNotification][google.standardpayments.flows.acquirer_reference_number.v1.GoogleAcquirerReferenceNumberService.SetAcquirerReferenceNumberForRefundNotification] to provide the ARN to Google. Associating the ARN with this transaction allows for Google to handle disputes and fraud related to this transaction.
This ARN is separate and different than the ARN that represents a capture. If multiple refunds are issued they will each have a unique ARN.
Subsequent operations
A refund can sometimes fail after the funds have been returned to the issuing bank. For example, this can occur if the customer's account is closed before the funds are deposited. In this case the refund can be reversed, and the funds returned to Google through the reverseRefundNotification
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-16 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-16 UTC."],[[["\u003cp\u003eThe refund flow enables returning captured funds to users, initiated by the Payment Integrator and concluded with a result notification to Google.\u003c/p\u003e\n"],["\u003cp\u003eRefunds can be full or partial, with multiple partial refunds allowed, and require the Payment Integrator to provide the Acquirer Reference Number (ARN) to Google for dispute and fraud management.\u003c/p\u003e\n"],["\u003cp\u003eEach refund has a unique ARN, distinct from the capture ARN, facilitating tracking and management of individual refund transactions.\u003c/p\u003e\n"],["\u003cp\u003eRefunds can fail even after funds are sent to the issuing bank, requiring a reversal process using the \u003ccode\u003ereverseRefundNotification\u003c/code\u003e to return the funds to Google.\u003c/p\u003e\n"]]],["The refund process begins with the Payment Integrator initiating a refund via the `asynchronousRefund` method. The result is then communicated to Google using `refundResultNotification`. Refunds can be partial, with multiple partial refunds allowed. The Payment Integrator must provide the Acquirer Reference Number (ARN) via `setAcquirerReferenceNumberForRefundNotification`. Each refund has a unique ARN. If a refund fails post-processing, the `reverseRefundNotification` method is used to return the funds to Google.\n"],null,["# Refund Flow\n\n\nOverview\n--------\n\nThe **refund flow** is used to return funds to a user after funds have been captured through the \\[**funds transfer flow** \\]\\[Funds Transfer Flow\\]. The Payment Integrator implements the [`asynchronousRefund`](/pay/korea-cards-v1/payment-integrator-korea-cards-api/asynchronousRefund#google.standardpayments.flows.card_fop_async_refund.v1.PaymentIntegratorCardAsyncRefundService.AsynchronousRefund) method which is used to initiate the refund. The final result of the refund is returned to Google with a call to [`refundResultNotification`](/pay/korea-cards-v1/google-korea-cards-api/refundResultNotification#google.standardpayments.flows.card_fop_async_refund.v1.GoogleCardAsyncRefundService.RefundResultNotification).\n\nA refund can be for an amount equal to or less than the original capture amount. Multiple partial refunds must be supported.\n\nAcquirer reference number\n-------------------------\n\nThe ARN (Acquirer Reference Number) is usually not known to the Payment Integrator until a few days after the refund is initiated. Once the value is known, the Payment Integrator must call the Google hosted \\[`setAcquirerReferenceNumberForRefundNotification`\\]\\[google.standardpayments.flows.acquirer_reference_number.v1.GoogleAcquirerReferenceNumberService.SetAcquirerReferenceNumberForRefundNotification\\] to provide the ARN to Google. Associating the ARN with this transaction allows for Google to handle disputes and fraud related to this transaction.\n\nThis ARN is separate and different than the ARN that represents a capture. If multiple refunds are issued they will each have a unique ARN.\n\nSubsequent operations\n---------------------\n\nA refund can sometimes fail after the funds have been returned to the issuing bank. For example, this can occur if the customer's account is closed before the funds are deposited. In this case the refund can be reversed, and the funds returned to Google through the [`reverseRefundNotification`](/pay/korea-cards-v1/google-korea-cards-api/reverseRefundNotification#google.standardpayments.flows.card_fop_async_refund.v1.GoogleCardAsyncRefundService.ReverseRefundNotification)."]]