Direct Express 数据 API：福利入账、交易与转账

Fifth Third Bank · 银行 4.6 ★

Direct Express® Mobile 是 Fifth Third Bank 推出的 Android 应用，面向通过 Direct Express Debit Mastercard 领取社会保障金（Social Security）、补充保障收入（SSI）、退伍军人事务部（VA）补偿及其他美国财政部联邦福利付款的受益人。此版本服务卡号以 533248 开头的卡片，以 511563 开头的旧卡则由另一款应用负责。持卡人凭卡片信息和社会保障号后四位注册，之后用用户 ID 和密码登录，还可选择短信验证码以及本地口令或生物识别解锁。首页显示最近一笔联邦福利入账和待入账金额，并配有卡片状态与锁卡控制。用户可以查看消费和 ATM 取现记录，下载 CSV 或 PDF 历史明细，按类别查看支出，并查找免手续费的 ATM。应用还支持向已绑定的银行账户转账、入账与消费提醒、无纸化账单偏好设置、可选标准或加急配送的补卡，以及联系地址更新。它服务于美国没有银行账户或银行服务不足的福利受益人，在 Google Play 上有 4.64 的评分，共 196,032 条评价。

联邦福利入账记录以 lastDepositedAmount 和 lastDepositedDate 表示最近一笔已入账付款，以 pendingDepositedAmount 和 pendingDepositCount 表示待入账金额与笔数，从而区分已到账和仍待处理的资金。同一份卡片摘要还把这些金额关联到 cardId、cardStatus 和 cardIsLocked。在持卡人授权下，福利咨询师可以把已入账和待入账金额与预期发放日对账，客服流程也能区分这是入账问题，还是卡片被锁定或需要补卡。

交易记录携带 transactionId、transactionType、transactionDate、amount 和 pending；CSV 与 PDF 导出再加上 fileName 和 rowCount，便于对账。支出汇总通过 period 和 totalAmount 标明所选期间及其总支出，各类别则分别列出 categoryId、amount 和 percent。ATM 记录把 lat、lng、distanceMeters 与 surchargeFree、network 结合在一起，帮助社会服务团队找到无需承担网外手续费的附近取现点。

卡到银行记录把由 routingNumber、accountType 和脱敏的 accountNumberLast4 描述的收款账户，与 transferId、status 和 confirmationTimeStamp 关联起来。提醒历史与偏好区分入账、低余额、highDollarPurchase、foreignTransaction 和 invalidPIN；文档偏好再加上 eDeliveryEnabled 和 paperStmt。这些字段支撑经授权的预算管理、付款对账和持卡人支持类集成。openData Studio 将这些入账、交易、取现网点与卡片管理数据转化为可调用的开放数据，供上述经授权的集成使用。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

登录会话
POST /v1/cardholder-sessions osint
使用用户 ID、密码和 RSA 设备画像开启持卡人会话，返回 sessionToken 和 refreshToken，供后续卡片与资料请求使用。
认证方式：无需认证。请求体包含 userId、password 和 RSA Adaptive Authentication 设备画像；签发的会话令牌用于认证后续的持卡人请求。
- userId
- password
- deviceProfile
- sessionToken
- refreshToken
- maskedUserId
- multiCard
```
POST /v1/cardholder-sessions HTTP/1.1
Content-Type: application/json

{
  "userId": "example_cardholder",
  "password": "<example-password>",
  "deviceProfile": "<example-device-profile>"
}
```
```
{
  "sessionToken": "<example-session-token>",
  "refreshToken": "<example-refresh-token>",
  "userId": "example_cardholder",
  "maskedUserId": "exa***der",
  "multiCard": true
}
```
持卡人基本信息
GET /v1/benefit-cards/overview openbanking
加载首页卡片摘要，包括卡片昵称、卡号后四位、锁卡标志、最近一笔联邦福利入账和待入账金额。卡片状态包括 DEBIT、IN_TRANSIT、PENDING_PIN_RESET、INACTIVE 和 CLOSED。
认证方式：持卡人登录时签发的 Bearer 会话令牌。
- cardId
- cardNickname
- last4CardDigit
- cardStatus
- cardIsLocked
- lastDepositedAmount
- lastDepositedDate
- pendingDepositedAmount
- pendingDepositCount
```
GET /v1/benefit-cards/overview HTTP/1.1
Authorization: Bearer <example-session-token>
Accept: application/json
```
```
{
  "cardId": "card_example_01",
  "cardNickname": "Benefits card",
  "last4CardDigit": "0000",
  "cardStatus": "DEBIT",
  "cardIsLocked": false,
  "lastDepositedAmount": 943.0,
  "lastDepositedDate": "2026-10-08",
  "pendingDepositedAmount": 0.0,
  "pendingDepositCount": 0
}
```

搜索交易

POST /v1/benefit-cards/activity/query openbanking

按日期范围和 transactionType 分页查询卡片活动，涵盖消费、费用、入账以及客服调整。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

cardId
transactionType
fromDate
toDate
transactionId
transactionDate
amount
description
pending
totalCount

POST /v1/benefit-cards/activity/query HTTP/1.1
Authorization: Bearer <example-session-token>
Content-Type: application/json

{
  "cardId": "card_example_01",
  "transactionType": "purchases",
  "fromDate": "2026-09-01",
  "toDate": "2026-10-23",
  "page": 0,
  "pageSize": 25
}

{
  "items": [
    {
      "transactionId": "transaction_example_01",
      "transactionType": "purchases",
      "transactionDate": "2026-10-12",
      "amount": -28.41,
      "description": "EXAMPLE GROCERY STORE",
      "pending": false
    }
  ],
  "page": 0,
  "totalCount": 41
}

导出交易

POST /v1/benefit-cards/activity/files openfinance

为所选日期准备持卡人交易历史的 CSV 或 PDF 下载文件。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

cardId
format
fromDate
toDate
downloadUrl
fileName
rowCount

POST /v1/benefit-cards/activity/files HTTP/1.1
Authorization: Bearer <example-session-token>
Content-Type: application/json

{
  "cardId": "card_example_01",
  "format": "csv",
  "fromDate": "2026-01-01",
  "toDate": "2026-10-23"
}

{
  "downloadUrl": "/v1/benefit-cards/activity/files/export_example_01.csv",
  "format": "csv",
  "fileName": "example-card-transactions.csv",
  "rowCount": 186
}

按类别统计支出

GET /v1/benefit-cards/spending/groups openfinance

返回所选期间的支出分析明细，包括各类别合计金额及各类别所占百分比。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

cardId
period
totalAmount
categories
categoryId
label
amount
percent

GET /v1/benefit-cards/spending/groups?cardId=card_example_01&period=2026-09 HTTP/1.1
Authorization: Bearer <example-session-token>
Accept: application/json

{
  "period": "2026-09",
  "totalAmount": 412.18,
  "categories": [
    {
      "categoryId": "grocery",
      "label": "Groceries",
      "amount": 186.4,
      "percent": 45.2
    },
    {
      "categoryId": "atm",
      "label": "ATM withdrawals",
      "amount": 80.0,
      "percent": 19.4
    }
  ]
}

附近 ATM

GET /v1/cash-access/nearby opendata

查找附近的取款机，并区分免手续费的 Allpoint 网内网点与可能加收手续费的网外取款机。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

lat
lng
surchargeFree
atmId
name
distanceMeters
network

GET /v1/cash-access/nearby?lat=38.9072&lng=-77.0369&surchargeFree=true HTTP/1.1
Authorization: Bearer <example-session-token>
Accept: application/json

{
  "atms": [
    {
      "atmId": "atm_example_01",
      "name": "Example cash location",
      "lat": 38.9091,
      "lng": -77.043,
      "distanceMeters": 640,
      "surchargeFree": true,
      "network": "Allpoint"
    }
  ]
}

发起卡到银行转账

POST /v1/benefit-cards/bank-payouts openbanking

通过 ACH 把卡内剩余资金转入已绑定的支票或储蓄账户，并返回转账确认信息。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

cardId
amount
routingNumber
accountNumber
accountType
transferId
status
confirmationTimeStamp

POST /v1/benefit-cards/bank-payouts HTTP/1.1
Authorization: Bearer <example-session-token>
Content-Type: application/json

{
  "cardId": "card_example_01",
  "amount": 200.0,
  "routingNumber": "<example-routing-number>",
  "accountNumber": "<example-account-number>",
  "accountType": "checking"
}

{
  "transferId": "transfer_example_01",
  "amount": 200.0,
  "status": "PENDING",
  "confirmationTimeStamp": "2026-10-23T15:12:04Z"
}

更新绑定银行账户

PUT /v1/benefit-cards/payout-destination openbanking

创建或替换卡到银行转账所用的 ACH 收款账户，包括路由号码、账号以及支票或储蓄账户类型。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

bankName
routingNumber
accountNumber
accountType
accountNumberLast4
verified

PUT /v1/benefit-cards/payout-destination HTTP/1.1
Authorization: Bearer <example-session-token>
Content-Type: application/json

{
  "bankName": "Example Bank",
  "routingNumber": "<example-routing-number>",
  "accountNumber": "<example-account-number>",
  "accountType": "checking"
}

{
  "bankName": "Example Bank",
  "routingNumber": "<example-routing-number>",
  "accountNumberLast4": "0000",
  "accountType": "checking",
  "verified": true
}

提醒历史

GET /v1/cardholder-notices opendata

分页返回应用内提醒历史，涵盖入账、低余额、大额消费、境外交易和 PIN 输入错误。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

alertId
alertType
message
amount
createdAt

GET /v1/cardholder-notices?page=0&pageSize=20 HTTP/1.1
Authorization: Bearer <example-session-token>
Accept: application/json

{
  "items": [
    {
      "alertId": "alert_example_01",
      "alertType": "deposit",
      "message": "Federal benefit deposit posted",
      "amount": 943.0,
      "createdAt": "2026-10-08T08:04:11Z"
    }
  ]
}

更新提醒偏好

PUT /v1/cardholder-notices/preferences opendata

保存入账、低余额、大额消费、境外交易和 PIN 输入错误的提醒偏好，包括金额阈值。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

depositAlert
lowBalanceAlert
lowBalanceAmount
highDollarPurchase
highDollarAmount
foreignTransaction
invalidPIN

PUT /v1/cardholder-notices/preferences HTTP/1.1
Authorization: Bearer <example-session-token>
Content-Type: application/json

{
  "depositAlert": true,
  "lowBalanceAlert": true,
  "lowBalanceAmount": 50.0,
  "highDollarPurchase": true,
  "highDollarAmount": 200.0,
  "foreignTransaction": true,
  "invalidPIN": true
}

{
  "depositAlert": true,
  "lowBalanceAlert": true,
  "lowBalanceAmount": 50.0,
  "highDollarPurchase": true,
  "highDollarAmount": 200.0,
  "foreignTransaction": true,
  "invalidPIN": true
}

电子账单设置
GET /v1/benefit-cards/delivery-options openfinance
读取电子账单开通状态、纸质账单偏好、相关月费和送达邮箱，用于账单设置页面。
认证方式：持卡人登录时签发的 Bearer 会话令牌。
- eDeliveryEnabled
- paperStmt
- monthlyFee
- emailAddress
```
GET /v1/benefit-cards/delivery-options HTTP/1.1
Authorization: Bearer <example-session-token>
Accept: application/json
```
```
{
  "eDeliveryEnabled": true,
  "paperStmt": false,
  "monthlyFee": 0.0,
  "emailAddress": "<example-email>"
}
```

更新纸质账单偏好

PUT /v1/benefit-cards/statement-preferences openfinance

开启或关闭邮寄月度账单，并记录相应的电子账单偏好。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

paperStmt
eDeliveryEnabled
status

PUT /v1/benefit-cards/statement-preferences HTTP/1.1
Authorization: Bearer <example-session-token>
Content-Type: application/json

{
  "paperStmt": false,
  "eDeliveryEnabled": true
}

{
  "paperStmt": false,
  "eDeliveryEnabled": true,
  "status": "UPDATED"
}

补发卡片

POST /v1/benefit-cards/replacement-orders openbanking

订购补发借记卡，可选标准或加急配送，并返回在途状态、配送时限和 UPS 追踪编号。

认证方式：持卡人登录时签发的 Bearer 会话令牌。请求体还会再次确认 last4SSN、cvv 和 expDate。

cardId
cardNumberLast4
last4SSN
cvv
expDate
expedite
mailingAddress
replacementId
cardStatus
minStandardShippingDays
maxStandardShippingDays
upsTrackingNumber

POST /v1/benefit-cards/replacement-orders HTTP/1.1
Authorization: Bearer <example-session-token>
Content-Type: application/json

{
  "cardId": "card_example_01",
  "cardNumberLast4": "0000",
  "last4SSN": "<example-ssn-last-four>",
  "cvv": "<example-cvv>",
  "expDate": "08/27",
  "expedite": false,
  "mailingAddress": {
    "line1": "100 Example Ave",
    "city": "Washington",
    "state": "DC",
    "postalCode": "20001"
  }
}

{
  "replacementId": "replacement_example_01",
  "cardStatus": "IN_TRANSIT",
  "expedite": false,
  "minStandardShippingDays": 7,
  "maxStandardShippingDays": 10,
  "upsTrackingNumber": "<example-ups-tracking-number>"
}

校验邮寄地址

POST /v1/postal-addresses/check opendata

保存前使用 USPS 规范化校验邮寄地址，并为地址确认提示标记无效地址。

认证方式：持卡人登录时签发的 Bearer 会话令牌。同一地址校验也支持定期的地址确认提示。

line1
city
state
postalCode
valid
normalized
badAddress

POST /v1/postal-addresses/check HTTP/1.1
Authorization: Bearer <example-session-token>
Content-Type: application/json

{
  "line1": "100 Example Ave",
  "city": "Washington",
  "state": "DC",
  "postalCode": "20001"
}

{
  "valid": true,
  "normalized": {
    "line1": "100 EXAMPLE AVE",
    "city": "WASHINGTON",
    "state": "DC",
    "postalCode": "20001"
  },
  "badAddress": false
}

联系信息

GET /v1/cardholder-profile/contact osint

读取资料页和地址编辑页所用的电子邮箱、手机号码、邮寄地址以及联系信息授权选项。

认证方式：持卡人登录时签发的 Bearer 会话令牌。

emailAddress
mobileNumber
mailingAddress
optInContactInfo

GET /v1/cardholder-profile/contact HTTP/1.1
Authorization: Bearer <example-session-token>
Accept: application/json

{
  "emailAddress": "<example-email>",
  "mobileNumber": "+1-202-555-0100",
  "mailingAddress": {
    "line1": "100 Example Ave",
    "city": "Washington",
    "state": "DC",
    "postalCode": "20001"
  },
  "optInContactInfo": true
}

数据类别

余额
联邦福利入账
交易
ATM 网点
ACH 转账
提醒
账单
卡片状态

数据使用场景与案例

SSA 入账对账
福利咨询师在每个发放日从 person/info 拉取 lastDepositedAmount、lastDepositedDate 和 pendingDepositedAmount，与 SSA / VA 的发放日历比对，在受益人打来电话之前就标出漏发的入账。
老年人防欺诈锁卡与消费提醒
家庭成员或成人保护服务（APS）的工作流在提醒流上监测 cardIsLocked、highDollarPurchase、foreignTransaction 和 invalidPIN，当 SSI 卡出现大额或境外刷卡时可以冻结这张实体卡。
免手续费 ATM 路线规划
社会服务机构把 atmsNearUser 返回的 surchargeFree=true（Allpoint / 网内）网点绘制成地图，让没有银行账户的受益人取现时避开定位器文案所提示的网外手续费。
卡内余款转入银行账户
预算机器人读取已绑定的 routingNumber / accountNumberLast4 / accountType，再记录发起转账返回的 transferId 和 confirmationTimeStamp，让剩余的联邦资金进入支票账户，而不是留在预付卡上。

常见问题

哪些 Direct Express 持卡人数据可以支持福利付款核对？

示例涵盖已入账和待入账的联邦福利、卡片状态与锁定状态、交易记录、CSV/PDF 导出、按类别支出、附近 ATM、ACH 收款账户与转账、提醒、账单设置、补卡配送及联系方式。在持卡人授权下，福利支持流程可以结合 lastDepositedAmount、lastDepositedDate、pendingDepositedAmount 和 pendingDepositCount，与预期发放日期进行核对。提醒记录还提供 alertType、amount 和 createdAt；偏好包括 lowBalanceAmount、highDollarAmount、foreignTransaction 和 invalidPIN。这些字段支持付款检查和通知，同时将待入账款项与已到账资金区分开。

持卡人身份验证是如何进行的？

注册使用卡片信息和社会保障号后四位。登录时，用户 ID 和密码与 RSA Adaptive Authentication 设备画像结合，并可能需要短信一次性验证码。后续请求使用签发的会话令牌；示意示例中以 Bearer 令牌表示。设备口令或生物识别可在本地解锁应用。身份验证示例中均为占位符，不是可用的凭据。

哪些字段支持 ATM 选址和卡到银行的对账？

ATM 记录包含 lat、lng、distanceMeters、network 和 surchargeFree，用于识别附近的网内网点。ACH 收款账户记录包含 routingNumber、accountType 和 accountNumberLast4；转账确认再加上 transferId、amount、status 和 confirmationTimeStamp。访问金融或身份类记录须获得持卡人授权。

这是美国财政部或 Fifth Third 官方公开的开发者 API 吗？

不是。本页的路径以及请求/响应值是对应用数据的合成示意，并非官方开发者端点，也不是无需认证的财政部服务。金融和联系方式记录均属于持卡人本人。openData Studio 展示它们的字段名和结构，供集成规划使用，不公布私有服务地址。

与 Direct Express® Mobile 相似的应用

Netspend — Netspend 提供可充值预付借记卡和无需信用审查的借记账户，可通过直接存款接收社会保障金及其他联邦政府福利。
GO2bank — GO2bank 是 Green Dot Bank 的手机银行账户；在有工资或政府福利直接存款时可免月费，政府福利最多可提前四天到账。
Walmart MoneyCard — Walmart MoneyCard 是可充值借记卡，带储蓄和可选透支保护，符合条件的直接存款可使政府福利最多提前四天到账。
ACE Elite — ACE Elite Visa 预付借记卡可在 ACE Cash Express 门店充值，并接受工资、政府福利或退税的直接存款。
PayPal — PayPal 直接存款可将工资或政府付款自动打入 PayPal 余额，再用 PayPal Debit Mastercard 在 Mastercard 受理商户消费。
Serve — Serve 提供无需信用审查、无最低余额的 Visa 借记卡和预付卡，并在雇主于发薪日前报送工资时提供免费提前直接存款。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Direct Express 数据 API：福利入账、交易与转账

应用截图

API 端点一览

登录会话

持卡人基本信息

搜索交易

导出交易

按类别统计支出

附近 ATM

发起卡到银行转账

更新绑定银行账户

提醒历史

更新提醒偏好

电子账单设置

更新纸质账单偏好

补发卡片

校验邮寄地址

联系信息

数据类别

数据使用场景与案例

SSA 入账对账

老年人防欺诈锁卡与消费提醒

免手续费 ATM 路线规划

卡内余款转入银行账户

常见问题

与 Direct Express® Mobile 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

Ajaib: Stock, Crypto, US Stock

AndroMoney

Angel One: Stocks, Mutual Fund

相关主题

需要集成这个 App 的数据 API？

Direct Express 数据 API：福利入账、交易与转账

应用截图

API 端点一览

登录会话

持卡人基本信息

搜索交易

导出交易

按类别统计支出

附近 ATM

发起卡到银行转账

更新绑定银行账户

提醒历史

更新提醒偏好

电子账单设置

更新纸质账单偏好

补发卡片

校验邮寄地址

联系信息

数据类别

数据使用场景与案例

SSA 入账对账

老年人防欺诈锁卡与消费提醒

免手续费 ATM 路线规划

卡内余款转入银行账户

常见问题

相关应用

与 Direct Express® Mobile 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

Ajaib: Stock, Crypto, US Stock

AndroMoney

Angel One: Stocks, Mutual Fund

相关主题

需要集成这个 App 的数据 API？