# PayZu Cartão de Crédito

- [Cartão de Crédito](/docs/cartao): Uma integração para cobrar no cartão do seu cliente e dar conta do ciclo inteiro: autorização e captura na hora, parcelamento, 3D Secure, antifraude, recorrência e estorno.
- [Códigos de retorno ABECS](/docs/cartao/abecs-codes): Quando uma venda no cartão é recusada, é aqui que você descobre o porquê: a lista completa dos códigos padronizados pela ABECS, organizada por bandeira.
- [ABECS return codes](/docs/cartao/abecs-codes.en): When a card sale is declined, this is where you find out why: the full set of ABECS-standardized return codes, organized by card brand.
- [ABECS 返回码](/docs/cartao/abecs-codes.zh): 卡片交易被拒时，在这里查清原因：ABECS 统一的全部拒付返回码，按卡组织整理。
- [Ramos de atividade](/docs/cartao/activity-branches): A lista de ramos de atividade que classificam o tipo de negócio de um estabelecimento, cada um com o seu código.
- [Activity branches](/docs/cartao/activity-branches.en): The list of activity branches that classify a merchant's line of business, each with its own code.
- [经营类别](/docs/cartao/activity-branches.zh): 用于对商户经营类型进行分类的经营类别清单，每一类都有自己的代码。
- [Antifraude](/docs/cartao/antifraud): Passa cada cobrança pela análise de risco da Cybersource em tempo real antes de autorizar, aprovando, recusando ou mandando para revisão manual conforme as suas regras.
- [Antifraud](/docs/cartao/antifraud.en): Runs every charge through Cybersource risk analysis in real time before authorizing, then approves, declines, or sends it to manual review based on your rules.
- [反欺诈](/docs/cartao/antifraud.zh): 在授权前，通过 Cybersource 实时做风险分析，再按你设定的规则自动批准、拒绝或转人工复核。
- [Autenticação](/docs/cartao/authentication): A API usa duas camadas que trabalham juntas: um certificado de cliente (mTLS) que garante quem está de cada lado e um token que você gera e envia em toda chamada.
- [Authentication](/docs/cartao/authentication.en): The API stacks two layers that work together: a client certificate (mTLS) that proves who's on each end, plus a token you generate and send with every call.
- [身份认证](/docs/cartao/authentication.zh): 接口用两层叠加的方式：一层是证明双方身份的客户端证书（mTLS），另一层是你生成并在每次调用时带上的令牌。
- [Códigos de compensação](/docs/cartao/compensation-codes): A lista de códigos de compensação dos bancos brasileiros: cada instituição tem um número de três dígitos que a identifica no sistema bancário.
- [Bank compensation codes](/docs/cartao/compensation-codes.en): The list of Brazilian bank compensation codes: every institution has a three-digit number that identifies it in the banking system.
- [银行清算代码](/docs/cartao/compensation-codes.zh): 巴西各银行的清算代码清单：每家机构都有一个三位数字，用于在银行系统中标识它。
- [Moedas suportadas](/docs/cartao/currencies): As 157 moedas que a API aceita, cada uma com o código de três letras do padrão ISO 4217 que você informa ao criar a cobrança.
- [Supported currencies](/docs/cartao/currencies.en): The 157 currencies the API accepts, each with the three-letter ISO 4217 code you send when creating a charge.
- [支持的货币](/docs/cartao/currencies.zh): 接口支持的 157 种货币，每一种都用 ISO 4217 的三字母代码，在发起收款时填入。
- [Endpoints da API](/docs/cartao/endpoints): O caminho completo de uma integração de cartão, do token à cobrança, passando pelos avisos de status e chegando ao estorno.
- [Cobranças](/docs/cartao/endpoints/charges): O coração da API de cartão: você cria a cobrança, acompanha como ela evolui e, se precisar, devolve o valor inteiro ou só uma parte.
- [Listar Cobranças](/docs/cartao/endpoints/charges/get_charges): Puxa suas cobranças em lista para você acompanhar de uma vez tudo o que já criou.
- [Consultar Cobrança](/docs/cartao/endpoints/charges/get_charges__chargeId_): Consulta uma cobrança específica e devolve a situação atual dela junto com todos os detalhes.
- [Get Charge](/docs/cartao/endpoints/charges/get_charges__chargeId_.en): Looks up a single charge and returns its current status along with the full details.
- [查询收款](/docs/cartao/endpoints/charges/get_charges__chargeId_.zh): 查询某一笔收款，返回它当前的状态和完整明细。
- [List Charges](/docs/cartao/endpoints/charges/get_charges.en): Pulls your charges as a list so you can track everything you've created at once.
- [收款列表](/docs/cartao/endpoints/charges/get_charges.zh): 把你的收款以列表形式取出，方便一次性查看已经创建的全部记录。
- [Charges](/docs/cartao/endpoints/charges/index.en): The heart of the card API: create a charge, follow how it progresses, and refund the full amount or just part of it when you need to.
- [收款](/docs/cartao/endpoints/charges/index.zh): 卡片接口的核心：创建收款、跟踪它的进展，需要时全额或部分退款。
- [Criar Cobrança](/docs/cartao/endpoints/charges/post_charges): Cria uma cobrança no cartão de crédito, com suporte a 3DS, antifraude, moeda estrangeira e pagamento recorrente.
- [Create Charge](/docs/cartao/endpoints/charges/post_charges.en): Creates a credit card charge, with support for 3DS, fraud analysis, foreign currency, and recurring payments.
- [创建收款](/docs/cartao/endpoints/charges/post_charges.zh): 用信用卡创建一笔收款，支持 3DS、反欺诈、外币和周期扣款。
- [Estornar Cobrança](/docs/cartao/endpoints/charges/put_charges__chargeId__reverse): Devolve ao portador o valor de uma cobrança, inteiro ou apenas parte dele.
- [Reverse Charge](/docs/cartao/endpoints/charges/put_charges__chargeId__reverse.en): Refunds a charge back to the cardholder, either in full or just part of it.
- [收款退款](/docs/cartao/endpoints/charges/put_charges__chargeId__reverse.zh): 把一笔收款退还给持卡人，可以全额，也可以只退一部分。
- [Converter valor](/docs/cartao/endpoints/currencies/get_currency_convert): Converte um valor em reais para a moeda que você escolher, usando a cotação de compra ou de venda.
- [Convert amount](/docs/cartao/endpoints/currencies/get_currency_convert.en): Converts an amount in reais into the currency you choose, using the buy or sell rate.
- [金额换算](/docs/cartao/endpoints/currencies/get_currency_convert.zh): 把一笔以雷亚尔计的金额换算成你选定的货币，按买价或卖价计算。
- [Cotação de moeda](/docs/cartao/endpoints/currencies/get_currency_rate): A cotação de compra e de venda de uma moeda agora, em reais por unidade estrangeira.
- [Get currency rate](/docs/cartao/endpoints/currencies/get_currency_rate.en): The current buy and sell rate for a currency, in reais per foreign unit.
- [获取汇率](/docs/cartao/endpoints/currencies/get_currency_rate.zh): 某种货币此刻的买价和卖价，以每单位外币多少雷亚尔表示。
- [Listar cotações](/docs/cartao/endpoints/currencies/get_currency_rates): As cotações de compra e de venda de todas as moedas, no último fechamento do Banco Central.
- [List currency rates](/docs/cartao/endpoints/currencies/get_currency_rates.en): The buy and sell rates for every currency, from the latest Banco Central close.
- [汇率列表](/docs/cartao/endpoints/currencies/get_currency_rates.zh): 巴西央行最近一次收盘时，所有货币的买价和卖价。
- [API Endpoints](/docs/cartao/endpoints/index.en): The full path of a card integration, from the token to the charge, through status notifications, all the way to the refund.
- [API 端点](/docs/cartao/endpoints/index.zh): 一次卡片对接的完整路径：从获取令牌到创建收款，经过状态通知，直到退款。
- [Modelos](/docs/cartao/endpoints/models): A estrutura de cada objeto que entra e sai da API: quais campos existem, o tipo de cada um e quais são obrigatórios.
- [Models](/docs/cartao/endpoints/models.en): The shape of every object the API takes in and sends back: which fields exist, the type of each, and which ones are required.
- [模型](/docs/cartao/endpoints/models.zh): 接口收发的每个对象的结构：有哪些字段、各自是什么类型、哪些是必填的。
- [Recorrências](/docs/cartao/endpoints/recurrences): Assinaturas no cartão: a primeira cobrança sai na hora e os ciclos seguintes rodam sozinhos, e aqui você ajusta o valor, pausa ou reativa a cobrança automática.
- [Consultar Recorrência](/docs/cartao/endpoints/recurrences/get_charges_recurrences__recurrentPaymentId_): Mostra em que pé está uma assinatura no momento da consulta.
- [Get Recurrence](/docs/cartao/endpoints/recurrences/get_charges_recurrences__recurrentPaymentId_.en): Shows where a subscription stands at the moment you check.
- [查询循环扣款](/docs/cartao/endpoints/recurrences/get_charges_recurrences__recurrentPaymentId_.zh): 查询时，告诉你某个订阅当前处在什么状态。
- [Recurrences](/docs/cartao/endpoints/recurrences/index.en): Card subscriptions: the first charge goes through right away and the following cycles run on their own, and here you adjust the amount, pause, or resume the automatic billing.
- [循环扣款](/docs/cartao/endpoints/recurrences/index.zh): 卡片订阅：第一笔立即扣款，之后每期自动进行，你在这里调整金额、暂停或重新开启自动扣款。
- [Alterar valor da Recorrência](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__amount): Muda quanto o cliente vai pagar nos próximos ciclos da assinatura, sem mexer no que já foi cobrado.
- [Change Recurrence amount](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__amount.en): Change how much the customer pays in the upcoming subscription cycles, without touching what has already been charged.
- [修改循环扣款金额](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__amount.zh): 调整客户在后续订阅周期要支付的金额，已经产生的账单不受影响。
- [Desativar Recorrência](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__deactivate): Para as cobranças automáticas do cliente: nenhuma nova é gerada e a assinatura fica inativa até você reativar.
- [Deactivate Recurrence](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__deactivate.en): Stops the customer's automatic charges: no new ones are created and the subscription stays inactive until you turn it back on.
- [停用循环扣款](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__deactivate.zh): 停止对客户的自动扣款：不再生成新账单，订阅保持停用状态，直到你重新启用。
- [Reativar Recorrência](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__reactivate): Liga de novo uma assinatura que estava parada, e as cobranças automáticas voltam a acontecer no intervalo configurado.
- [Reactivate Recurrence](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__reactivate.en): Turns a paused subscription back on so the automatic charges resume on the configured schedule.
- [重新启用循环扣款](/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__reactivate.zh): 重新启用已停用的订阅，自动扣款按设定的周期恢复。
- [Token](/docs/cartao/endpoints/token): Como trocar as credenciais da sua conta pelo token de acesso que autoriza todas as chamadas de cobrança e recorrência.
- [Token](/docs/cartao/endpoints/token/index.en): How to swap your account credentials for the access token that authorizes every charge and recurring-billing call.
- [Token](/docs/cartao/endpoints/token/index.zh): 如何用账户凭证换取访问令牌，所有扣款和订阅请求都靠它来授权。
- [Obter token de API](/docs/cartao/endpoints/token/post_token): Envie as credenciais da sua conta pela conexão mTLS e receba de volta o token que autentica todas as outras chamadas.
- [Get API token](/docs/cartao/endpoints/token/post_token.en): Send your account credentials over the mTLS connection and get back the token that authenticates every other call.
- [获取 API token](/docs/cartao/endpoints/token/post_token.zh): 通过 mTLS 连接发送账户凭证，换回用于认证其他所有请求的令牌。
- [Códigos de erro](/docs/cartao/error-codes): Os códigos que a adquirente devolve quando uma transação falha, o que cada um significa e o alerta que vale ouro: em falha de comunicação, a cobrança pode ter sido aprovada mesmo assim.
- [Error codes](/docs/cartao/error-codes.en): The codes the acquirer returns when a transaction fails, what each one means, and the caveat worth remembering: on a communication failure the charge may still have gone through.
- [错误代码](/docs/cartao/error-codes.zh): 收单机构在交易失败时返回的代码、各自的含义，以及一个值得牢记的提醒：通信中断时扣款仍可能已经成功。
- [Primeiros passos](/docs/cartao/getting-started): Do certificado à sua primeira cobrança aprovada no sandbox, com cada passo na ordem para você ver o fluxo funcionar de ponta a ponta.
- [Getting started](/docs/cartao/getting-started.en): From setting up the certificate to your first approved charge in the sandbox, each step in order so you can watch the whole flow work end to end.
- [快速开始](/docs/cartao/getting-started.zh): 从配置证书到在沙箱里跑通第一笔成功扣款，按顺序走完每一步，让你完整看到整个流程。
- [Credit Card](/docs/cartao/index.en): One integration to charge your customer's card and cover the whole cycle: real-time authorization and capture, installments, 3D Secure, fraud analysis, recurring billing and refunds.
- [信用卡](/docs/cartao/index.zh): 一次接入即可完成整个刷卡流程：实时授权与请款、分期、3D Secure、风控、周期扣款和退款。
- [Cobranças Internacionais](/docs/cartao/international): Como cobrar em moeda estrangeira: escolhida a moeda, o valor passa a ser lido na menor unidade dela e a análise antifraude vira obrigatória.
- [International Charges](/docs/cartao/international.en): How to charge in a foreign currency: once you pick the currency, the amount is read in that currency's smallest unit and fraud analysis becomes mandatory.
- [跨境收款](/docs/cartao/international.zh): 如何用外币收款：选定货币后，金额按该货币的最小单位计算，且风控分析变为必填。
- [Tabela de MDDs](/docs/cartao/mdds): Os campos de dados do lojista que você pode mandar para a análise antifraude, cada um com o peso que tem na decisão de risco; se não tiver o dado, é só deixar de fora.
- [MDD table](/docs/cartao/mdds.en): The merchant-defined data fields you can send to fraud analysis, each with how much it weighs on the risk decision; if you don't have a value, just leave it out.
- [MDD 字段表](/docs/cartao/mdds.zh): 你可以提交给风控分析的商户自定义字段，以及每个字段对风险判断的权重；没有的数据直接省略即可。
- [Pagamentos Recorrentes](/docs/cartao/recurrence): Monte uma assinatura: a primeira cobrança sai na hora e, a partir daí, a PayZu cobra o cartão do cliente sozinha a cada ciclo, mensal ou anual.
- [Recurring Payments](/docs/cartao/recurrence.en): Set up a subscription: the first charge goes through right away and from then on PayZu charges the customer's card on its own every cycle, monthly or yearly.
- [循环扣款](/docs/cartao/recurrence.zh): 搭建订阅：首笔扣款立即完成，之后每个周期（按月或按年）PayZu 自动向客户的卡扣款。
- [Códigos de referência](/docs/cartao/reference-codes): Os valores exatos que a API espera e devolve para bandeira de cartão e tipo de pagamento, para você não ter que adivinhar na hora de montar a requisição.
- [Reference codes](/docs/cartao/reference-codes.en): The exact values the API expects and returns for card brand and payment type, so you don't have to guess when building a request.
- [参考代码](/docs/cartao/reference-codes.zh): API 对卡组织和支付类型所接受和返回的确切取值，构造请求时无需靠猜。
- [Programa de retentativa das bandeiras](/docs/cartao/retry-program): Quantas vezes você pode tentar de novo uma compra negada no mesmo cartão antes de Mastercard, Visa e Elo passarem a cobrar tarifa pelo excesso.
- [Card network retry program](/docs/cartao/retry-program.en): How many times you can retry a denied purchase on the same card before Mastercard, Visa and Elo start charging a fee for going over the limit.
- [卡组织重试计划](/docs/cartao/retry-program.zh): 同一张卡被拒后你还能重试几次，以及超过限额后 Mastercard、Visa 和 Elo 何时开始收取罚费。
- [Cartões de teste](/docs/cartao/test-cards): Números de cartão para forçar cada resultado no sandbox, do aprovado ao negado, incluindo os fluxos 3DS com e sem desafio.
- [Test cards](/docs/cartao/test-cards.en): Card numbers that force each outcome in the sandbox, from approved to declined, including the 3DS flows with and without a challenge.
- [测试卡](/docs/cartao/test-cards.zh): 用来在沙箱里触发各种结果的测试卡号，从通过到拒付，含带挑战和免挑战的 3DS 流程。
- [3-D Secure (3DS)](/docs/cartao/three-d-secure): Confirma com o banco emissor que quem está comprando é mesmo o dono do cartão; autenticar reduz fraude e passa a responsabilidade por chargeback para o emissor ou a bandeira.
- [3-D Secure (3DS)](/docs/cartao/three-d-secure.en): Confirms with the issuing bank that the person paying really owns the card; authenticating cuts fraud and shifts chargeback liability to the issuer or the brand.
- [3-D Secure (3DS)](/docs/cartao/three-d-secure.zh): 向发卡行确认付款人确实是持卡本人；完成认证既能降低欺诈，又把拒付责任转移给发卡行或卡组织。
- [Status e motivos da transação](/docs/cartao/transaction-status): Todos os estados por que uma cobrança passa e o motivo por trás de cada resultado, com o lembrete de programar pelos códigos estáveis, e não pelo texto que pode mudar.
- [Transaction status and reasons](/docs/cartao/transaction-status.en): Every state a charge moves through and the reason behind each outcome, with the reminder to code against the stable codes, not the wording, which can change.
- [交易状态与原因](/docs/cartao/transaction-status.zh): 一笔扣款会经历的所有状态、每种结果背后的原因，并提醒你按稳定的代码来编程，而不是随时可能改动的文案。
- [Webhooks](/docs/cartao/webhooks): Em vez de ficar perguntando se a cobrança pagou, a PayZu avisa o seu sistema sozinha quando o status muda, o antifraude decide, entra um chargeback ou começa um novo ciclo de recorrência. Você configura o recebimento, valida a assinatura e trata as retentativas.
- [Webhooks](/docs/cartao/webhooks.en): Instead of polling to see whether a charge went through, PayZu tells your system on its own when the status changes, the fraud check decides, a chargeback lands, or a new recurring cycle begins. You set up the receiving side, verify the signature, and handle the retries.
- [Webhooks](/docs/cartao/webhooks.zh): 不用一直去查这笔收款有没有成功，状态变化、风控出结论、发生拒付或进入新一期扣款时，PayZu 会主动通知你的系统。你只需配置好接收、校验签名并处理好重试。