v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
onramp

Mark onramp event consumed after SA->tipping transfer submission

Mark a settled onramp event as consumed after the frontend submits the SA→tipping wallet transfer transaction.

This is the final step: the frontend sends the settled amount from the Smart Account to the tipping wallet, then calls this endpoint with the transaction hash.

Idempotent: If already consumed with the same tx_hash, returns current state.

Error codes:

  • 400: Invalid transfer_tx_hash format (must be 0x + 64 hex chars)
  • 404: Event not found or doesn't belong to authenticated account
  • 409: Event not in confirmed status, or consumed with a different tx_hash
post/v1/onramp/transfer-complete

Headers

authorizationstring nullable

Bearer JWT issued by Grove.

Bearer JWT issued by Grove.

Request body

event_idstring required

Onramp event ID

transfer_tx_hashstring required

SA->tipping wallet transfer transaction hash

Response

Successful Response

event_idstring required

Onramp event ID

statusstring required

Event status after update

consumedboolean required

Whether event is now consumed

transfer_tx_hashstring nullable

Recorded transfer transaction hash

lifecycle_statestring nullable

Structured lifecycle state: awaiting_coinbase_completion, settlement_detected, transfer_submitted, needs_attention