---
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`

## Changes

- **2026-07-30** `5a00610487e4` — 1 breaking, 2 warning
  - added `subschema #1` to the `details/oneOf[#/components/schemas/GatewayErrorDetailsV3]/` response property `oneOf` list for the response status `400`
  - added the new `MAX_SLIPPAGE_EXCEEDED` enum value to the `code/oneOf[#/components/schemas/GatewayErrorCodeV3Variants]/` response property for the response status `400`
  - added the new `SERVICE_UNAVAILABLE` enum value to the `code/oneOf[#/components/schemas/GatewayErrorCodeV3Variants]/` response property for the response status `400`
- **2026-07-02** `aae0690f68d2` — 1 breaking, 1 warning
  - added `subschema #12` to the `details/oneOf[#/components/schemas/GatewayErrorDetailsV3]/` response property `oneOf` list for the response status `400`
  - added the new `TOO_MANY_AFFILIATES` enum value to the `code/oneOf[#/components/schemas/GatewayErrorCodeV3Variants]/` response property for the response status `400`
- **2026-06-18** `7dc4dd4a320a` — 1 breaking, 1 warning, 1 info
  - added `#/components/schemas/GatewayErrorDetailsV3` to the `details` response property `oneOf` list for the response status `400`
  - added the new `NON_COMPLIANT_ADDRESSES` enum value to the `code/oneOf[#/components/schemas/GatewayErrorCodeV3Variants]/` response property for the response status `400`
  - removed `#/components/schemas/GatewayErrorDetailsV2` from the `details` response property `oneOf` list for the response status `400`
- **2026-06-18** `d2dd18e5fc89` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bob-collective/apis/bob-gateway-api/changes/v3/register-tx/patch.md)

---

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