# 银行卡 (/zh/docs/cartao)

信用卡 API 用于在您的电商、应用或平台中发起信用卡收款。一次集成即可覆盖收款的完整生命周期：实时授权与请款、分期、3D Secure 认证、PayZu 反欺诈引擎风险分析、循环扣款和退款。

<Mermaid
  chart="`
flowchart LR
  Sua[&#x22;您的应用&#x22;] <--> API[&#x22;PayZu 信用卡 API&#x22;]
  API --> CH[&#x22;收款&#x22;]
  API --> TDS[&#x22;3D Secure&#x22;]
  API --> AF[&#x22;反欺诈&#x22;]
  API --> REC[&#x22;循环扣款&#x22;]
  API --> WH[&#x22;Webhooks&#x22;]

  click CH &#x22;/docs/cartao/endpoints/charges/post_charges&#x22; &#x22;POST /charges&#x22;
  click TDS &#x22;/docs/cartao/three-d-secure&#x22; &#x22;3D Secure&#x22;
  click AF &#x22;/docs/cartao/antifraud&#x22; &#x22;反欺诈&#x22;
  click REC &#x22;/docs/cartao/recurrence&#x22; &#x22;循环扣款&#x22;
  click WH &#x22;/docs/cartao/webhooks&#x22; &#x22;Webhooks&#x22;

  style API fill:#14ce71,stroke:#0eb464,color:#ffffff
`"
/>

## 从哪里开始 [#从哪里开始]

<Cards>
  <Card title="快速开始" href="/docs/cartao/getting-started" description="从 mTLS 证书到在 sandbox 中完成第一笔获批收款。" />

  <Card title="接口端点" href="/docs/cartao/endpoints" description="token、收款与循环扣款的完整参考。" />

  <Card title="3D Secure" href="/docs/cartao/three-d-secure" description="由发卡行对买家进行身份认证。" />

  <Card title="反欺诈" href="/docs/cartao/antifraud" description="通过集成在 API 中的 PayZu 反欺诈引擎进行风险分析。" />

  <Card title="循环扣款" href="/docs/cartao/recurrence" description="由 API 自身管理的循环收款。" />

  <Card title="Webhooks" href="/docs/cartao/webhooks" description="通过 postbackUrl 接收收款状态通知。" />

  <Card title="状态与原因" href="/docs/cartao/transaction-status" description="交易状态、原因与返回码。" />

  <Card title="测试卡" href="/docs/cartao/test-cards" description="用于在 sandbox 环境中模拟交易的卡号。" />
</Cards>

## 环境 [#环境]

| 环境          | 基础 URL                            |
| ----------- | --------------------------------- |
| **生产环境**    | `https://api.payzu.io/v1`         |
| **Sandbox** | `https://api.sandbox.payzu.io/v1` |

<Callout type="info">
  身份认证将 &#x2A;*mTLS(Mutual TLS)** 与 **Bearer token** 结合使用:PayZu 提供的客户端证书需随所有调用一起发送,token 通过 [`POST /token`](/docs/cartao/endpoints/token/post_token) 获取。该机制可确保客户端身份与通信安全。详细步骤见[身份认证](/docs/cartao/authentication)。
</Callout>

<Callout type="warn">
  API 中所有金额字段(`amount`、`unitPrice`)均以**分**为单位。汇率(`rate.bid`、`rate.ask`)是例外,它们是小数。
</Callout>

## PayZu 其他产品 [#payzu-其他产品]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento" title="Pix Processamento" />

  <QuickLink href="/zh/docs" title="全部产品" />
</QuickLinks>

## 支持 [#支持]

集成中遇到问题或有疑问？请发邮件至 [integracao@payzu.com.br](mailto:integracao@payzu.com.br)。