Method: getTransferFundsTransactionStatus

  • This method retrieves the status of a previously initiated transferFunds transaction using the transferFundsRequestId.

  • The request body requires a requestHeader and the original transferFundsRequestId.

  • The response provides a responseHeader, a result indicating the lookup status, and details about the transaction status (transferFundsResult, transactionDoesNotExist, or resultNotKnownYet).

  • Potential HTTP response statuses include 200 for success and 4XX/5XX for errors, with specific response bodies for each scenario.

  • The GetTransactionStatusResult indicates the success of the transaction lookup operation, separate from the actual transaction status.

This method fetches the status of a e-wallets-v1.transferFunds transaction.

An example request looks like:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "liUrreQY233839dfFFb24gaQM",
    "requestTimestamp": "1502220434778"
  },
  "transferFundsRequestId":"bnAxdWTydDX==",
  "paymentIntegratorAccountId": "InvisiCash"
}

An example response looks like:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "result": { "success": {} },
  "transferFundsResult": { "success": {} }
}

HTTP request

POST https://www.integratorhost.example.com/integrator-base-path/e-wallets-v1/getTransferFundsTransactionStatus

Request body

The request body contains data with the following structure:

JSON representation 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "transferFundsRequestId": string,
  "paymentIntegratorAccountId": string
}
Fields
requestHeader

object (RequestHeader)

REQUIRED: Common header for all requests.
transferFundsRequestId

string

REQUIRED: The requestId of the original e-wallets-v1.transferFunds transaction.
paymentIntegratorAccountId

string

OPTIONAL: This is the payment integrator account identifier that identifies contractual constraints around this transaction.

Response body

This method supports multiple return types. For additional information about what 4XX or 5XX HTTP status code to return with an ErrorResponse, consult the ErrorResponse object and HTTP status codes documentation.

Possible response messages
HTTP 200 Status

object (GetTransferFundsTransactionStatusResponse)
HTTP 4XX / 5XX Status

object (ErrorResponse)
End of mutually exclusive fields.

GetTransferFundsTransactionStatusResponse

Response object for e-wallets-v1.getTransferFundsTransactionStatus.

JSON representation 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": {
    object (GetTransactionStatusResult)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "transferFundsResult": {
    object (TransferFundsResult)
  },
  "transactionDoesNotExist": {
    object (Empty)
  },
  "resultNotKnownYet": {
    object (TransactionResultNotKnownYet)
  }
  // End of mutually exclusive fields.
}
Fields
responseHeader

object (ResponseHeader)

REQUIRED: Common header for all responses.
result

object (GetTransactionStatusResult)

REQUIRED: Result of this GetTransactionStatus call.
REQUIRED: The actual status of the transaction which is looked up. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response:
transferFundsResult

object (TransferFundsResult)

Result of the FundsTransfer operation.
transactionDoesNotExist

object (Empty)

The transaction was not found in the system. This can happen if the call from Google to partner got dropped and the partner never received the original transaction. Now when Google tries to lookup the status, partner should return this error code to indicate that the transaction doesn't exist in the system. Google should mark the transaction as failed in that case. It is different than a Http 404 where the URL of GetTransactionStatus was not found in which case Google can't update the status of the transaction.
resultNotKnownYet

object (TransactionResultNotKnownYet)

Captures the scenario where the integrator itself doesn't have a definite status, maybe because they have not received it from the underlying payment network.
End of mutually exclusive fields.

GetTransactionStatusResult

Result codes for GetTransactionStatus. This indicates the status of the lookup operation and not the actual transaction. If the transaction look up failed due to some internal error, the partner should return a non 200 Http error code.

JSON representation 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "success": {
    object (Empty)
  }
  // End of mutually exclusive fields.
}
Fields
REQUIRED: The result of the GetTransactionStatus call. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response:
success

object (Empty)

Successful lookup.
End of mutually exclusive fields.