Skip to content
Console
Menu

Alerts and status pages

App store purchases

Credits

Knowledge

KV

Notifications

Organizations

Storage

Workflows

API reference

Getting Started

Authentication

KV Store

Update a bank transfer account

UpdateBankTransferAccount through the project-scoped bank transfer API.

UpdateBankTransferAccount through the project-scoped bank transfer API.

  • Path PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/bank_transfer_accounts/bank-transfer-account
  • Scope billing:bank_accounts:write
  • Effect write — a successful call changes state.
  • Collection bank_transfer_accounts
  • Query update_mask, allow_missing

#Request

FieldTypeWhat it is
bank_transfer_accountBankTransferAccountAccount configuration. Required.
update_maskfield_maskFields to change; empty replaces all writable fields.
allow_missingboolCreate the singleton if absent.

#BankTransferAccount

FieldTypeWhat it is
namestringResource name.
account_holderstringVerified beneficiary name. Required.
bank_namestringReceiving bank name. Required.
bank_codestringReceiving bank routing or clearing code. Required.
account_numberstringReceiving account number, including branch digits. Required.
fps_idstringVerified FPS identifier displayed to the payer.
fps_qr_payloadstringOriginal bank-issued FPS Common QR payload; never an invented account template.
currency_codestringISO 4217 receiving account currency. Required.
enabledboolWhether new bank-transfer checkouts may be created.
region_codestringISO 3166-1 alpha-2 country of the receiving bank. Required.
qr_profilestringOptional EMV merchant-presented QR country profile: hk_fps.

#Response

FieldTypeWhat it is
namestringResource name.
uidstringStable resource identity. Output only.
metaResourceMetaResource metadata. Output only.
account_holderstringVerified beneficiary name. Required.
bank_namestringReceiving bank name. Required.
bank_codestringReceiving bank routing or clearing code. Required.
account_numberstringReceiving account number, including branch digits. Required.
fps_idstringVerified FPS identifier displayed to the payer.
fps_qr_payloadstringOriginal bank-issued FPS Common QR payload; never an invented account template.
currency_codestringISO 4217 receiving account currency. Required.
enabledboolWhether new bank-transfer checkouts may be created.
region_codestringISO 3166-1 alpha-2 country of the receiving bank. Required.
qr_profilestringOptional EMV merchant-presented QR country profile: hk_fps.

#ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as If-Match or etag to make Update and Delete conditional; a mismatch fails with ABORTED / 409 ETAG_MISMATCH. Output only.
create_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

#Errors

  • UNAUTHENTICATED — No valid key or token was presented.
  • PERMISSION_DENIED — The key lacks the method's permission.
  • RESOURCE_NOT_FOUND — The named Resource does not exist or is not visible.
  • INVALID_FIELD — A field failed validation.
  • INVALID_STATE — The Resource is in a state that forbids the call.
  • ETAG_MISMATCH — The etag sent does not match the Resource's current etag.
  • UNAVAILABLE — The Resource store, the owning service's backend, or the key verifier's snapshot is unavailable; retry after Retry-After.

Every error arrives in the body Errors describes.

#Examples

curl -X PATCH "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/bank_transfer_accounts/bank-transfer-account" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account_holder":"…","account_number":"…","bank_code":"…","bank_name":"…","currency_code":"…","name":"orgs/acme/projects/shop/envs/production/bank_transfer_accounts/bank-transfer-account","region_code":"…"}'