.sw-reveal,.sw-reveal[data-reveal=rise]>*,.sw-scene .sw-bar,.sw-scene .sw-spark-area,.sw-scene .sw-spark-dot{opacity:1!important;transform:none!important;filter:none!important}.sw-scene .sw-spark-line{stroke-dashoffset:0!important}html:has(main>[data-theme=dark]:first-child) .sw-header[data-boot]{background:#0e0f11}

Entrar Criar conta grátis

Receber

Proteger e dividir

Entregar e medir

Por modelo de negócio

Sem site ou em rede

Gerente de conta exclusivo

Toda empresa tem um gerente de conta, para um suporte individual e humanizado.

Conhecer o gerente de conta

Construir

Operar

Para quem vende

Para quem comprou

Ouvidoria

Não resolveu no atendimento? A Ouvidoria revê o caso, com protocolo.

Abrir na Ouvidoria

Estorna uma transação

POST/v1/transactions/{transactionId}/refund

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Parâmetros do caminho

transactionIdstringobrigatório
Identificador público (tra_/trx_…)

Corpo da requisição

amountinteger
Valor a estornar, em centavos. Omitido = a cobrança inteira.
reasonstring
Por quê (texto livre, guardado no estorno).

Respostas

202Aceito

statusstringobrigatório
Status da cobrança depois de a ação ser aceita — o desfecho chega por webhook.
Valores:pendingpre-authorizedapprovedfailedrefusedcanceledrefundedchargebackdisputefraud-reviewanalyzingawaiting
acceptedbooleanobrigatório
Sempre true: a ação foi aceita.
Valores:true
transactionIdstringobrigatório
Identificador público (tra_/trx_…)

401Não autenticado (credencial ausente ou inválida)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

403Sem permissão

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

404Não encontrado

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

422Regra de negócio impede o processamento

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

500Erro interno do servidor

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

AnteriorConsulta uma transação PróximaCaptura uma transação pré-autorizada

Requisição

curl -X POST "https://api.selectwin.io/v1/transactions/{transactionId}/refund" \
  -H "SelectKey: $SELECTWIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": 5000,
  "reason": "string"
}'

Resposta

{
  "status": "pending",
  "accepted": true,
  "transactionId": "tra_0a1b2c3d4e5f60718293"
}