TransferFundsResult

  • This documentation details the possible results for a transfer request made using the Google Pay E-Wallets API.

  • Results can indicate success, various failure reasons (limits, insufficient funds, account issues, risk), or require token refresh/further action.

  • Each result type has a corresponding JSON representation, providing structured data about the outcome.

  • Some result types, like TokenRefreshRequired, PayeeProxyNotRegistered, DeclinedByBusinessRule, and RiskDeclined, allow for an optional rawResult field for more detailed information.

  • The rawResult field can be used by integrators to communicate specific decline codes or other data to Google for risk analysis and analytics.

Results for transfer

JSON representation 
{

  // Union field result can be only one of the following:
  "success": {
    object (Empty)
  },
  "chargeExceedsTransactionLimit": {
    object (ChargeExceedsTransactionLimit)
  },
  "chargeExceedsDailyLimit": {
    object (ChargeExceedsDailyLimit)
  },
  "chargeExceedsMonthlyLimit": {
    object (ChargeExceedsMonthlyLimit)
  },
  "chargeUnderLimit": {
    object (ChargeUnderLimit)
  },
  "insufficientFunds": {
    object (InsufficientFunds)
  },
  "accountDoesNotSupportCurrency": {
    object (AccountDoesNotSupportCurrency)
  },
  "accountClosed": {
    object (AccountClosed)
  },
  "accountClosedAccountTakenOver": {
    object (AccountClosedAccountTakenOver)
  },
  "accountOnHold": {
    object (AccountOnHold)
  },
  "accountClosedFraud": {
    object (AccountClosedFraud)
  },
  "googlePaymentTokenInvalidatedByUser": {
    object (GooglePaymentTokenInvalidatedByUser)
  },
  "tokenRefreshRequired": {
    object (TokenRefreshRequired)
  },
  "payeeProxyNotRegistered": {
    object (PayeeProxyNotRegistered)
  },
  "declinedByBusinessRule": {
    object (DeclinedByBusinessRule)
  },
  "riskDeclined": {
    object (RiskDeclined)
  }
  // End of list of possible types for union field result.
}
Fields
Union field result. REQUIRED: The result of the transfer. result can be only one of the following:
success

object (Empty)

Successful transfer.
chargeExceedsTransactionLimit

object (ChargeExceedsTransactionLimit)

This transfer request's amount exceeds per-transaction limit. If this code is used populate the transactionLimit field for user messaging purposes.
chargeExceedsDailyLimit

object (ChargeExceedsDailyLimit)

This account cannot be used for transfers right now as it has exceeded its daily limits.
chargeExceedsMonthlyLimit

object (ChargeExceedsMonthlyLimit)

This account cannot be used for transfers right now as it has exceeded its monthly limits.
chargeUnderLimit

object (ChargeUnderLimit)

This transfer request's amount does not meet the minimum transaction amount.
insufficientFunds

object (InsufficientFunds)

This account does not have sufficient funds to guarantee this transfer.
accountDoesNotSupportCurrency

object (AccountDoesNotSupportCurrency)

This account does not support the requested currency.
accountClosed

object (AccountClosed)

The user's account held with the integrator has been closed.

Returning this value will cause the user's instrument to be closed with Google. The user will be forced to add a new instrument by going through the association flow again.
accountClosedAccountTakenOver

object (AccountClosedAccountTakenOver)

The user's account with the integrator has been closed, suspected account take over.

Returning this value will cause the user's instrument to be closed with Google. The user will be forced to add a new instrument by going through the association flow again.
accountOnHold

object (AccountOnHold)

The account is on hold.
accountClosedFraud

object (AccountClosedFraud)

The user's account held with the integrator has been closed because of fraud.

Returning this value will cause the user's instrument to be closed with Google. The user will be forced to add a new instrument by going through the association flow again.
googlePaymentTokenInvalidatedByUser

object (GooglePaymentTokenInvalidatedByUser)

The account is active, but the GPT has been invalidated by the user on the integrator's side.

Returning this value will cause the user's instrument to be closed with Google. The user will be forced to add a new instrument by going through the association flow again.
tokenRefreshRequired

object (TokenRefreshRequired)

Returning this requires the user to go through a refresh flow.
payeeProxyNotRegistered

object (PayeeProxyNotRegistered)

The payee proxy is not registered.
declinedByBusinessRule

object (DeclinedByBusinessRule)

The transaction was declined due to business rule violations on the integrator's side.

This is a permanent failure for this payment, but does not cause the user's instrument to be closed at Google.
riskDeclined

object (RiskDeclined)

The transaction was declined due to a risk check on the integrator's side.

This is a permanent failure for this payment, but does not cause the user's instrument to be closed at Google.

TokenRefreshRequired

Returning this requires the user to go through a refresh flow.

JSON representation 
{
  "rawResult": {
    object (RawResult)
  }
}
Fields
rawResult

object (RawResult)

OPTIONAL: Raw result of this event. Used to help inform Google's risk engine and analytics. In decline code–mapping situations, data is sometimes lost. The integrator can choose to give Google a raw code. For example, a credit card gateway (the integrator) may use this field to communicate to Google the exact decline code that was received from the VISA network. In that case, the scope would be "visa" and the rawCode would be whatever the VISA network returned.

RiskDeclined

The transaction was declined due to a risk check on the integrator's side.

JSON representation 
{
  "rawResult": {
    object (RawResult)
  }
}
Fields
rawResult

object (RawResult)

OPTIONAL: Raw result of this event. Used to help inform Google's risk engine and analytics. In decline code–mapping situations, data is sometimes lost. The integrator can choose to give Google a raw code. For example, a credit card gateway (the integrator) may use this field to communicate to Google the exact decline code that was received from the VISA network. In that case, the scope would be "visa" and the rawCode would be whatever the VISA network returned.