Method: disassociateAccount
Stay organized with collections
Save and categorize content based on your preferences.
Deletes the association between the customer's account with the payment processor and the Google instrument.
This disassociation should be processed idempotently, so if the same requestId is used as a previously processed request, the previous result should be idempotently returned. Otherwise if Google sends a googlePaymentToken
that has already been disassociated, an error should be returned.
If the endpoint encounters an error while processing the request, the response body from this endpoint should be of type ErrorResponse
.
An example request looks like:
{
"requestHeader": {
"protocolVersion": {
"major": 2
},
"requestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
"requestTimestamp": {
"epochMillis": "0"
},
"paymentIntegratorAccountId": "InvisiCashUSD"
},
"googlePaymentToken": {
"issuerId": {
"value": "InvisiCashUSA"
},
"token": "ZXhhbXBsZSB1bmlxdWUgcGF5bWVudCB0b2tlbiB2YWx1ZQ"
}
}
An example response looks like:
{
"responseHeader": {
"responseTimestamp": {
"epochMillis": "1481900013178"
}
},
"result": {"success": {}}
}
HTTP request
POST https://www.integratorhost.example.com/integrator-base-path/v2/disassociateAccount
Request body
The request body contains data with the following structure:
JSON representation |
{
"requestHeader": {
object (RequestHeader )
},
// Union field token can be only one of the following:
"googlePaymentToken": {
object (GooglePaymentToken )
},
"vendorPaymentToken": {
object (VendorPaymentToken )
}
// End of list of possible types for union field token .
} |
Fields |
requestHeader |
object (RequestHeader )
REQUIRED: Common header for all requests.
|
Union field token . REQUIRED: This is the token that should be disassociated. token can be only one of the following: |
googlePaymentToken |
object (GooglePaymentToken )
The Google Payment Token that should be disassociated.
|
vendorPaymentToken |
object (VendorPaymentToken )
The vendor payment token that should be disassociated.
|
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 (DisassociateAccountResponse )
|
HTTP 4XX / 5XX Status |
object (ErrorResponse )
|
DisassociateAccountResponse
Response object for the disassociate account method.
DisassociateAccountResult
Result for disassociate account.
JSON representation |
{
// Union field result can be only one of the following:
"success": {
object (Empty )
}
// End of list of possible types for union field result .
} |
Fields |
Union field result . REQUIRED: The result of the disassociate account call. result can be only one of the following: |
success |
object (Empty )
The account disassociation was successful.
|
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-29 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 2025-07-29 UTC."],[[["\u003cp\u003eThis endpoint deletes the association between a customer's account and their Google payment instrument.\u003c/p\u003e\n"],["\u003cp\u003eThe request must contain a \u003ccode\u003erequestHeader\u003c/code\u003e and either a \u003ccode\u003egooglePaymentToken\u003c/code\u003e or a \u003ccode\u003evendorPaymentToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response will contain a \u003ccode\u003eresponseHeader\u003c/code\u003e and a \u003ccode\u003eresult\u003c/code\u003e indicating success or failure.\u003c/p\u003e\n"],["\u003cp\u003eIf the disassociation is successful, the \u003ccode\u003eresult\u003c/code\u003e field will contain a \u003ccode\u003esuccess\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eErrors during processing will result in an \u003ccode\u003eErrorResponse\u003c/code\u003e with a 4XX or 5XX HTTP status code.\u003c/p\u003e\n"]]],["This document details the process for disassociating a customer's account from a payment processor. A `POST` HTTP request is sent to the `/disassociateAccount` endpoint, with a request body containing a `requestHeader` and either a `googlePaymentToken` or `vendorPaymentToken`. The system processes the request idempotently, returning a `DisassociateAccountResponse` with a successful result if successful. Errors are handled and returned as an `ErrorResponse`. The response provides the result of the disassociation.\n"],null,["# Method: disassociateAccount\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [DisassociateAccountResponse](#DisassociateAccountResponse)\n - [JSON representation](#DisassociateAccountResponse.SCHEMA_REPRESENTATION)\n- [DisassociateAccountResult](#DisassociateAccountResult)\n - [JSON representation](#DisassociateAccountResult.SCHEMA_REPRESENTATION)\n\nDeletes the association between the customer's account with the payment processor and the Google instrument.\n\nThis disassociation should be processed idempotently, so if the same requestId is used as a previously processed request, the previous result should be idempotently returned. Otherwise if Google sends a `googlePaymentToken` that has already been disassociated, an error should be returned.\n\nIf the endpoint encounters an error while processing the request, the response body from this endpoint should be of type [`ErrorResponse`](/pay/banking-fop-v2/payment-integrator-banking-fop-api/ErrorResponse).\n\nAn example request looks like: \n\n\n {\n \"requestHeader\": {\n \"protocolVersion\": {\n \"major\": 2\n },\n \"requestId\": \"bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ\",\n \"requestTimestamp\": {\n \"epochMillis\": \"0\"\n },\n \"paymentIntegratorAccountId\": \"InvisiCashUSD\"\n },\n \"googlePaymentToken\": {\n \"issuerId\": {\n \"value\": \"InvisiCashUSA\"\n },\n \"token\": \"ZXhhbXBsZSB1bmlxdWUgcGF5bWVudCB0b2tlbiB2YWx1ZQ\"\n }\n }\n\nAn example response looks like: \n\n\n {\n \"responseHeader\": {\n \"responseTimestamp\": {\n \"epochMillis\": \"1481900013178\"\n }\n },\n \"result\": {\"success\": {}}\n }\n\n### HTTP request\n\n`POST https://www.integratorhost.example.com/integrator-base-path/v2/disassociateAccount`\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requestHeader\": { object (/pay/banking-fop-v2/payment-integrator-banking-fop-api/RequestHeader) }, // Union field `token` can be only one of the following: \"googlePaymentToken\": { object (/pay/banking-fop-v2/payment-integrator-banking-fop-api/GooglePaymentToken) }, \"vendorPaymentToken\": { object (/pay/banking-fop-v2/payment-integrator-banking-fop-api/VendorPaymentToken) } // End of list of possible types for union field `token`. } ``` |\n\n| Fields ||\n|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requestHeader` | `object (`[RequestHeader](/pay/banking-fop-v2/payment-integrator-banking-fop-api/RequestHeader)`)` **REQUIRED**: Common header for all requests. |\n| Union field `token`. **REQUIRED** : This is the token that should be disassociated. `token` can be only one of the following: ||\n| `googlePaymentToken` | `object (`[GooglePaymentToken](/pay/banking-fop-v2/payment-integrator-banking-fop-api/GooglePaymentToken)`)` The Google Payment Token that should be disassociated. |\n| `vendorPaymentToken` | `object (`[VendorPaymentToken](/pay/banking-fop-v2/payment-integrator-banking-fop-api/VendorPaymentToken)`)` The vendor payment token that should be disassociated. |\n\n### Response body\n\nThis 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](/pay/banking-fop-v2/guides/connectivity/protocol-standards#http_status_codes).\n\n| Possible response messages ||\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| HTTP 200 Status | `object (`[DisassociateAccountResponse](/pay/banking-fop-v2/payment-integrator-banking-fop-api/disassociateAccount#DisassociateAccountResponse)`)` |\n| HTTP 4XX / 5XX Status | `object (`[ErrorResponse](/pay/banking-fop-v2/payment-integrator-banking-fop-api/ErrorResponse)`)` |\n\nDisassociateAccountResponse\n---------------------------\n\nResponse object for the disassociate account method.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"responseHeader\": { object (/pay/banking-fop-v2/payment-integrator-banking-fop-api/ResponseHeader) }, \"result\": { object (/pay/banking-fop-v2/payment-integrator-banking-fop-api/disassociateAccount#DisassociateAccountResult) } } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `responseHeader` | `object (`[ResponseHeader](/pay/banking-fop-v2/payment-integrator-banking-fop-api/ResponseHeader)`)` **REQUIRED**: Common header for all responses. |\n| `result` | `object (`[DisassociateAccountResult](/pay/banking-fop-v2/payment-integrator-banking-fop-api/disassociateAccount#DisassociateAccountResult)`)` **REQUIRED**: Result of this disassociation. |\n\nDisassociateAccountResult\n-------------------------\n\nResult for disassociate account.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { // Union field `result` can be only one of the following: \"success\": { object (/pay/banking-fop-v2/payment-integrator-banking-fop-api/Empty) } // End of list of possible types for union field `result`. } ``` |\n\n| Fields ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------|\n| Union field `result`. **REQUIRED** : The result of the disassociate account call. `result` can be only one of the following: ||\n| `success` | `object (`[Empty](/pay/banking-fop-v2/payment-integrator-banking-fop-api/Empty)`)` The account disassociation was successful. |"]]