Get transaction for payment intent

Retrieve the current transaction status and deposit instructions for an intent.

Use this endpoint to poll for transaction status updates. Recommended polling interval is every 5 seconds while the transaction is in PENDING or IN_PROGRESS status. Stop polling when the transaction reaches a terminal state (SUCCESS, FAILED, CANCELLED).

GET /intent/{intentId}/transaction

Get transaction for payment intent

cURL

curl --request GET \
  --url https://api.gnosisramp.io/v1/intent/{intentId}/transaction \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "txn_123",
  "intentId": "intent_123",
  "status": "PENDING",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "providerReference": "noah_txn_abc123",
  "lastActivityAt": "2024-01-01T00:00:00.000Z",
  "context": {}
}

Authorizations

Authorization · string · header · required

GnosisRamp JWT bearer token for authenticated customer requests

Path Parameters

intentId · string · required

Intent identifier

Response

200

application/json

Transaction details

Money movement transaction

id · string · required

Unique transaction identifier

Example:

"txn_123"

intentId · string · required

Associated intent identifier

Example:

"intent_123"

status · enum<string> · required

Money movement transaction status

Available options: PENDING, IN_PROGRESS, SUCCESS, FAILED, CANCELLED

Example:

"PENDING"

createdAt · string<date-time> · required

Transaction creation timestamp

Example:

"2024-01-01T00:00:00.000Z"

updatedAt · string<date-time> · required

Transaction last update timestamp

Example:

"2024-01-01T00:00:00.000Z"

providerReference · string | null

Provider-specific transaction reference

Example:

"noah_txn_abc123"

lastActivityAt · string<date-time> | null

Last activity timestamp

Example:

"2024-01-01T00:00:00.000Z"

context · object

Transaction context including deposit instructions