> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.getsinbad.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getsinbad.com/_mcp/server. # Update a payment account PATCH https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/{id} Content-Type: application/json Update a payment account. **Credential:** Customer session **Before you call** - A customer session for the same partner, integration, customer, wallet and chain. paymentMethodId and the catalog identity value are immutable. Changes to data or reactivation recheck the enabled catalog method and required fields. An unavailable method returns 400 VALIDATION_ERROR; unreadable catalog or stored account data can return 502 UPSTREAM_ERROR. Setting isActive false skips reactivation checks. > Confirm with Sinbad that this endpoint is enabled in your environment. **Errors** | Status | Code | What to do | | --- | --- | --- | | 400 | `VALIDATION_ERROR` | Correct the fields reported in details before retrying. | | 401 | `UNAUTHENTICATED` | Create a new customer session or use a valid server credential. | | 403 | `FORBIDDEN` | Check credential ownership, integration and the supplied Origin. | | 404 | `NOT_FOUND` | Check the resource ID. A resource that belongs to someone else also returns 404. | | 409 | `CONFLICT` | Read the current state again before you prepare or retry. | | 502 | `UPSTREAM_ERROR` | Retry with backoff and quote requestId if it persists. For transaction reports, retry the same hash without sending another transaction. | | 503 | `UPSTREAM_ERROR` | Retry with backoff; preserve the same idempotency key for a repeated mutation. | Reference: https://docs.getsinbad.com/api-reference/payment-accounts/update-saved-payment-method ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Path parameters - `id` (string, required) ### Body (application/json) This endpoint expects an object. - `displayLabel` (string, optional) - `isActive` (boolean, optional) - `data` (map from string to string, optional) ## Response ### 200 Updated - `id` (string, required) - `updated` (boolean, required) ## Errors ### 400 Bad Request Error The request is invalid. - `error` (V1MePaymentMethodsIdPatchResponsesContentApplicationJsonSchemaError, required) ### 401 Unauthorized Error Authentication is required. - `error` (V1MePaymentMethodsIdPatchResponsesContentApplicationJsonSchemaError, required) ### 403 Forbidden Error You do not have permission to perform this action. - `error` (V1MePaymentMethodsIdPatchResponsesContentApplicationJsonSchemaError, required) ### 404 Not Found Error The requested resource was not found. - `error` (V1MePaymentMethodsIdPatchResponsesContentApplicationJsonSchemaError, required) ### 409 Conflict Error The request conflicts with the current state of the resource. - `error` (V1MePaymentMethodsIdPatchResponsesContentApplicationJsonSchemaError, required) ### 502 Bad Gateway Error A required service is unavailable. - `error` (V1MePaymentMethodsIdPatchResponsesContentApplicationJsonSchemaError, required) ### 503 Service Unavailable Error Service temporarily unavailable. - `error` (V1MePaymentMethodsIdPatchResponsesContentApplicationJsonSchemaError, required) ## Types ### V1MePaymentMethodsIdPatchResponsesContentApplicationJsonSchemaError - `code` (string, required) - `numericId` (integer, required) - `message` (string, required) - `requestId` (string, optional) - `details` (map from string to any, optional) ## Examples **Request** ```json { "displayLabel": "Everyday account", "isActive": true } ``` **Response** ```json { "id": "account_demo", "updated": true } ``` **SDK Code** ```python Default import requests url = "https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/account_demo" payload = { "displayLabel": "Everyday account", "isActive": True } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.patch(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Default const url = 'https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/account_demo'; const options = { method: 'PATCH', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"displayLabel":"Everyday account","isActive":true}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Default package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/account_demo" payload := strings.NewReader("{\n \"displayLabel\": \"Everyday account\",\n \"isActive\": true\n}") req, _ := http.NewRequest("PATCH", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Default require 'uri' require 'net/http' url = URI("https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/account_demo") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Patch.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"displayLabel\": \"Everyday account\",\n \"isActive\": true\n}" response = http.request(request) puts response.read_body ``` ```java Default import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.patch("https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/account_demo") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"displayLabel\": \"Everyday account\",\n \"isActive\": true\n}") .asString(); ``` ```php Default request('PATCH', 'https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/account_demo', [ 'body' => '{ "displayLabel": "Everyday account", "isActive": true }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Default using RestSharp; var client = new RestClient("https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/account_demo"); var request = new RestRequest(Method.PATCH); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"displayLabel\": \"Everyday account\",\n \"isActive\": true\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Default import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "displayLabel": "Everyday account", "isActive": true ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://us-central1-sinbad-staging-env.cloudfunctions.net/b2b-v1/v1/me/payment-methods/account_demo")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PATCH" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```