Refund flow
Stay organized with collections
Save and categorize content based on your preferences.
Overview
The refund flow is used to return funds to a user after funds have been
captured through the reserve funds flow or the
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
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-09-03 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-09-03 UTC."],[[["The refund flow returns funds to users after a capture, initiated by the Payment Integrator and finalized through a result notification to Google."],["Refunds can be full or partial, supporting multiple partial refunds for a single capture."],["Payment Integrators must provide the Acquirer Reference Number (ARN) to Google once available, which is crucial for dispute and fraud management."],["Refunds can be reversed under certain circumstances, requiring a separate notification to Google."]]],["The refund process involves the Payment Integrator initiating a refund using the `asynchronousRefund` method. Google is notified of the refund's outcome via `refundResultNotification`. Refunds can be partial or full, and multiple partial refunds are supported. The Payment Integrator must provide the Acquirer Reference Number (ARN) to Google using `setAcquirerReferenceNumberForRefundNotification` once it is available. In case of failure, funds can be returned to Google using `reverseRefundNotification`. Each refund has a unique ARN.\n"]]