---
title: "Simular transacao (Sandbox)"
method: POST
path: "/v1/transactions/{transactionId}/simulate"
tags: ["Transacoes"]
---

# Simular transacao (Sandbox)

`POST /v1/transactions/{transactionId}/simulate`

Simula acoes em uma transacao no ambiente Sandbox.

## Path parameters

- `transactionId` string, uuid, required

## Request body

- SimulateTransactionRequest
  - `action` 'complete' | 'expire' | 'fail' | 'refund', required — Acao a simular

## Response `200`

Simulacao realizada

- SimulateTransactionResponse
  - `data` TransactionSimulation, nullable
    - `id` string, uuid
    - `status` string
    - `simulatedAction` string
    - `completedAt` string, date-time, nullable
    - `refundedAt` string, date-time, nullable
    - `pix` PixTransactionData, nullable — Dados do PIX. A imagem do QR Code não é retornada - use uma biblioteca de QR Code para gerar a imagem a partir do copyAndPaste.
      - `txId` string — ID da transacao PIX (TxId)
      - `copyAndPaste` string — Codigo PIX Copia e Cola (BR Code). Use este codigo para gerar a imagem do QR Code no seu frontend.
      - `expiresAt` string, date-time — Data de expiracao do codigo PIX
  - `message` string, nullable
  - `error` ApiErrorResponse, nullable
    - `message` string — Mensagem de erro
    - `code` string — Codigo do erro

## Other responses

- `400` — Acao invalida
- `401` — Nao autorizado
- `404` — Transacao nao encontrada

---

[API](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway.md) · [All operations](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safefy-pay/safefy-pix-gateway/revisions/c4fd84385e23/schema)