# Pagamento recusado

Se uma transação for recusada por um sistema de pagamento, a Xsolla enviará os 
dados da transação em um webhook do tipo ps_declined para o URL configurado 
do webhook. O webhook é enviado durante o estágio de autorização ou 
processamento de pagamento. Nesse caso, o webhook 
payment\ order_paid não é enviado.

Razões típicas para recusas do sistema de pagamento:

* A autorização do cartão falhou (por exemplo, o sistema de pagamento não pôde 
  concluir o processo de autorização devido a um erro técnico ou nenhuma resposta 
  do banco) ou foi recusada (por exemplo, o banco respondeu, mas recusou a 
  transação devido a fundos insuficientes ou daods inválidos do cartão).
* A verificação do 3-D Secure falhou, não foi concluída, ou a confirmação do 
  usuário expirou.
* O processador ou banco adquirente está temporariamente indisponível ou retorna 
  uma recusa definitiva devido a um erro irreversível, tal como uma conta 
  encerrada ou um número de cartão inválido. É preciso resolver o problema 
  subjacente antes de tentar novamente, ou a transação não será bem-sucedida.

Não deve ser confundido com:

* Rejeições antifraude, que são relatadas por meio do webhook 
  afs_reject.
* Reembolsos e reembolsos parciais após um pagamento bem-sucedido, que são 
  relatados por meio do 
  reembolso e dos 
  webhooks partial_refund.


Nota
Para receber o webhook ps_declined, entre em contato com o Gerente de sucesso do Cliente ou envie um e-mail para csm@xsolla.com.

Endpoint: POST payment-declined
Version: 1.0

## Request fields (application/json):

  - `notification_type` (string, required)
    Tipo de notificação.

  - `refund_details` (object)
    Detalhes do reembolso (objeto).

  - `refund_details.author` (string)
    Iniciador de reembolso. O valor do campo é passado de acordo com a tabela:


    
    
        Iniciador de reembolso
        Valor do campo
    
    
    
    
        Jogo (via API).
        API
    
    
        Usuário da Publisher Account (reembolso automático).
        E-mail do usuário
    
    
        Usuário da Publisher Account (com assistência do suporte ao cliente Xsolla).
        support@xsolla.com
    
    
        Xsolla (com assistência do suporte ao cliente Xsolla).
        support@xsolla.com

  - `refund_details.code` (integer)
    ID do código.

  - `refund_details.reason` (string)
    Motivo do reembolso.

  - `settings` (object)
    Configurações personalizadas do projeto (objeto).

  - `settings.merchant_id` (integer)
    ID de comerciante.

  - `settings.project_id` (integer)
    ID do projeto. Você pode encontrar esse parâmetro em sua [Conta de Distribuidor](https://publisher.xsolla.com/) ao lado do nome do projeto.

  - `transaction` (object, required)
    Detalhes da transação (objeto).

  - `transaction.dry_run` (integer)
    Transação de teste. O parâmetro tem valor 1 se for uma transação de teste ou não for enviado se a transação for real.

  - `transaction.external_id` (string)
    ID externo de transação.

  - `transaction.id` (integer)
    ID de transação.

  - `transaction.payment_method` (integer)
    ID de método de pagamento.

  - `user` (object)
    Dados do usuário (objeto).

  - `user.country` (string)
    País do usuário. Código de país de duas letras maiúsculas, de acordo com o [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.email` (string)
    E-mail do usuário.

  - `user.id` (string, required)
    ID de usuário.

  - `user.ip` (string)
    IP do usuário.

  - `user.name` (string)
    Nome de usuário.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields