---
title: "Register a tx for a request."
method: PATCH
path: "/v1/register-tx"
tags: ["v1"]
deprecated: true
---

# Register a tx for a request.

`PATCH /v1/register-tx`

> **Deprecated.**

Required for the Solver to track and execute some requests.

## Request body

- union — Gateway order to execute
  - 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
      - `evm_txhash` string, required — EVM txhash
      - `order_id` string, required — Unique order id
  - object
    - `layerZero` object, required
      - `evm_txhash` string, required — EVM txhash
      - `order_id` string, required — Unique order id

## Response `200`

Register successful

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

## Other responses

- `400` — Register error

## Changes

- **2026-05-26** `ca0ef15d5879` — 1 info
  - endpoint deprecated
- **2026-05-06** `162bab886181` — 2 breaking, 1 warning, 4 info
  - removed the required property `details/oneOf[#/components/schemas/GatewayErrorDetails]/oneOf[subschema #3 -> subschema #8]/min_required_sats` from the response with the `400` status
  - removed the required property `details/oneOf[#/components/schemas/GatewayErrorDetails]/oneOf[subschema #3 -> subschema #8]/sender` from the response with the `400` status
  - added the new `QUOTE_AMOUNT_TOO_LOW` enum value to the `code` response property for the response status `400`
  - the endpoint scheme security `api_key` was added to the API
  - …3 more
- **2026-03-20** `3d71e0aeceec` — 1 info
  - added the non-success response with the status `400`

[Change history](https://skmtc.dev/bob-collective/apis/bob-gateway-api/changes/v1/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)