---
title: "Register a tx for a request (V3 body)."
method: PATCH
path: "/v3/register-tx"
tags: ["v3"]
---

# Register a tx for a request (V3 body).

`PATCH /v3/register-tx`

## Request body

- union — V3 register-tx body. Offramp and token-swap use chain-aware `srcTxHash` + `srcChain` (EVM `0x…` on EVM chains, Base58 signature on Solana).
  - object
    - `onramp` object, required
      - `bitcoin_tx_hex` string, nullable — Hex-encoded full Bitcoin transaction
      - `bitcoin_txid` string, nullable — Bitcoin transaction ID (txid)
      - `order_id` string, required — Unique order id
  - object
    - `offramp` object, required
      - `order_id` string, required — Unique order id
      - `src_chain` string, required — Source chain (e.g. `"ethereum"`, `"solana"`)
      - `src_tx_hash` string, required — Source-chain transaction hash (`0x…` on EVM, Base58 signature on Solana)
  - object
    - `tokenSwap` object, required
      - `order_id` string, required — Unique order id
      - `src_chain` string, required — Source chain (e.g. `"ethereum"`, `"solana"`)
      - `src_tx_hash` string, required — Source-chain transaction hash (`0x…` on EVM, Base58 signature on Solana)

## Response `200`

- union
  - object
    - `onramp` object, required
      - `txid` string, required
  - 'ok'

## Other responses

- `400`

---

[API](https://skmtc.net/bob-collective/apis/bob-gateway-api.md) · [All operations](https://skmtc.net/bob-collective/apis/bob-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bob-collective/bob-gateway-api/revisions/5a00610487e4/schema)