For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Get support
HomeDocsAPI ReferenceRelease Notes
HomeDocsAPI ReferenceRelease Notes
  • Payments API
    • POSTRefresh API Keys
    • POSTCharge
    • POSTCapture
    • POSTVoid or Refund
    • POSTCheck Surcharge
    • POSTCreate Hosted Payment Page
    • PUTEdit Hosted Payment Page
    • POSTCreate Vault Payment Account
    • GETGet Vault Payment Account
    • DELDelete a Vault Payment Account
    • PUTUpdate Vault Account Details
    • POSTCreate Billing Plan
    • GETGet Billing Plan
    • DELCancel Billing Plan
  • Authentication (Reporting & Boarding)
    • POSTGet access token
  • Reporting API
    • GETGet transactions data
    • GETGet deposits data
    • GETGet chargebacks data
    • GETGet adjustments data
  • Boarding API
    • GETList merchants
    • POSTCreate a new merchant
    • GETGet a single merchant
Get support
LogoLogo

Update Vault Account Details

PUT
https://javelin.runpayments.io/api/v1/vault_payment_accounts/:vault_id
PUT
/api/v1/vault_payment_accounts/:vault_id
$curl -X PUT https://javelin.runpayments.io/api/v1/vault_payment_accounts/vault_id \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "mid": "MID123456789"
>}'
1{
2  "vault_id": "vault_987654321",
3  "account_zip": "90210",
4  "is_default": "Y",
5  "ach_acct_type_id": "1",
6  "address1": "1234 Elm Street",
7  "address2": "Apt 56B",
8  "city": "Beverly Hills",
9  "region": "CA",
10  "country": "USA",
11  "email": "john.doe@example.com",
12  "name": "John Doe",
13  "phone": "+1-310-555-1234",
14  "custom_06": "Preferred Customer",
15  "custom_07": "Loyalty Level 3",
16  "custom_08": "Newsletter Subscriber",
17  "custom_09": "Referral: Jane Smith",
18  "custom_10": "Notes: VIP client"
19}

Updates demographic detail for an existing vault by vault_id

Was this page helpful?
Previous

Create Billing Plan

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

vault_idstringRequired
The vault ID of the payment account to update

Request

This endpoint expects an object.
midstringRequired
Merchant ID number
account_zipstringOptional
Postal code
is_defaultstringOptional

Whether or not this payment method is the default account (Y)

ach_acct_type_idenumOptional

The type of ACH account. 1 - checking, 2 - savings, 3 - ledger

Allowed values:
address1stringOptional
Address information
address2stringOptional
Address information
citystringOptional
City of payment account holder
regionstringOptional
State of payment account holder
countrystringOptional
Country of payment account holder
emailstringOptional
Email address
namestringOptional
Name
phonestringOptional
Phone number
custom_06stringOptional
Customer level custom field
custom_07stringOptional
Customer level custom field
custom_08stringOptional
Customer level custom field
custom_09stringOptional
Customer level custom field
custom_10stringOptional
Customer level custom field

Response

Vault updated successfully
vault_idstring or null
The vault ID
account_zipstring or null
Postal code
is_defaultstring or null
Whether this is the default payment method
ach_acct_type_idstring or null
ACH account type
address1string or null
Address information
address2string or null
Address information
citystring or null
City
regionstring or null

State/region

countrystring or null
Country
emailstring or null
Email address
namestring or null
Name
phonestring or null
Phone number
custom_06string or null
Custom field
custom_07string or null
Custom field
custom_08string or null
Custom field
custom_09string or null
Custom field
custom_10string or null
Custom field

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error