See full changelog for the OpenAPI schema (OAS) here.
- Updating to OAS 2020-09-14_1.419.0
- Update
/signal/decision/report
description- Overwriting
initiated
field is now supported and no longer returns anINVALID_FIELD
error
- Overwriting
- Add
frequency
to/transactions/enrich
- Remove
category
,category_id
,transaction_type
,name
,payment_meta
fields from Base Report insights
- Add
card_switch
to/link/token/create
- Add
consumer_report_permissible_purpose
tolink/token/create
- Update
currency
onpayment/reverse
andamount_refunded
onpayment/get
- Updating to OAS 2020-09-14_1.413.0
- Add
statements
to/link/token/create
request
- Add
hosted_link_url
to/link/token/create
response - Add
hosted_link.delivery_method
to/link/token/create
- Add
link_sessions
to/link/token/get
- Add
LINK:SESSION_FINISHED
webhook
- Updating to OAS 2020-09-14_1.410.1
- Add
statements
to the list of supported Plaid products in the/link/token/create
endpoint
- add
/credit/relay/pdf/get
endpoint
- Add
original_client_id
to/transfer/balance/get
- Mark
type
optional in/transfer/balance/get
request
- Add
status
todocument_reference
in/credit/payroll_income/risk_signals/get
- Add
consumer_report_user_identity
to/user/create
- Add comment explaining availability of
confidence_level
field for/transactions/*
endpoints
- Added insights fields to
/cra/base_report/get
- Update identity/match user.address such that none of the fields are required
- Add
AddressDataNullableNoRequiredFields
- Allowing null failure_reason for refunds to be displayed
- Add
failure_reason
to/wallet/transaction/get
and/wallet/transaction/list
endpoint in virtual accounts.
- Add
parsing_config
to/link/token/create
- Add
failure_reason
field to refunds for failed and returned refunds
- Add
area_code
match status to the response of theidentity_verification/get
andidentity_verification/list
endpoint
- Add
POST /cra/bank_income/get
- Add
cra/base_report/get
endpoint
- Add
base_report
field to/link/token/create
and corresponding Base Report webhooks
- Make CreditBankIncomeWebhookUpdateResponse visible
- Remove extraneous
Item
field from/processor/transactions/get
response - Reference new
/processor/token/webhook/update
endpoint in processor Transactions routes.
- Document cash management account support
- Fix document capitalization of
confidence_level
field in/transactions/enrich
- Add
/beacon/report/create
- Add
POST /beacon/user/create
- Add
POST /beacon/user/get
- Made
/statements/list
and/statements/download
APIs for Plaid's Statements PDF beta product available in client SDKs
- Add
date_of_birth
andaddress
fields todocumentary_verification.documents[].extracted_data
in the response of all of the identity verification endpoints:identity_verification/create
identity_verification/get
identity_verification/list
identity_verification/retry
- Update the following about identity/match name, phone number, email, and address score descriptions:
- Ensure consistent language across all fields
- Include score recommended "match" threshold for all fields.
- Update the
async_update
field description.
- Mark a few response fields as always present in the identity verification API:
selfie_check.selfies[].capture.image_url
selfie_check.selfies[].capture.video_url
risk_check.identity_abuse_signals
risk_check.identity_abuse_signals.synthetic_identity.score
risk_check.identity_abuse_signals.stolen_identity.score
- Documentation updates for the
/link/token/create
endpoint
- Add
confidence_level
field to Counterparty and PersonalFinanceCategory for/transactions/enrich
- Remove the
core_attributes
field insignal_insights
of /transfer/authorization/create
-
Update the
pending_manual_verification
field's description in/auth/get
response -
Updating to openapi-generator v6.1 to enable autoload support
-
Updating to OAS 2020-09-14_1.391.1
- Update the description of
/investments/transactions/get
- Update the
async_update
option to be visible in/investments/transactions/get
- Update the
signal_insights
field's description in/transfers/authorization/create
request
- Add
transfer_id
field to/transfers/sweep/list
request
- Add
InvestmentsHistoricalUpdateWebhook
, aHISTORICAL_UPDATE
webhook of typeINVESTMENTS_TRANSACTIONS
.
- Add
status
field to a sweep object. Addstatus
field to/transfers/sweep/list
request
- [Breaking] Remove
asset_report_token
as required field in/asset_report/get
and mark as nullable
- Allow empty
mask
on themeta
field of overridden accounts in the sandbox custom user configuration object schema.
- Mark
region
andpostal_code
fields as nullable in/identity_verification/create
,/identity_verification/retry
, and/link/token/create
- Add payloads for processor Transactions webhooks.
- Mark
next_origination_date
nullable
- Updating to OAS 2020-09-14_1.385.1
- Add expiration time description to
transfer/authorization/create
idempotency_key
parameter
- Add
user
field to/identity_verification/retry
- Add
client_user_id
field to/identity_verification/create
- Deprecate
user.client_user_id
field in/identity_verification/create
- [Breaking] Renamed
IdentityVerificationRequestUser
object toIdentityVerificationCreateRequestUser
- Remove
maxLength
constraint fromclient_user_id
field for/processor/signal/evaluate
and/signal/evaluate
requests
- Add
test_clock_id
totransfer/authorization/create
request
- Update
InvestmentsAuthOwner
title
- Add
account_id
tobank_accounts
andtransactions
in/credit/bank_statements/uploads/get
response
- Add
transfer/diligence/document/upload
endpoint
- Add
amount
to/transfer/sweep/list
request
- Add
signal_insights
to/transfer/authorization/create
request
- Add definitions for
/sandbox/bank_income/fire_webhook
- Update validation
sweep_id
for/transfers/sweep/get
to allow UUID or 8 character hexadecimal string
- Updating to OAS 2020-09-14_1.379.0
- Add
scheme
to/wallet/transaction/get
and/wallet/transaction/list
- Fix issue in which
request_id
was erroneously not listed as required inItemActivityListResponse
- Add
reroute_to_credentials
to/link/token/create
auth request
- Add definitions for
/investments/auth/get
- Add
required_if_supported_products
to/link/token/create
request
- Add hidden
account_type
to/transactions/enrich
request and response - Add hidden
account_subtype
to/transactions/enrich
request and response
- Add
num_bank_statements_uploaded
todocument_income_results
object in/credit/sessions/get
response
- Add
income_source
enum to/transactions/enrich
counterparty_type
field
- Update
oauth
descriptions for/institutions/get
and/institutions/search
- Add
/credit/bank_statements/uploads/get
endpoint
- Add support for address and date of birth in
virtual-accounts/#wallettransactionexecute
endpoint
- Modify
/transactions/enrich
fielduser_id
toclient_user_id
- Modify
/transactions/enrich
fieldaccount_id
toclient_account_id
- Update docs for
/transactions/enrich
response to include non-null example values forlat
andlon
fields
- Update descriptions for
PAYMENT_STATUS_EXECUTED
andPAYMENT_STATUS_INITIATED
- Update description for
PaymentAmountCurrency
- Add
user_id
andaccount_id
fields to/transactions/enrich
request and resposne
- Update descriptions for
/credit/payroll_income/risk_signals/get
andINCOME_VERIFICATION_RISK_SIGNALS
webhook
- Add test_clock_id to
/transfer/simulate
- [Breaking change for Go] Make
virtual_time
optional in/sandbox/transfer/test_clock/create
- Add test_clock_id to
/sandbox/transfer/simulate
and/sandbox/transfer/sweep/simulate
endpoints
- Update
transfer/diligence/submit
copy
- Updating to OAS 2020-09-14_1.370.0
- Add
investments/refresh
endpoint
- Update
description
field in/transfer/create
to have max length of 15
- Add new
CreditBankIncomeCategory
value
- Fix
/processor/transactions
routes doc links
- Add
/processor/token/permissions/get
endpoint - Add
/processor/token/permissions/set
endpoint
- Add
transfer/diligence/submit
endpoint
- Update
client_user_id
description for Identity Verification endpoints - Update
user
description for Identity Match via Identity Verification Data use case
- Add
/transfer/balance/get
endpoint
- Added
LinkEventsWebhook
schema
- Add
credit_funds_source
field for authorizations and transfers - Make
funding_account_id
nullable in various /transfer API responses
- Update
notificationsPayload.customFields
datatype from an object to an array of objects
- Added
warnings
to/processor/signal/evaluate
response.
- Added
/processor/identity/match
endpoint.
- Adds a
selfie_check
object to the response schema of all the identity verification endpoints:identity_verification/create
identity_verification/get
identity_verification/list
identity_verification/retry
- Update
INCOME_VERIFICATION_RISK_SIGNALS
with webhook tag
- Add
ASSETS: PRODUCT_READY
andASSETS: ERROR
webhooks to/sandbox/item/fire_webhook
endpoint
- Removed explicit
additionalProperties: true
marker for request objects and objects used only within request objects, primarily impacting the Payment Initiation API. This will result in more strict type checking for those objects, but should not be a breaking change.
- Update
transfer/authorization/create
copy
- Add new
INCOME_VERIFICATION_RISK_SIGNALS
webhook
- Remove
settled_amount
- Rename
expected_settlement_schedule
asexpected_sweep_settlement_schedule
- [Breaking] Converts several types that were incorrectly typed as
number
tointeger
. In some languages, this will change the type used for this field, which may be a breaking change for some Plaid integrations. The following fields are impacted:
For all products:
PlaidError.status
For Liabilities:
PSLFStatus.payments_made
PSLFStatus.payments_remaining
For Identity Verification and Monitor:
DocumentaryVerificationDocument.DocumentAnalysis.attempt
EntityScreeningHitAnalysis.search_terms_version
EntityWatchlistScreeningSearchTerms.search_terms_version
IdentityVerificationTemplateReference.version
The following client library languages are impacted:
- Go: Type changes from Float64 to Int32
- Java: Type changes from Double to Integer
- Python: Type changes from float to int
- Ruby: Type changes from Float to Integer
- Update
/identity/match
's score description to explicitly mention that null values are returned if input is missing from either the financial institution or the API - Update
/identity/match
sample response to includeis_business_name_detected
- Make the
warnings
field inSignalEvaluateResponse
non-nullable
- Add
STARTED
andINTERNAL_ERROR
to bank income and employment/credit/sessions/get
status
- Change invalid format
datetime
todate
oninitiated_date
field - Update
SignalWarning
descriptions
Fix npm publish
- Releasing new
/credit/payroll_income/risk_signals/get
endpoint
- Revert
sweep_amount
description
- Update
sweep_amount
description
- Internal changes
- Updating to OAS 2020-09-14_1.345.1
- Update
/transactions/enrich
fieldis_recurring
field to be optional.bool
- Fix bug in which
environment
field was incorrectly missing from Assets webhooks.
- Add recurrence and is_recurring fields to
/transactions/enrich
- Update incorrect required fields for
/watchlist_screening/entity/update
- Update
owners
description for/credit/bank_income/get
and/beta/credit/v1/bank_employment/get
- Make comment about
webhook
field in/link/token/create
request more explicit
- Make VOA in /credit/freddie_mac/reports/get optional
- Update
warnings
description for/credit/bank_income/get
and/beta/credit/v1/bank_employment/get
- Updated Asset endpoint descriptions related to Verification of Employment
- Updating to OAS 2020-09-14_1.343.0
- Add new
warnings
field to the response of/signal/evaluate
- Add
report_type
to assets webhook docs - Make
add_ons
public in assets docs for /asset_report/create - Make
fast_report
public in assets docs for /asset_report/get
- Add
risk_check
attribute to all Identity Verification responses
- Update examples for
entity_id
in/transactions/enrich
- Create
options
in/link_delivery/create
- Create
recipient
withinoptions
field - Move
communication_methods
from top level torecipient
- Add
first_name
inrecipient
- Add
callback_type
to link delivery webhooks
- Make
communication_methods
optional in/link_delivery/create
- Remove beta description from
/transactions/enrich
endpoint docs
- Add
transaction_id
to/payment-initiation/#payment_status_update
- Add
payment_id
andwallet_id
to/virtual-accounts/#wallet_transaction_status_update
- Modify documentation for credit categories in the
/asset_report/get
based on GTM feedback
- Update description for the
address
field in/payment_initiation/recipient/create
.
- Add annually recurring frequency to
/transactions/recurring/get
- Make documentation for credit categories in the
/asset_report/get
endpoint public
- Add bank employment results to
/credit/sessions/get
- Add
signal
to Products array.
- Add options to
/credit/payroll_income/refresh
to allow item-level refresh
- Updated
amount.value
description field with new minimum requirement for/payment_initiation/payment/reverse
and/wallet/transaction/execute
- Add 'employment' as an available product in the request to
/partner/customer/create
- [Breaking] Renamed Identity Verification UserName objects to IdentityVerificationRequestUserName and IdentityVerificationResponseUserName
- Updating to OAS 2020-09-14_1.334.0
- Add "entity_id" field to /transactions/enrich
- Add "add_ons" field to asset_report/create
- [Breaking] Remove
/wallet/transaction/list
endpoint- [Note] Determined that
/wallet/transaction/list
is unused
- [Note] Determined that
Add LinkDeliveryCallbackWebhook
, LinkUserDeliveryStatusWebhook
for Link Delivery.
- [Breaking] Remove
options.wallet_id
field in/payment_initiation/payment/create
and/payment_initiation/consent/create
request.- [Note] Determined that this field is unused.
- Undeprecated the
legal_name
field in the/link/token/create
request.
- Add
income_verification
as a supported product in the request for/partner/customer/create
.
- Add
network
field to/transfer/intent/create
request. - Updated
reference
minLength for/wallet/transaction/execute
request and/payment_initiation/payment/reverse
request.
- Add
access_tokens
anditem_ids
to/link_delivery/get
response
- Add optional
persistent_account_id
field to account responses
- Add
employment
fields to/link/token/create
- Add
redacted_at
field in Identity Verification response and Documentary Verification Document component - Update
original_front
field in Identity Verification Document Images to be nullable in redacted Identity Verification sessions
- Add
earliest_deposit_date
and changelast_deposit_date
tolatest_deposit_date
for/beta/credit/v1/bank_employment/get
- Add
redirect_uris
to/partner/customer/create
request.
- Add
wallet_id
field to/wallet/transaction/get
and/wallet/transaction/list
responses
- Update
link_delivery/get
to removepublic_tokens
from the response
- Update
link_delivery/create
to acceptcommunication_methods
and deprecatedelivery_method
anddelivery_destination
- Fix the
refund_id
example. - Update address objects to reflect that in rare instances,
city
may benull
.
- Add partner webhook event type
- Mark
phone_number_verified_time
andemail_address_verified_time
as deprecated, since it is no longer required to provide these fields to enable to enable the Returning User Experience.
- Introduce
expected_settlement_date
field in the Transfer object
- Add
/beta/credit/v1/bank_employment/get
endpoint
- Add
updated
field to/credit/audit_copy_token/update
response - Add
SchemaVersion
to VOE and VOA schemas for/credit/freddie_mac/reports/get
- Introduce
funding_account_id
field in the Transfer API - Remove deprecated
origination_account_id
field from the Transfer documentation
- Use more strict validation for
payment_id
andrecipient_id
fields in API
- Use more strict validation for payment
consent_id
field in API
- Add
status
to Wallet schema
- Updating to OAS 2020-09-14_1.214.0
- Add
/credit/freddie_mac/reports/get
endpoint
- Reflect that
days_requested
field in Bank Income Verification object in/link/token/create
request is required when using Bank Income. - Reflect that
is_update_mode
field in Bank Income Verification object in/link/token/create
request defaults tofalse
. - Update description to reflect that Document Income object in
/link/token/create
request is not required, even when using Document Income.
- Update
PartnerEndCustomerStatus
enum values.
- Add
/credit/audit_copy_token/update
endpoint - Add
report_type
to AssetReportCreateRequest
- Fix
US_MBS
list code which was mistakenly documented asUS_MBC
for screening individuals with Monitor - Document
TR_CMB
list code for screening individuals with Monitor - Document
IZ_WBK
list code for screening individuals and entities with Monitor
- Add
/partner/customer/oauth_institutions/get
endpoint.
- Update example response for
/credit/bank_income/get
- Documentation updates for Investments APIs and Bank Transfer APIs.
- Add validation on
originator_client_id
andredirect_uri
for/transfer/originator/create
andtransfer/originator/get
request
- Add
company_name
to TransferOriginatorGetResponse
- Updating to OAS 2020-09-14_1.210.4
- Add
recurring_transfer_id
to Transfer
- Make
id_numbers
field hidden in/user/create
request
- Make
transfer_ids
required in RecurringTransfer
- Change the
/transactions/enrich
options.include_legacy_categories
field tooptions.include_legacy_category
- Make documentation for the
/transactions/enrich
options.include_legacy_category
request field visible - Make documentation for the
/transactions/enrich
legacy_category
andlegacy_category_id
response fields visible - Add
direction
to required fields forClientProvidedTransaction
- Add
/transfer/capabilities/get
endpoint to fetch RTP eligibility for a linked plaid item
- Renamed the
NullableRecurringTransfer
type toRecurringTransferNullable
type
Add nullable
property to date_of_birth
, phone_number_verified_time
, and email_address_verified_time
fields within LinkTokenCreateRequestUser
to resolve undesireable client library behavior in certain languages.
- add
NullableRecurringTransfer
field - replace
RecurringTransfer
withNullableRecurringTransfer
forTransferRecurringCreateResponse
- and
Decision
in required fields forTransferRecurringCreateResponse
- add required fields for
TransferRecurringSchedule
- Add
total_amounts
field to/credit/bank_income/get
response - Deprecate
amount
,iso_currency_code
, andunofficial_currency_code
at top levels in/credit/bank_income/get
response
- Add
id_numbers
field to/user/create
request
- Add
RECURRING_NEW_TRANSFER
webhook event. - Add
RECURRING_TRANSFER_SKIPPED
webhook event. - Add
RECURRING_CANCELLED
webhook event.
- make
idempotency_key
field for/transfer/recurring/create
non-nullable
- Add
description
field forRecurringTransfer
object - Make
TransferRecurringStatus
non-nullable
- Make all mentions of relay tokens lowercase
- Updated external URLs for Credit Relay endpoints, and marked them as beta in the summary
- Add more enums values to
pay_rate
field in/credit/payroll_income/get
response - Add
pay_basis
field to/credit/payroll_income/get
- Updated Credit Relay Token descriptions
- Add
FUNDS_SWEEP
as atype
enum for theWalletTransaction
object
- Make
test_clock_id
non-nullable intest_clock
.
- Update
CounterpartyType
to renamedelivery_marketplace
tomarketplace
- Update
CounterpartyType
to addpayment_terminal
- Update the
transactions/enrich
transaction description example to match the request.
- Add
/sandbox/transfer/test_clock/list
for recurring transfer - rm
decision
anddecision_rationale
fromRecurringTransfer
- add
decision
anddecision_rationale
inTransferRecurringCreateResponse
- rename
frozen_timestamp
tovirtual_time
- not requiring
client_id
andsecret
for recurring transfer APIs
- Use a nested
options
field for optional request params totransactions/enrich
- Make nullable fields required for
transactions/enrich
- Update supported payment scheme options for
/payment_initiation/payment/create
– Update description of/payment_initiation/recipient/create
to mention non-Eurozone countries. – Update/payment_initiation/payment/create
mentioning new currencies and non-Eurozone markets. – RemovedCHF
andCZK
from the list of supported currencies.
- Add website and logo_url to the
Counterparty
object for the Enrich product. - Update descriptions for logo_url field in
Counterparty
,TransactionCounterparty
,Enrichments
andEnhancements
.
- Update field descriptions and response examples for
transactions/enrich
- Add support for optional request parameters in /transactions/enrich
- Add
location
field toClientProvidedTransaction
object - Add
mcc
field toClientProvidedTransaction
object - Add
date_posted
field toClientProvidedTransaction
object
- Document partial refunds
- Update description for
/payment_initiation/payment/reverse
endpoint - Update description for
/payment_initiation/payment/get
endpoint
- Updating to OAS 2020-09-14_1.205.3
- Update description for
/signal/evaluate
endpoint
- Update response examples, descriptions, and formatting for
/transactions/enrich
endpoint
- Update descriptions for
CUSIP
andISIN
fields in the investmentsSecurity
type to reflect CGS license requirements
- Add
/transactions/enrich
endpoint, the EA version of/beta/transactions/v1/enhance
.
- Remove
/income/verification/refresh
endpoint
- Add 7 brand new recurring transfer APIs
- Add
/transfer/recurring/create
- Add
/transfer/recurring/list
- Add
/transfer/recurring/get
- Add
/transfer/recurring/cancel
- Add
/sandbox/transfer/test_clock/create
- Add
/sandbox/transfer/test_clock/advance
- Add
/sandbox/transfer/test_clock/get
- IdentityMatchResponse
PhoneNumberMatchScore
andEmailAddressMatchScore
usescore
instead ofscores
- Add
/partner/customer/remove
endpoint
- Internal changes
- New Transfer API routes for hosted onboarding of TPS end-customers
- Add
refunds
field toTransfer
object - Add
refund_id
field toTransferEvent
object - Fix typo for
transfer/get
andtransfer/refund/get
- Add support for partial refunds
- Add
amount
field to/payment_initiation/payment/reverse
request - Add
amount_refunded
field to/payment_initiation/payment/get
and/payment_initiation/payment/list
responses
- Add
risk_summary
andpage_number
to/beta/credit/payroll_income/risk_signals/get
- Renamed
/wallet/transactions/list
into/wallet/transaction/list
as endpoint
/transfer/authorization/create
and/transfer/create
may not returnaccount_id
in response.
- Add
SYNC_UPDATES_AVAILABLE
support to/sandbox/item/fire_webhook
- Make
ProductStatus
object nullable to reflect Sandbox-specific behavior. - Clarify documentation for
SYNC_UPDATES_AVAILABLE
webhook.
- Internal changes
- Add
deleted_at
to/payment_profile/get
response.
- Change
start_date
tostart_time
for/wallet/transaction/list
response.
- Update list of available products for
/partner/customer/create
.
- Add
institution_name
andinstitution_id
fields to/credit/payroll_income/get
response.
- Add
options.start_date
andoptions.end_date
to/wallet/transaction/list
endpoint. - Add
last_status_update
andpayment_id
field toWalletTransaction
. - Add
transaction_id
field toPaymentInitiationPayment
- Add
originator_client_id
to Transfer API endpoints
- Deprecate
origination_account_id
from/transfer/authorization/create
endpoint.
- Add
asset_under_management
field toPartnerCustomerCreateRequest
.
- Updating to OAS 2020-09-14_1.205.3
- Update description for
/signal/evaluate
endpoint
- Update response examples, descriptions, and formatting for
/transactions/enrich
endpoint
- Update descriptions for
CUSIP
andISIN
fields in the investmentsSecurity
type to reflect CGS license requirements
- Add
/transactions/enrich
endpoint, the EA version of/beta/transactions/v1/enhance
.
- Remove
/income/verification/refresh
endpoint
- Add 7 brand new recurring transfer APIs
- Add
/transfer/recurring/create
- Add
/transfer/recurring/list
- Add
/transfer/recurring/get
- Add
/transfer/recurring/cancel
- Add
/sandbox/transfer/test_clock/create
- Add
/sandbox/transfer/test_clock/advance
- Add
/sandbox/transfer/test_clock/get
- IdentityMatchResponse
PhoneNumberMatchScore
andEmailAddressMatchScore
usescore
instead ofscores
- Add
/partner/customer/remove
endpoint
- Internal changes
- New Transfer API routes for hosted onboarding of TPS end-customers
- Add
refunds
field toTransfer
object - Add
refund_id
field toTransferEvent
object - Fix typo for
transfer/get
andtransfer/refund/get
- Add support for partial refunds
- Add
amount
field to/payment_initiation/payment/reverse
request - Add
amount_refunded
field to/payment_initiation/payment/get
and/payment_initiation/payment/list
responses
- Add
risk_summary
andpage_number
to/beta/credit/payroll_income/risk_signals/get
- Renamed
/wallet/transactions/list
into/wallet/transaction/list
as endpoint
/transfer/authorization/create
and/transfer/create
may not returnaccount_id
in response.
- Add
SYNC_UPDATES_AVAILABLE
support to/sandbox/item/fire_webhook
- Make
ProductStatus
object nullable to reflect Sandbox-specific behavior. - Clarify documentation for
SYNC_UPDATES_AVAILABLE
webhook.
- Internal changes
- Add
deleted_at
to/payment_profile/get
response.
- Change
start_date
tostart_time
for/wallet/transaction/list
response.
- Update list of available products for
/partner/customer/create
.
- Add
institution_name
andinstitution_id
fields to/credit/payroll_income/get
response.
- Add
options.start_date
andoptions.end_date
to/wallet/transaction/list
endpoint. - Add
last_status_update
andpayment_id
field toWalletTransaction
. - Add
transaction_id
field toPaymentInitiationPayment
- Add
originator_client_id
to Transfer API endpoints
- Deprecate
origination_account_id
from/transfer/authorization/create
endpoint.
- Add
asset_under_management
field toPartnerCustomerCreateRequest
.
- Updating to OAS 2020-09-14_1.197.3
- Move from Ruby 2.4.0 to Ruby 3, incorporating #440
- Consolidate usages of
Error
intoPlaidError
- Rename
LOGIN_REQUIRED
from transfer authorizationsdecision_rationale
toITEM_LOGIN_REQUIRED
- Update
IdentityVerificationRequestUser.date_of_birth
to be required to match the existing behavior of the API.
- Update supported
CountryCode
's inlink/token/create
docs.
- ach_class optional
- add rtp network option
- Add newly supported languages for Link
- Add
PAYMENT_PROFILE_LOGIN_REQUIRED
to transfer authorizationdecision_rationale.code
.
- Add
institution_name
field topayroll_income_result
of/credit/sessions/get
- Add requirements for
logo
inPartnerCustomerCreateRequest
.
- Deprecate webhook status
VERIFICATION_STATUS_PENDING_APPROVAL
inincome_verification
apis.
- Add a note in the description of
/transfer/authorization/create
- Added endpoint
/sandbox/payment_profile/reset_login
- Consolidate usages of
Error
intoPlaidError
- Add a
PlaidErrorType
enum
- Fix typo for
income_verification
in/sandbox/public_token/create
options
- Update field descriptions in
/partner/customer/*
responses. - Make
PartnerEndCustomerWithSecrets
extendPartnerEndCustomer
. - Fix documentation links in
/partner/customer/*
endpoints.
- Add
/partner/customer/enable
endpoint
- Rename
LOGIN_REQUIRED
from transfer authorizationsdecision_rationale
toITEM_LOGIN_REQUIRED
- Add
/fdx/notifications
endpoint.
- Add
USER_REPORTED_NO_INCOME
to CreditSessionBankIncomeStatus
- Update description for
payment_profile_token
field
- Add
income_verfication
field to/sandbox/public_token/create
- Add
document_income_result
field tocredit/sessions/get
- Remove
payment_profile_id
from/payment_profile/*
,/transfer/authorization/create
, and/transfer/create
endpoints and replace withpayment_profile_token
- Removed auditor_id from /credit/audit_copy/token/create
- Add length boundary for the
client_user_id
field inuser/create
- Add
SchemaVersion
field to Freddie Mac Verification of Assets Schema
- Add
non-custodial wallet
to account subtypes supported for investments - Add
trade
investment transaction subtype as a subtype oftransfer
investment transaction type
- Add
errors
field tocredit/sessions/get
- Add
payroll_income_result
field tocredit/sessions/get
- Update
IdentityVerificationRequestUser.date_of_birth
to be required to match the existing behavior of the API.
- Add support for
USER_INPUT_TIMEOUT
as a value forforce_error
in the sandbox custom user schema.
- Make
payment_id
not required in/link/token/create
under thepayment_initiation
field.
- Add
beacon_session_id
field in req of /transfer/authorization/create endpoint.
- Add
/link/oauth/correlation_id/exchange
endpoint.
- Updating to OAS 2020-09-14_1.181.1
- Update
report_tokens
in/credit/relay/create
endpoint request to be a list of strings instead a list of objects
- Add
credit/sessions/get
endpoint
- Remove
Date
andDateNullable
types in identity_verification and monitor endpoints. Replace withISO8601Date
andISO8601DateNullable
instead.
- Remove
idempotency_key
field from resp of /transfer/authorization/create endpoint.
- Change
institution_price_as_of
field on the Holdings object to nullable
- Add
AUTHORISING
wallet transaction status
- Add
/partner/customer/get
endpoint. - Add
status
to the response for/partner/customer/create
.
- Add
settled
as a valid event type for/sandbox/transfer/simulate
- Replace
ASSET_TRANSACTION_DESCRIPTION
withASSET_TRANSACTION_DESCRIPTON
in Freddie Mac Asset Report
- Add
ownership_type
to Asset Report account object, to reflect actual API behavior. - Update and clarify docs, including update to reflect new Transfers cutoff times.
- Add
settled
as a possible Transfer status andswept_settled
as a possible Transfer sweep status - Add
settled
andswept_settled
as new Transfer event types - Add
settled
field to Transfer sweep object - Add
standard_return_window
andunauthorized_return_window
fields to Transfer object
- Add
options
anddays_to_included
toAssetReportGetRequest
- Add
recipient_id
field examples to the/wallet/create
,/wallet/get
, and/wallet/list
responses
- Set
employment_report_token
field in the/credit/employment/get
endpoint to be not required
- Add
mask
to themeta
field of overridden accounts in the sandbox custom user configuration object schema.
- Remove
MiddleName
and addVALIDATION_SOURCES
to Freddie Mac Asset Report
- Add
adyen
as processor partner
- Add
environment
as an attribute to all webhook payloads
- Add
idempotency_key
field in req/resp of /transfer/authorization/create endpoint.
- Removed
/asset_report/relay/
endpoints
- Add payroll institution to /credit/income/precheck endpoint.
- Add
recipient_id
to the/wallet/create
,/wallet/get
, and/wallet/list
responses
- Fix that
client_id
andsecret
were erroneously marked asrequired
for the request bodies of some endpoints. (These fields can be sent in the header and thus are not required in bodies).
- Add
with_guarantee
field in request of/transfer/authorization/create
- Add
issuing_region
as a field in the extracted data to documentary verification documents/identity_verification/create
,/identity_verification/get
,/identity_verification/list
and/identity_verification/retry
responses.
- Add
bacs
/iban
recommendation for/payment_initiation/recipient/create
- Update descriptions for
/payment_profile/create
,/payment_profile/get
and/payment_profile/remove
-- Add counterparties
to /beta/transactions/v1/enhance
response
- Added
MICRODEPOSIT_ERROR
which was returned by the API but missing from the error type enum. - Various fixes to typos and descriptions
- Add authorization code
MIGRATED_ACCOUNT_ITEM
for Items created via/transfer/migrate_account
endpoint
- Add
updated_at
field to Payroll Item entries in/credit/payroll_income/get
- removed LoanRoleType, ReportIdentifierType, and ReportDateTime fields from
/credit/asset_report/freddie_mac/get
- Remove deprecated reverse_swept enum value from documentation
- Update example response for the
wallet/list
endpoint
- Add details for
IdentityMatchResponse
for/identity/match
endpoint
- Update descriptions for
HOLDINGS: DEFAULT_UPDATE
andINVESTMENT_TRANSACTIONS: DEFAULT_UPDATE
webhooks
- Removed report_type from the request to
/credit/asset_report/freddie_mae/get
- Add documentation for credit categories in the
/asset_report/get
endpoint
- Remove redundant parameters from the
/transfer/create
endpoint from docs and mark them as deprecated
- Add the following new currencies for the
/payment_initiation
API route group: PLN, SEK, DKK, NOK, CHF, CZK
- Update description for
/payment_initiation/payment/reverse
to indicate that this endpoint only works with virtual accounts - Update description for
/wallet/transaction/execute
to indicate that settlement will take seconds to days
- Remove verification fields from
/credit/payroll_income/get
and/income/verification/paystubs/get
- Remove pull_id field from
/credit/payroll_income/get
- Update external documentation links for the
/wallet/
API route group - Update
/payment_initiation/payment/reverse
description to cover which payments are eligible for refunds - Update
/payment_initiation/payment/create
reference field description to indicate that references should be unique and will be adjusted automatically - Update
PaymentInitiationPaymentStatus
description to indicate that payments may take seconds to days to settle depending on the payment rail used - Update
WalletTransactionStatus
description to indicate that transactions may take seconds to days to settle depending on the payment rail used
- Make
is_savings_or_money_market_account
field inSignalEvaluateCoreAttributes
nullable
- Add new endpoint
/credit/asset_report/freddie_mac
- Add
/link_delivery/create
endpoint - Add
/link_delivery/get
endpoint
- Fix minimum and maximum values in
/signal/evaluate
scores
- Make holdings
institution_price_as_of
non-nullable
- Add
WalletTransactionStatusUpdateWebhook
object - Update
WalletTransactionStatus
to include an additionalSETTLED
enum - Update
PaymentInitiationPaymentStatus
to include an additionalPAYMENT_STATUS_SETTLED
enum
- Updating to OAS 2020-09-14_1.161.5
- Reverts the changes made in 2020-09-14_1.157.0
- Update description for webhook
USER_PERMISSION_REVOKED
- Bug fix: Put quotes around the '529' account type to prevent generated client libraries from treating it as an integer.
- Add
RECURRING_TRANSACTIONS_UPDATE
to description of sandbox webhook testing endpoint
- Change the Item schema to refer to
PlaidError
rather thanError
to avoid namespace conflicts in client libraries.
- Add required fields back to AssetReport schema
- Remove
access_token
request parameter from/beta/partner/v1/customers/create
- Add
user
fields to the/link/token/create
user
object.
- Add
RECURRING_TRANSACTIONS_UPDATE
webhook specification - Fix typo in
/sandbox/item/fire_webhook
description
- Add x-plaid-validation for Credit Relay Tokens
- Add
address
andid_number
fields to the/link/token/create
user
object.
- Update and add schemas referred by
AssetReportGetResponse
- Add
payment_profile_id
to/transfer/authorization/create
and/transfer/create
- Make
access_token
andaccount_id
optional in/transfer/authorization/create
and/transfer/create
- Add
payment_profile_id
as a field undertransfer
for/link/token/create
- Create
/credit/bank_income/pdf/get
to allow customers to retrieve the bank income product as a PDF
-- Add personal_finance_category_icon_url
to /beta/transactions/v1/enhance
response
-- Add new endpoint /beta/partner/v1/customers/create
- Add
form1099s
as part of thecredit/payroll_income/get
response. - Add
Credit1099
object and corresponding subtypes.
- Update required fields list for guaranteed ACH customers
- Mark
verification
field underpaystubs
object in/credit/payroll_income/get
as deprecated
- Make
user_present
under/transfer/authorization/create
nullable
- Update fields description for guaranteed ACH customers
- Add
gave_consent
as a field underidentity_verification
for/link/token/create
- Remove
identity_verification.consent
, which is deprecated, from documentation for/link/token/create
- Add
user_present
a an optional field under/transfer/authorization/create
, update fields description for guaranteed ACH customers
- Remove deprecated
reversed
status from Transfer schema - Remove deprecated
reverse_swept
status from Transfer Event schema
- Add new endpoints
/credit/relay/get
,/credit/relay/refresh
and/credit/relay/remove
- Updating to OAS 2020-09-14_1.146.0
- make item_logins field not required
- Make changes to IdentityMatchRequest to support options data
- Remove unsupported error_code (
PRODUCTS_NOT_SUPPORTED
) for theforce_error
config in Sandbox
- Make changes to support crypto in Investments product
- Add new endpoints
/payment_profile/get
and/payment_profile/remove
- Bug fix: add
identity_verification
toProducts
array
- Add a new endpoint
/payment_profile/create
- Add
stated_income_sources
as a field underincome_verification
for/link/token/create
- Add
bin
as a field underinstitution_metadata
for/link/token/create
- Add
international
IBAN numbers toWalletNumbers
field in/wallet/get
and/wallet/list
responses. - Wrap the
iban
field in theWalletTransactionCounterpartyNumbers
under new fieldinternational
.
- Add new
identity/match
endpoint, andIdentityMatchRequest
andIdentityMatchResponse
- Update comment for the
recipient.name
field with recommendation to avoid long strings and special characters.
- Reverts the changes made in 2020-09-14_1.135.0. ProductAccess and AccountProductAccess once again have all fields explicitly defined.
- Add
products
inasset_report/create
endpoint.
- Convert ProductAccess and AccountProductAccess to optional.Map
- Rename
merchant_website
andmerchant_logo_url
in/beta/transactions/v1/enhance
towebsite
andlogo_url
- Update
/credit/payroll_income/get
response to have apull_id
instead of anincome_report_token
and addpull_id
to/credit/employment/get
response
- Made several fields nullable for
/signal/evaluate
- Add
/credit/audit_copy_token/remove
to invalidate Audit Copy tokens
- Updating to OAS 2020-09-14_1.131.3
- Update external URL for
/transfer/migrate_account
endpoint
- Add
TRANSFER_LIMIT_REACHED
to enumTransferAuthorizationDecisionRationaleCode
- Update
/payment_initiation/consent/*
external docs URLs
- Add
iban
tocounterparty
'snumbers
field in/wallet/transaction/execute
- Update description of
/user/create
to make it more clear what would happen when a client calls the user creation endpoint with the same client_user_id multiple times.
- Add
signal_description
for each risk signal in/beta/credit/payroll_income/risk_signals/get
- Change
DocumentRiskSignalInstitutionMetadata
to be nullable
- Fix category rules formatting
- Change description in
UserCustomPassword
to reflect that only top level fields are optional not all fields
- Move Category Rules description to
include_personal_finance_category
flag
- Updating to OAS 2020-09-14_1.128.4
- Add
identity_verification
as a new optional parameter for/link/token/create
- Add category rules beta to
personal_finance_category
field description in/transactions/get
- Updating to OAS 2020-09-14_1.128.2
- Update description of
/investments/transactions/get
endpoint - Update description of
cost_basis
field
- Add
merchant_website
andmerchant_logo_url
to/beta/transactions/v1/enhance
response
- Add
auth_type_select_enabled
,automated_microdeposits_enabled
,instant_match_enabled
, andsame_day_microdeposits_enabled
to/link/token/create
- Marked
flow_type
parameter as deprecated
- Add
consent_id
filter to/payment_initiation/payment/list
- Add
consent_id
to/link/token/create
- Added
/credit/relay/create
endpoint
- Add
accounts
object to/credit/payroll_income/get
response
- Added
include_fast_report
inasset_report/create
endpoint. Addedfast_report
inasset_report/get
endpoint
- Removed
reversed
andreverse_swept
from possible event_type values in TransferEventListRequest docs
- Change
tokens
toreport_tokens
in/credit/audit_copy_token/create
request
- Add
request_id
to all Identity Verification and Monitor responses
- Added sample user_id to INCOME_VERIFICATION webhook
- Pre-release API refinements to Monitor and Flow endpoints
- Updating to OAS 2020-09-14_1.121.0
- Add TimestampNullable type
- Removed
Uploaded
,Created
andAPPROVAL_STATUS_APPROVED
enum strings fromPayrollItemStatus
field.
- Add
returned
to TransferStatus enum - Add
return_swept
to TransferSweepStatus enum - Add
returned
andreturn_swept
to TransferEventType enum
- Added
employee_type
andlast_paystub_date
to/credit/employment/get
response
- Make
/payment_initiation/consent/create
API more strict
- Add
/credit/audit_copy_token/create
endpoint
- Add
/wallet/list
endpoint
- Updating to OAS 2020-09-14_1.115.2
- Update description fields to fix formatting errors
- Reflect that
error.suggested_action
isnullable
- Update OpenAPI spec
- Added
income_report_token
to/credit/payroll_income/get
response
- Add
/wallet/create
endpoint
- Add beta
additional_consented_products
field to/link/token/create
- Updated
/transactions/recurring/get
description
- Add webhooks for new Monitor and Identity Verification products
- Add endpoints for new Monitor and Identity Verification products
- Remove
emi_recipient_id
from Payment Initiation Recipient
- Add optional
iban
andbacs
fields tooptions
in the/payment_initiation/consent/create
request
- Updated
/transactions/sync
description
- Add more accurate enum documentations to
/transactions/recurring/get
API doc
- Additional documentation for
/transactions/sync
- Remove deprecated field
createdAt
from/application/get
response
- Add field validation to
BankTransferDirection
- Remove deprecated field
createdAt
from/application/get
response
- Add external doc link to
transactions/recurring/get
- Updating the API doc for Recurring Transactions
- Add
DisplayName
in/application/get
response
- Updated sample responses for all Transfer endpoints
- Changing
beta/transactions/rules/
routes tobeta/transactions/rules/v1
- Fixing
InsitututionMetadata
typo toInstitutionMetadata
in private/beta/credit/payroll_income/risk_signals/get
endpoint response
- Added
require_guarantee
,guarantee_decision
, andguarantee_decision_rationale
to/transfer/intent
in order to support Guarantee when using Transfer UI.
- Add additional supported
type
enums inWalletTransaction
.
- Add Additional History billing information for /asset_report/create.
- Add
user_id
to income verification webhook payload
- Make
consent_id
field nullable inPaymentInitiationPayment
.
- Replace
initiated_refunds
withrefund_ids
in the/payment_initiation/payment/get
and/payment_initiation/payment/list
responses
- Added
/beta/credit/payroll_income/risk_signals/get
endpoint (currently private)
- Remove unsupported ACH classes from
bank_transfer/
andtransfer/
endpoints.
- Add
enable_multiple_items
parameter for bank income.
- Fix typo in
institution_name
parameter for credit endpoints.
- Added
reference
andidempotency_key
fields to thepayment_initiation/payment/reverse
request.
- Added
is_update_mode
toincome_verification
in the/link/token/create
body
- Consolidate item schemas
- Updating to OAS 2020-09-14_1.105.1
- Expose Faraday::Connection object for additional configuration options
- Removed
client_id
andsecret
as required fields from/transfer/intent/{get,create}
to match actual API behavior.
- Add
/credit/payroll_income/refresh
endpoint
- Added
/signal/prepare
- Add
/transactions/recurring/deactivate
endpoint
- Added
/watchlist_screening/individual/list
(currently private) - Added
/watchlist_screening/individual/create
(currently private) - Added
/watchlist_screening/individual/get
(currently private) - Added
/watchlist_screening/individual/update
(currently private) - Added
/watchlist_screening/individual/history/list
(currently private) - Added
/watchlist_screening/individual/review/list
(currently private) - Added
/watchlist_screening/individual/review/create
(currently private) - Added
/watchlist_screening/individual/hit/list
(currently private) - Added
/watchlist_screening/entity/list
(currently private) - Added
/watchlist_screening/entity/create
(currently private) - Added
/watchlist_screening/entity/get
(currently private) - Added
/watchlist_screening/entity/update
(currently private) - Added
/watchlist_screening/entity/history/list
(currently private) - Added
/watchlist_screening/entity/hit/list
(currently private) - Added
/watchlist_screening/entity/review/list
(currently private) - Added
/watchlist_screening/entity/review/create
(currently private) - Added
/watchlist_screening/individual/program/list
(currently private) - Added
/watchlist_screening/individual/program/get
(currently private) - Added
/watchlist_screening/entity/program/list
(currently private) - Added
/watchlist_screening/entity/program/get
(currently private) - Added
/dashboard_user/list
(currently private) - Added
/dashboard_user/get
(currently private) - Added
/identity_verification/list
(currently private) - Added
/identity_verification/get
(currently private) - Added
/identity_verification/retry
(currently private) - Modified
/identity_verification/create
(currently private)
- Add endpoint for
/credit/bank_income/refresh
- Add
include_original_description
,include_personal_finance_category
options to/transactions/sync
request.
- API changes for /credit/employment/get
- Add
gusto
as processor partner
- Add
user_token
as a request parameter for/sandbox/public_token/create
- Remove
auth
,transactions_updates
,investments_updates
, andidentity
as required fields from Item status to match actual API behavior.
- Updating to OAS 2020-09-14_1.97.0
- [Beta] Rename some
Credit
refs that were preventing client library generation from completing successfully
- remove unused
payroll_income_id
from/credit/payroll_income/get
field - add status object to items in
/credit/payroll_income/get
response body
- Add
TransferEventsUpdateWebhook
schema
- Add
institution_data
parameter to/link/token/create
- Tidy up YAML
- Add
highnote
processor to/processor/token/create
- Updating to OAS 2020-09-14_1.94.0
- Add
use_case
,company_legal_name
,city
,region
,country_code
,postal_code
as a required response field ofApplication
- Remove
income_verification_id
from income webhook example - Fix incorrect URL for
/user/create
endpoint
- Remove deprecated
income_verification_id
from income webhooks - Standardize income webhook casing
- Add several new fields to
/signal/evaluate
response
- Add
/sandbox/transfer/fire_webhook
endpoint
- Mark certain Income endpoints as deprecated in favor of the new
/credit/*
endpoints.
- Add
checkout
processor to/processor/token/create
- Add
webhook_type
parameter to/sandbox/item/fire_webhook
- Support for investments transactions, investments holdings and liabilities
DEFAULT_UPDATE
webhooks
- Add new warning type to
/credit/bank_income/get
response
- Add
marqeta
andsolid
as Auth processor partners - Fix schema of
cause
parameter for Asset Reports - Fix some invalid examples
- Add
/credit/employment/get
endpoint - Add optional
access_tokens
array to/credit/payroll_income/precheck
request
- Update description of
/sandbox/item/fire_webhook
- Update description of
accounts/get
- Added
AUTH_DATA_UPDATE
webhook code as valid input to/sandbox/item/fire_webhook
- Update description for
/sandbox/item/fire_webhook
- Add
/transfer/migrate_account
endpoint
- Fix operationId for
/credit/payroll_income/precheck
- Remove deprecated fields from
/item/application/list
- Add
wire_routing_number
parameter to/bank_transfer/migrate_account
- Specify minimum length of 1 for
description
onTransferIntentCreateRequest
- Add
consent_id
support in the Institutions Search request
- Add
apex_clearing
as a processor partner
- Introduce Credit Payroll Income APIs
- Introduce Credit Precheck API
- Add
/identity_verification/create
endpoint, kept private for now
- Add
status
field toConnectedApplication
- Updating to OAS 2020-09-14_1.84.5
- Added missing
asset_report_id
field to/asset_report/relay/refresh
- Change summary description and url for
/credit/bank_income/get
- Slight wording change for
/credit/bank_income/get
response fields
- Move
user_token
to top level oflink/token/create
request
- Correct typo in enum value for Investment subtypes (
person
->pension
)
- Fix schema to properly handle personal finance categories in
/transactions/get
- Add
user_token
parameter tolink/token/create
- Add new fields to
/credit/bank_income/get
response
- Remove
permitted
decision for/transfer/authorization/create
- Add beta field
consented_products
to/item/get/
endpoint response
- Revamp LinkTokenCreate.IncomeVerificationOptions for GA
- Add
/transaction/rules/create
,/transaction/rules/list
and/transaction/rules/remove
endpoints
- Added
/user/create
endpoint
- Updating to OAS 2020-09-14_1.79.0
- Many enum fields have been de-anonymized and renamed, new names can be found in the
2020-09-14_1.64.15
change message - Non integer numbers are now
float64
fields
- Update to include all changes up to
2020-09-14_1.77.4
(Undo revert from1.78.x
updates)
- Remove the word "Asset" before "Relay" in every asset report relay related responses and request objects
- Add "AssetReport" at the beginning of relay related responses and request objects to match the same pattern as other assets related objects
- Add
ProductAccess
fields for upcoming partner
- Updating to OAS 2020-09-14_1.78.2
- Ruby library 14.13.0 was erroneously released as a
minor
version; 14.13.0 changes will be re-released as amajor
version shortly.
- Updating to OAS 2020-09-14_1.77.1
- Many enum fields have been de-anonymized and renamed, new names can be found in the
2020-09-14_1.64.15
change message
- Fix extraneous field in enum that caused issue in code generation
- Added
asset_report_id
to the example for/asset_report/relay/refresh
- Explicitly set
format: double
for non-integer numbers so generated fields prefer float64
- Add three new endpoints for Assets:
/asset_report/relay/create
,/asset_report/relay/get
, and/asset_report/relay/rmeove
- Added
/asset_report/relay/refresh
endpoint
- Add
recurring_transactions
to list of products
- Add new endpoint for
/credit/bank_income/get
- Updated documentation URLs for all product endpoints. They can now be found
at
/docs/api/products/<product-name>/#endpoint
instead of/docs/api/products/#endpoint
- internal changes
- Remove deprecated
income_verification_id
from/sandbox/income/fire_webhook
- Reorder processors enum
- Added
/beta/transactions/v1/enhance
endpoint
- Added
status
object to sample responses for/institutions/get
andinstitutions/search
endpoints
- Mark
include_personal_finance_category_beta
property as deprecated. - Add new argument
include_personal_finance_category
to TransactionsGetRequestOptions. - Update docs for
/transactions/get
request and response, referencing personal_finance_category taxonomy csv file.
- internal changes
- Removed unused
/income/verification/summary/get
endpoint
- Added Payment Consent endpoints
- Removed unused
/income/verification/paystub/get
endpoint
- De-anonymized enums:
PaymentInitiationPaymentReverseResponse.properties.status
=>PaymentInitiationRefundStatus
PaymentInitiationPaymentCreateResponse.properties.status
=>PaymentInitiationPaymentCreateStatus
PaymentInitiationRefund.properties.status
=>PaymentInitiationRefundStatus
PaymentAmount.properties.currency
=>PaymentAmountCurrency
InvestmentTransaction.properties.type
=>InvestmentTransactionType
InvestmentTransaction.properties.subtype
=>InvestmentTransactionSubtype
TransferAuthorizationDecisionRationale.properties.code
=>TransferAuthorizationDecisionRationaleCode
TransferAuthorizationGuaranteeDecisionRationale.properties.code
=>TransferAuthorizationGuaranteeDecisionRationaleCode
TransferAuthorization.properties.decision
=>TransferAuthorizationDecision
TransferEventListRequest.properties.transfer_type
=>TransferEventListTransferType
BankTransferEventListRequest.properties.bank_transfer_type
=>BankTransferEventListBankTransferType
BankTransferEventListRequest.properties.direction
=>BankTransferEventListDirection
TransferIntentCreate.properties.status
=>TransferIntentStatus
TransferIntentGet.properties.status
=>TransferIntentStatus
TransferIntentGet.properties.authorization_decision
=>TransferIntentAuthorizationDecision
IncomeVerificationPrecheckMilitaryInfo.properties.branch
is now a string field (previously enum)
- Made
last_statement_balance
andminimum_payment_amount
nullable
for credit card liabilities schema to reflect existing API behavior.
- Made
last_payment_amount
andlast_statement_issue_date
nullable
for credit card liabilities schema to reflect existing API behavior. - Fix transfers examples to reflect more consistent usage of
region
field.
- Updating to OAS 2020-09-14_1.64.13
- Fix issue where library did not correctly detect if app is a Rails app.
- Deprecate
idempotency_key
parameter in transfer/create
- Removed the unused
required_product_access
andoptional_product_access
parameters fromRequestedScopes
- Fix some examples that were not consistent with their schemas
- Add
adjustments
as an investments transaction type to make OpenAPI file consistent with values returned by the API - Clarify description field for
marital_status
to reflect possible values
- Updated the external docs URL for Bank Transfers sandbox endpoints
- De-anonymized the object filters under
LinkTokenCreateRequestAccountSubtypes
, as anonymous objects aren't compatible with the generated CLibs. - De-anonymized some misc. objects
PaymentInitiationMetadata/properties/maximum_payment_amount
PaystubOverride/properties/employer
PaystubOverride/properties/employee
PaystubOverride/properties/employee/properties/address
LiabilitiesDefaultUpdateWebhook/properties/account_ids_with_updated_liabilities
- Updated the description of the historical_balances array
- Add new possible enums for income verification earnings breakdown canonical description
- Hid a few product enum values that are deprecated or no longer valid for certain request fields. This affects the documentation only.
- Make guarantee fields required in Transfer endpoints
- Updated description for
failure_reason
field in Transfer endpoints
- Make
repayment_id
required in/transfer/repayment/return/list
endpoint
- Update description for legal name field in
BankTransferUser
- Update descriptions for
/transfer/repayment/list
and/transfer/repayment/return/list
endpoints
- Remove
scheme_automatic_downgrade
from/payment_initiation/payment/create
- Update description for
/sandbox/transfer/sweep/simulate
endpoint
- Refactor account subtype enums for greater specificity. This has no changes to the API but is a major semver change for Python, Node, Go, and Java client library interfaces to the AccountSubtype object within account filtering contexts in
/link/token/create
. TheAccountSubtype
namespace in this context is now prefixed with the AccountType. (Example for Node: Old:AccountSubtype.checking
New:DepositoryAccountSubtype.checking
)
- Update description for
datetime
andauthorized_datetime
fields in Transactions endpoints
- Make
sweep_id
/sweep_amount
fields on Transfer Event nullable
- Set
institution_status
to be nullable inInstitutionsGetResponse
- Update external docs URLs for Transfer and Bank Transfer endpoints
- Update description for
ach_return_code
field in Transfer endpoints
- Add
join_date
to/application/get
and/item/application/list
- Remove
created_at
from/application/get
- Updated various description fields for Income
- Add
employment
as an available product in Product array.
- Updating to OAS 2020-09-14_1.62.1
- Added a release step to the
Makefile
to purge previously released version of plaid-ruby in the current release.
- Updating to OAS 2020-09-14_1.61.0
- Updating to OAS 2020-09-14_1.58.1
- Updating to OAS 2020-09-14_1.54.2
- Updating to OAS 2020-09-14_1.46.1
- Updating to OAS 2020-09-14_1.44.0
- Updating to OAS 2020-09-14_1.40.3
- Updating to OAS 2020-09-14_1.36.4
- Updating to OAS 2020-09-14_1.34.1
- Fixed an issue with enums in this library. The library is supposed to be able to gracefully handle new enum values being returned from endpoints. Previously, if there were new enum values endpoint calls would fail.
Updating to OAS 2020-09-14_1.33.0.
Updating to OAS 2020-09-14_1.31.1.
Updating to OAS 2020-09-14_1.26.1.
The official release of the plaid-ruby
generated library. Refer to the beta migration guide for tips on migrating from older version of the libraries.
This particular version is pinned to OpenAPI version 2020-09-14_1.20.6
.
Generated from OAS version 2020-09-14_1.16.4. See full changelog here.
See full changelog here.
- Remove validation for
maxProperties
due to generator bug.
Type fixes, see full changelog here.
This version represents a transition in how we maintain our external client libraries. We are now using an API spec written in OpenAPI 3.0.0
and running our definition file through OpenAPITool's ruby
generator.
The minimum required ruby version is 2.4.0.
Ruby Migration Guide:
From:
client = Plaid::Client.new(env: :sandbox,
client_id: client_id,
secret: secret)
To:
configuration = Plaid::Configuration.new
configuration.server_index = Plaid::Configuration::Environment["sandbox"]
configuration.api_key["PLAID-CLIENT-ID"] = ENV["PLAID_RUBY_CLIENT_ID"]
configuration.api_key["PLAID-SECRET"] = ENV["PLAID_RUBY_SECRET"]
configuration.api_key["Plaid-Version"] = "2020-09-14"
api_client = Plaid::ApiClient.new(
configuration
)
client = Plaid::PlaidApi.new(api_client)
All endpoint requests now take a request model and the functions have been renamed to include _
.
From:
response = client.auth.get(access_token)
To:
auth_get_request = Plaid::AuthGetRequest.new
auth_get_request.access_token = access_token
or
auth_get_request = Plaid::AuthGetRequest.new({:access_token => access_token})
response = client.auth_get(auth_get_request)
From:
begin
client.auth.get(auth_get_request)
rescue Plaid::PlaidAPIError => e
raise e if e.error_code != 'PRODUCT_NOT_READY'
sleep 1
end
To:
begin
client.auth_get(auth_get_request)
rescue Plaid::ApiError => e
json_response = JSON.parse(e.response_body)
if json_response["error_code"] != "PRODUCT_NOT_READY"
end
- Add support for
options
to/payment_initiation/payment/create
- Add Standing Orders support to Payment Initiation
- Add
update_type
toItem
model.
- Add support for providing a payment initiation schedule
- Add back the (now deprecated)
/item/public_token/create
endpoint - Add back the (now deprecated)
/payment_initiation/payment/token/create
endpoint
BREAKING CHANGES:
- Update minimum required Ruby version to 2.4
- The library has been pinned to the '2020-09-14' API release. Visit the docs to see what changed.
- the
/item/public_token/create
endpoint has been disabled in favor of the /link/token/create endpoint - The
/item/add_token/create endpoint
has been disabled in favor of the /link/token/create - The
/payment_initiation/payment/token/create
endpoint has been disabled in favor of the /link/token/create endpoint - The
/item/remove
endpoint will no longer return aremoved
boolean. - The
/institutions/get
,/institutions/get_by_id
, and/institutions/search
now requirecountry_codes
to be passed in.
- Add support for Link Token get endpoint (#301)
link/token/get
- Add
merchant_name
toTransaction
(#294)
BREAKING CHANGES:
- Removes the public key as input to
Client
. The public key is no longer needed by the API. (#287) - Add link/token/create support (#293)
- Add support for more options (
override_username
,override_password
) in the/sandbox/public_token/create
endpoint (219)
- Add support for optional user fields for
/item/add_token/create
endpoint (278) - Add support for credit card liabilities (286)
BREAKING CHANGES:
RATE_LIMIT_EXCEEDED
Plaid error types will be correctly mapped toRateLimitExceededError
(285)INSTITUTION_ERROR
Plaid error types will be correctly mapped toInstitutionError
(275)- Enable payment recipient to be created with BACS (288)
- Adds support for
/sandbox/item/set_verification_status
- Removes support for deprecated
/item/access_token/update_version
endpoint
BREAKING CHANGES:
- Removes
client.item.update_version
- Add client_user_id to Item add token endpoint (#274)
- Add support for Item add token endpoint (BETA) (#269)
/item/add_token/create
- Add transaction_code to Transaction class (#264)
- Add OAuth support to /institutions endpoints (#261)
- Add support for transactions refresh product (#258)
/transactions/refresh
- Add support for deposit switch product (#251)
- Add support for generic processor token (#256)
- Add support for webhook verification (#249)
- Add support for new UK Payment Initiation product (#246)
/payment_initiation/recipient/create
/payment_initiation/recipient/get
/payment_initiation/recipient/list
/payment_initiation/payment/create
/payment_initiation/payment/token/create
/payment_initiation/payment/get
/payment_initiation/payment/list
- Add
consent_expiration_time
to the Item interface (#247)
- Add support for new Ocrolus Partnership
- Update Assets schema for international address support
- Add binding for the new liabilities product
- Deprecate direct integration as it is no longer supported
- Add bindings for the new investments product.
- Add support for 2019-05-29 API version
- Remove unnecessary log line
- Add support for include_institution_data to /institutions/search endpoint.
- Add support for include_institution_data to /institutions/get endpoint.
- Add support for include_institution data to /institutions/get_by_id endpoint.
- Fix error models to support assets-related errors.
- Assets + Insights reports
- Add bindings for the new assets product.
- Use
Plaid-Version
header to request the certain compatible API version. - Change Auth-related data structures to conform to the API.
- Include currency-related fields for transaction and account objects.
- Introduce true response objects instead of deep nested hashes. Any of the
three syntaxes can be used interchangeably for any API response:
response['foo']['bar']
,response[:foo][:bar]
, orresponse.foo.bar
. - Add Dwolla and Apex products.
- Make
/item/remove
the primary Item removal endpoint - Add #options parameter to
/institutions/get
- Handle network errors with
PlaidServerError
- Refactored the entire library to support Plaid's new API. Use the transition guide to update your integration. Version 3.x.x of this gem is mirrored at plaid-legacy.
- Add
/institutions/all
and/institutions/all/search
endpoints, see UPGRADING.md
- Add
Transaction#reference_number
(@ericbirdsall). - Fix webhook codes and add risk and income webhooks.
- Documentation fixes (@ishmael).
- Fix
Transaction#to_s
behavior (@michel-tricot). - PATCH
/:product/step
flow. - Use the same client in
User#upgrade
(@betesh). - Webhook object (@zshannon).
processor_token
access inUser.exchange_token
(@gylaz).- Raise
ServerError
in case server returned an empty response body.
- Use
~> 1.0
spec for multi_json dependency. - Support
stripe_bank_account_token
inUser.exchange_token
.
- Use
:production
instead of:api
to signify production environment inPlaid::Client#env=
. User#mfa_step
allows to specify options now (thanks @gcweeks).- Implemented
User#update_webhook
.
- Rewrite everything.