Skip to main content
GET
/
v1
/
accounts
/
{account_id}
/
payins
/
{payin_id}
Get Payin
curl --request GET \
  --url https://api.hopnow.io/v1/accounts/{account_id}/payins/{payin_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "account_id": "<string>",
  "amount": "<string>",
  "currency": "<string>",
  "network": "<string>",
  "amount_in_usd": "<string>",
  "status": "<string>",
  "payment_method": "<string>",
  "payin_type": "<string>",
  "note": "<string>",
  "txn_hash": "<string>",
  "provider_reference_id": "<string>",
  "initiated_at": "<string>",
  "completed_at": "<string>",
  "failed_at": "<string>",
  "failed_reason": "<string>",
  "created": "<string>",
  "updated": "<string>"
}

​
Path Parameters

​
account_id
string
required
The account’s external ID (starts with acc_)
​
payin_id
string
required
The payin’s external ID (starts with pi_)

​
Response

​
id
string
Payin identifier (starts with pi_)
​
object
string
Always returns "payin"
​
account_id
string
Account ID
​
amount
string
Payin amount (decimal)
​
currency
string
Currency code
​
network
string
Blockchain network (for crypto payins)
​
amount_in_usd
string
Amount converted to USD
​
status
string
Payin status: pending, processing, completed, or failed
​
payment_method
string
Payment method (e.g., crypto, manual, bank_transfer)
​
payin_type
string
Type of payin: standard or manual
​
note
string
Optional note
​
txn_hash
string
Blockchain transaction hash (for crypto payins)
​
provider_reference_id
string
Provider reference ID
​
initiated_at
string
ISO 8601 timestamp when payin was initiated
​
completed_at
string
ISO 8601 timestamp when payin completed
​
failed_at
string
ISO 8601 timestamp when payin failed
​
failed_reason
string
Reason for failure
​
created
string
ISO 8601 timestamp when created
​
updated
string
ISO 8601 timestamp when last updated

​
Response Example

{
  "id": "pi_1234567890abcdef",
  "object": "payin",
  "account_id": "acc_1234567890abcdef",
  "amount": "1000.00",
  "currency": "USD",
  "network": null,
  "amount_in_usd": "1000.00",
  "status": "completed",
  "payment_method": "bank_transfer",
  "payin_type": "standard",
  "note": null,
  "txn_hash": null,
  "provider_reference_id": "trace_123",
  "initiated_at": "2024-01-15T10:00:00Z",
  "completed_at": "2024-01-15T10:05:00Z",
  "failed_at": null,
  "failed_reason": null,
  "created": "2024-01-15T10:00:00Z",
  "updated": "2024-01-15T10:05:00Z"
}