Pular para o conteúdo principal

Cancela uma transação TEF/Pix

DELETE 
/store-front/cashier/:idbankaccount/payment/:idstorefrontcashierpayment

Handler PHP com set_time_limit(180). Cancela uma transação autorizada (status 3 Creditado) ou em cancelamento (status 6). Outros status retornam Transação não esta aprovada. O cancelamento é permitido apenas em transações autorizadas.

Por integração​

  • PayGo / ControlPay: chama Venda/CancelarVenda com senhaTecnica (senha técnica do TEF, passada via query TEFPassword). Obrigatória — se omitida, retorna Precisa informar a senha do TEF para cancelamento (TEFPassword). Em sucesso de conexão, status vira Em cancelamento (6); cliente deve fazer polling via GET até o status final virar Cancelado (7). Erro de conexão → mensagem Erro ao conectar ao terminal TEF....
  • StarkBank: retorna direto Não é possível cancelar uma cobrança Pix. O QR Code apenas expira após o tempo configurado. — Pix Stark Bank não é cancelável (só expira).
  • Pagar.me: chama CancelPix(IDCompanyIntegration, ExternalId). Status vira Cancelado (7) com RecordTimestampCancel e IDUserCancel preenchidos.

Em todos os casos com sucesso de conexão, grava RecordTimestampCancel (data/hora atual) e IDUserCancel (usuário que iniciou o cancelamento, vindo do token via LAMBDA_REQUEST_CONTEXT.authorizer.User).

A frente de cancelamento da tela faz polling do GET por até 180 segundos com intervalo de 2s entre tentativas, mostrando "Aguarde ou digite o número do cartão..." enquanto espera o cliente operar a maquininha.

Request​

Responses​

Cancelamento solicitado. Para PayGo retorna o StoreFrontCashierPayment com status atualizado para Em cancelamento (6) — cliente deve fazer polling via GET. Para Pagar.me retorna com status Cancelado (7).