Xoom 数据 API：报价、收款人与转账

PayPal, Inc. · 支付

《Xoom: Send Money & Transfer》是 PayPal 的跨境汇款安卓客户端，面向从美国向海外家人汇出的用户：收款侧支持现金提取、银行入账、手机钱包与预付话费充值。发款人选择走廊与打款方式，用借记卡、银行账户或已绑定的 PayPal 钱包付款（银行要求额外核验时，结账会走 3-D Secure 加强验证），并在活动列表上跟踪转账，可选择短信状态提醒。同一登录壳还包含已保存收款人、Quick Send / 再汇一笔、账单代缴与充值，以及 PayPal 统一登录 / 通行密钥。它面向从美国向墨西哥、印度、巴西、越南、印尼及其他收款市场汇款的家庭用户，竞品包括 Remitly、Wise、西联与 MoneyGram。

走廊报价在结账前锁定 sendAmount、receiveAmount 与 fxRate；活动列表按笔分页 invoiceId、totalAmount 与 statusBadge。已保存付款工具给出 paymentSourceId、accountType 与 walletType，账务可据此对齐扣款的卡或银行账户。

收款人记录把打款联系人与 latestTransfer 连在一起；确认单补上 transactionNumber 与 channelReturn 供现金提取合作方使用。走廊监控、客服目录与运营看板消费这些对象；openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

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

读取已登录 Xoom 用户

GET /v1/senders/self osint

统一登录后返回已登录发款人：合同号、邮箱、KYC 资料以及是否已有历史转账，供首页壳与条款门槛渲染。

认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。

id
contractId
primaryEmailAddress
status
termsOfServiceAccepted
transactionsFound
firstName
lastName
dateOfBirth
mobileNumber
address1
city
subdivision
postalCode
nationality

GET /v1/senders/self HTTP/1.1
Authorization: Bearer <access_token>
X-Request-Timestamp: 1760947200
X-Client-Timezone: America/Los_Angeles
X-Device-Metadata-Id: <device_id>
Accept: application/json

{
  "id": "usr_4c91e2",
  "contractId": "ct_9a10",
  "primaryEmailAddress": "[email protected]",
  "status": "ACTIVE",
  "termsOfServiceAccepted": true,
  "transactionsFound": true,
  "profile": {
    "firstName": "Maria",
    "lastName": "Santos",
    "dateOfBirth": "1991-04-18",
    "mobileNumber": "+14155550123",
    "address1": "2211 N 1st St",
    "city": "San Jose",
    "subdivision": "CA",
    "postalCode": "95131",
    "nationality": "US"
  }
}

分页转账活动列表

GET /v1/sends/history openbanking

分页返回发款人的转账活动流：发票号、金额、状态徽章与收款人联系人，支撑活动 / 跟踪转账界面。

认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。

totalItems
totalPages
invoiceId
formattedCreatedDate
summaryLine1
summaryLine2
totalAmount
statusBadge
name
initials

GET /v1/sends/history?page=0&size=20 HTTP/1.1
Authorization: Bearer <access_token>
X-Request-Timestamp: 1760947200
X-Client-Timezone: America/Los_Angeles
Accept: application/json

{
  "totalItems": 42,
  "totalPages": 3,
  "items": [
    {
      "invoiceId": "INV-884120",
      "formattedCreatedDate": "Oct 12, 2026",
      "summaryLine1": "Sent to Ana Lopez",
      "summaryLine2": "Bank deposit · Mexico",
      "totalAmount": "250.00 USD",
      "statusBadge": { "text": "Delivered", "type": "SUCCESS" },
      "contact": { "name": "Ana Lopez", "initials": "AL", "profileColorGroup": 2 }
    }
  ]
}

读取已保存收款人
GET /v1/payees/{payeeId} opendata
加载单个已保存收款人的资料、最近一笔转账与打款方式，供「我的收款人」卡片与再汇一笔使用。
认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。
- id
- modified
- firstName
- lastName
- latestTransfer
- transactionNumber
- amountTarget
- recipientId
- disbursementInfos
```
GET /v1/payees/rcp_77ab HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "id": "rcp_77ab",
  "modified": 1760900000000,
  "profile": {
    "firstName": "Ana",
    "lastName": "Lopez"
  },
  "latestTransfer": {
    "id": "tr_12091",
    "transactionNumber": "884120",
    "amountTarget": "RECEIVE",
    "recipientId": "rcp_77ab"
  },
  "disbursementInfos": [
    {
      "type": "BANK_DEPOSIT",
      "countryCode": "MX"
    }
  ]
}
```
按编号读取转账
GET /v1/transfers/{transferId} openbanking
为状态 / 跟踪界面解析单笔转账：交易号、收款人与金额方向。
认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。
- id
- transactionNumber
- recipientId
- amountTarget
- status
```
GET /v1/transfers/tr_12091 HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "id": "tr_12091",
  "transactionNumber": "884120",
  "recipientId": "rcp_77ab",
  "amountTarget": "RECEIVE",
  "status": "DELIVERED"
}
```

创建汇款报价

POST /v1/corridor-quotes openfinance

创建走廊汇款并返回选中报价：发/收款金额、手续费、汇率与打款类型，供汇款计算器在结账前锁定。

认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。

id
orderItemId
sendAmount
receiveAmount
fee
fxRate
discountAmount
total
target
paymentType
disbursementType
rawSendAmount
rawReceiveAmount
countryCode
selectedCurrency

POST /v1/corridor-quotes HTTP/1.1
Authorization: Bearer <access_token>
X-Transfer-Intent-Id: ti_55c
Content-Type: application/json

{
  "sourceCountry": { "countryCode": "US", "selectedCurrency": "USD" },
  "destinationCountry": { "countryCode": "MX", "selectedCurrency": "MXN" },
  "quote": { "sourceAmount": 250.00, "targetAmount": null },
  "disbursementType": "BANK_DEPOSIT",
  "paymentType": "DEBIT_CARD",
  "recipientId": "rcp_77ab"
}

{
  "id": "rm_3012",
  "orderItemId": "oi_88c1",
  "quotes": {
    "selected": {
      "sendAmount": "250.00",
      "receiveAmount": "4301.25",
      "fee": "2.99",
      "fxRate": "17.205",
      "discountAmount": "0.00",
      "total": "252.99",
      "target": "MXN",
      "paymentType": "DEBIT_CARD",
      "disbursementType": "BANK_DEPOSIT",
      "rawSendAmount": 250.0,
      "rawReceiveAmount": 4301.25
    }
  },
  "sourceCountry": { "countryCode": "US", "selectedCurrency": "USD" }
}

创建结账订单

POST /v1/checkouts openfinance

用汇款项与付款来源打开结账订单，返回锁定的报价金额、汇率对、收款联系人与送达预估，供复核界面使用。

认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。

id
sendAmount
receiveAmount
feeAmount
totalCost
currencyCode
rawAmount
exchangeRate
base
target
rate
paymentType
amountTarget
durationInMinutes
fullName

POST /v1/checkouts HTTP/1.1
Authorization: Bearer <access_token>
X-Device-Metadata-Id: <device_id>
Content-Type: application/json

{
  "itemRequest": { "id": "oi_88c1" },
  "paymentSource": { "paymentSourceId": "ps_debit_19" },
  "fingerprintMetadata": { "fingerprintId": "fp_aa12" }
}

{
  "id": "ck_6f20",
  "item": {
    "id": "oi_88c1",
    "quotes": {
      "selected": {
        "sendAmount": { "amount": "250.00", "currencyCode": "USD", "rawAmount": "250.00" },
        "receiveAmount": { "amount": "4301.25", "currencyCode": "MXN", "rawAmount": "4301.25" },
        "feeAmount": { "amount": "2.99", "currencyCode": "USD", "rawAmount": "2.99" },
        "totalCost": { "amount": "252.99", "currencyCode": "USD", "rawAmount": "252.99" },
        "exchangeRate": { "base": "USD", "target": "MXN", "rate": "17.205" },
        "paymentType": "DEBIT_CARD",
        "amountTarget": "SEND"
      }
    },
    "destination": {
      "id": "dst_11",
      "type": "BANK_DEPOSIT",
      "country": { "code": "MX", "name": "Mexico" },
      "contact": { "profile": { "fullName": "Ana Lopez", "country": { "code": "MX", "name": "Mexico" } } }
    }
  },
  "deliveryEstimate": {
    "durationInMinutes": 30,
    "timeExpression": { "label": "ETA", "text": "Minutes" }
  },
  "fundingPlan": {
    "selectedFundingOption": {
      "fundingOptionPortions": []
    }
  },
  "user": { "profile": { "fullName": "Maria Santos" } }
}

读取结账订单

GET /v1/checkouts/{checkoutId} openfinance

在复核界面恢复时重新加载进行中的结账订单：授权类型、送达预估与选中报价。

认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。

id
authorizationDetails
authorizationType
durationInMinutes
sendAmount
receiveAmount
exchangeRate
rate

GET /v1/checkouts/ck_6f20 HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "id": "ck_6f20",
  "authorizationDetails": { "authorizationType": "THREE_DS" },
  "deliveryEstimate": { "durationInMinutes": 30 },
  "item": {
    "id": "oi_88c1",
    "quotes": {
      "selected": {
        "sendAmount": { "amount": "250.00", "currencyCode": "USD" },
        "receiveAmount": { "amount": "4301.25", "currencyCode": "MXN" },
        "exchangeRate": { "base": "USD", "target": "MXN", "rate": "17.205" }
      }
    }
  }
}

授权结账订单
POST /v1/checkouts/{checkoutId}/confirm openbanking
在复核界面提交确认并附带设备指纹；需要额外鉴权时响应链接含 PayPal step-up URL。
认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头；确认调用还携带设备指纹头。会话以刷新令牌轮换。
- links
- rel
- href
```
POST /v1/checkouts/ck_6f20/confirm HTTP/1.1
Authorization: Bearer <access_token>
X-Device-Fingerprint: <fingerprint>
Content-Type: application/json

{
  "authorizationEvent": { "type": "CONFIRM" },
  "fingerprint": { "fingerprintId": "fp_aa12" }
}
```
```
{
  "links": [
    { "rel": "stepUp", "href": "/v1/checkouts/ck_6f20/step-up" }
  ]
}
```

列出付款方式

GET /v1/funding-sources openbanking

列出发款人已保存的付款工具：卡、银行账户与钱包类型，供选择本笔转账的扣款方式。

认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。

paymentSourceId
type
accountType
walletType
nameOnAccount
currencyCode
issuingCountryCode
expirationMonth
expirationYear
expired
onHold
verificationNeeded
nickname
paymentOptions

GET /v1/funding-sources HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "items": [
    {
      "paymentSourceId": "ps_debit_19",
      "type": "CARD",
      "accountType": "DEBIT",
      "walletType": "STANDARD_WALLET",
      "nameOnAccount": "MARIA SANTOS",
      "currencyCode": "USD",
      "issuingCountryCode": "US",
      "expirationMonth": 8,
      "expirationYear": 2028,
      "expired": false,
      "onHold": false,
      "verificationNeeded": false,
      "nickname": "Visa 4242"
    }
  ],
  "paymentOptions": [
    { "type": "BANK" },
    { "type": "CARD" }
  ]
}

列出走廊国家
GET /v1/receive-countries opendata
返回分页的收款国家目录，供汇款目的地选择器初始化。
认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。
- items
- code
- name
```
GET /v1/receive-countries HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "items": [
    { "code": "MX", "name": "Mexico" },
    { "code": "IN", "name": "India" },
    { "code": "BR", "name": "Brazil" },
    { "code": "VN", "name": "Vietnam" }
  ]
}
```

读取转账确认

GET /v1/transfers/{transferId}/receipt openbanking

加载发送后的确认卡片：交易号、渠道回传的提取参考号与是否可开通短信提醒，在授权成功后展示。

认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。

transactionNumber
state
mainMessage
subHeader
secondaryMessage
channelReturn
smsOptIn
transferEligibleForSms
shareText
contactUsEmail

GET /v1/transfers/tr_12091/receipt HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "transactionNumber": "884120",
  "state": "COMPLETED",
  "mainMessage": "Your money is on the way",
  "subHeader": "Bank deposit to Ana Lopez",
  "secondaryMessage": "Usually arrives in minutes",
  "channelReturn": {
    "name": "Banorte",
    "reference": "XO884120"
  },
  "smsOptIn": { "transferEligibleForSms": true },
  "shareText": "I sent money with Xoom. Tracking number 884120",
  "contactUsEmail": "[email protected]"
}

创建再汇一笔

POST /v1/sends/repeat openfinance

按历史转账号重建一笔汇款供 Quick Send 使用：目的地、上次付款来源与新的汇款编号，跳过空白计算器。

认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。

transferId
id
name
namePrefix
type
nameWithTypeDetails
paymentType
orderItemId

POST /v1/sends/repeat HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "transferId": "tr_12091",
  "content": "SEND_AGAIN"
}

{
  "destination": {
    "id": "rcp_77ab",
    "name": "Ana Lopez",
    "namePrefix": "AL",
    "type": "BANK_DEPOSIT"
  },
  "paymentSource": {
    "id": "ps_debit_19",
    "name": "Visa 4242",
    "nameWithTypeDetails": "Visa debit · 4242",
    "paymentType": "DEBIT_CARD",
    "type": "CARD"
  },
  "remittance": {
    "id": "rm_3013",
    "orderItemId": "oi_88c2"
  }
}

创建预付充值订单
POST /v1/airtime-topups openfinance
按收款手机号与源币种发起话费 / 预付充值，返回汇率与四舍五入声明，供充值复核界面使用。
认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。
- id
- countryCode
- phone
- selectedSourceCurrencyCode
- fxDisclaimerAvailable
- fxDisclaimer
- roundingDisclaimer
```
POST /v1/airtime-topups HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "phone": "+525512345678",
  "selectedSourceCurrencyCode": "USD"
}
```
```
{
  "id": "rl_4410",
  "countryCode": "MX",
  "phone": "+525512345678",
  "selectedSourceCurrencyCode": "USD",
  "fxDisclaimerAvailable": true,
  "fxDisclaimer": "Rate includes a currency conversion",
  "roundingDisclaimer": "Amount rounded to the nearest peso"
}
```
读取订单核验表单
GET /v1/checkouts/{checkoutId}/identity-form osint
在授权前若订单需要发款人 KYC 字段，返回复核流程展示的身份 / 地址表单。
认证方式： PayPal 统一登录签发的 Bearer 访问令牌（Authorization 头），另附请求时间戳、时区与设备元数据头。会话以刷新令牌轮换。
- form
- name
- fields
- agreements
```
GET /v1/checkouts/ck_6f20/identity-form HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "form": {
    "name": "SENDER_IDENTITY",
    "fields": [
      { "name": "dateOfBirth" },
      { "name": "nationality" },
      { "name": "address1" }
    ],
    "agreements": [
      { "id": "tos" }
    ]
  }
}
```

数据类别

汇率报价
转账
收款人
付款方式
KYC 资料
交易流水

数据使用场景与案例

走廊汇率监控
资金台从每笔汇款报价拉取 sendAmount、receiveAmount、fee 与 fxRate，对照银行柜台观察 USD→MXN / USD→INR 走廊。
收款人打款目录
客服工具把收款人 id、打款类型与 latestTransfer.transactionNumber 拼在一起，无需打开活动页即可回答「上一笔打到哪里」。
转账运营看板
运营分页活动列表（invoiceId、totalAmount、statusBadge）与确认单（transactionNumber、channelReturn），与现金提取合作方对账。
付款来源对账
账务把已保存工具上的 paymentSourceId、accountType、walletType 与支付该结账订单的 fundingPlan 对齐。

常见问题

Xoom 汇款报价返回哪些字段？

报价含 sendAmount、receiveAmount、fee、fxRate、discountAmount、total、目标币种、paymentType 与 disbursementType（银行入账、现金提取、钱包或充值）。

应用如何鉴权 API 调用？

PayPal 统一登录后客户端携带 Bearer 访问令牌，以及请求时间戳、时区与设备元数据头。会话以刷新令牌轮换；结账确认步骤还会发送设备指纹。

能否读取转账历史而不只是实时报价？

可以。活动列表按笔分页 invoiceId、totalAmount 与 statusBadge；确认资源返回 transactionNumber 以及打款合作方的 channelReturn。

列出了哪些付款工具？

已保存付款方式返回 paymentSourceId、type（卡或银行）、accountType、walletType、nameOnAccount、issuingCountryCode 与有效期，结账订单再通过 fundingPlan 绑定。

与 Xoom: Send Money & Transfer 相似的应用

Remitly: Send Money & Transfer — Remitly 是国际汇款应用，可从美国及其他 30 多个国家向 175 多个目的地打款，收款方式包括银行入账、手机钱包或现金提取。
Wise: International Transfers — Wise 是伦敦的跨境汇款应用，覆盖 160 个国家和 40 多种货币，按中间市场汇率兑换，并提供多币种账户，但不支持现金提取。
Western Union Send Money Now — 西联汇款可通过网站、应用或网点，向 200 个国家或地区的银行账户、手机钱包或现金提取点打款。
MoneyGram — MoneyGram 是达拉斯的点对点汇款公司，通过约 40 万个代理网点，向 200 多个国家或地区办理现金提取或银行入账。
WorldRemit — WorldRemit 是伦敦的数字汇款应用，覆盖 130 多个国家，收款方式包括银行入账、手机钱包、现金提取和话费充值。
Ria Money Transfer — Ria Money Transfer 是 Euronet Worldwide 旗下公司，主营个人对个人国际汇款，通过代理网点、门店和手机应用办理。
Taptap Send: Money Transfer — Taptap Send 是国际汇款应用，可从美国、加拿大、英国及其他欧洲国家向非洲、亚洲和拉丁美洲 70 多个目的地打款，收款支持银行入账、手机钱包或现金提取。
Xe Money Transfer & Currency — Xe Money Transfer 同属 Euronet Worldwide，面向个人与企业向 170 多个国家、100 多种货币打款，收款方式包括银行入账、手机钱包或现金提取。

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

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

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

获取报价

Xoom 数据 API：报价、收款人与转账

应用截图

API 端点一览

读取已登录 Xoom 用户

分页转账活动列表

读取已保存收款人

按编号读取转账

创建汇款报价

创建结账订单

读取结账订单

授权结账订单

列出付款方式

列出走廊国家

读取转账确认

创建再汇一笔

创建预付充值订单

读取订单核验表单

数据类别

数据使用场景与案例

走廊汇率监控

收款人打款目录

转账运营看板

付款来源对账

常见问题

与 Xoom: Send Money & Transfer 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

Xoom 数据 API：报价、收款人与转账

应用截图

API 端点一览

读取已登录 Xoom 用户

分页转账活动列表

读取已保存收款人

按编号读取转账

创建汇款报价

创建结账订单

读取结账订单

授权结账订单

列出付款方式

列出走廊国家

读取转账确认

创建再汇一笔

创建预付充值订单

读取订单核验表单

数据类别

数据使用场景与案例

走廊汇率监控

收款人打款目录

转账运营看板

付款来源对账

常见问题

相关应用

与 Xoom: Send Money & Transfer 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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