Skip to main content
GET
/
v1
/
payments
/
{id}
Get a payment
curl --request GET \
  --url https://api-sandbox.superbank.co/v1/payments/{id} \
  --header 'X-Api-Key: <api-key>'
{
  "id": "d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a",
  "type": "PAYOUT",
  "status": "COMPLETED",
  "source": {
    "amount": "100.00",
    "currency": "USDC",
    "rail": "SOLANA",
    "wallet_address": "8yLMnPq3RS8uvwXM2j0KUr2eZpHcVmN4tRfuGxHyW92V",
    "transaction_hash": "5wHu1qwD7q4bJCRrA..."
  },
  "destination": {
    "amount": "100.00",
    "currency": "USDC",
    "rail": "SOLANA",
    "wallet_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "transaction_hash": "5wHu1qwD7q4bJCRrA..."
  },
  "created_at": "2026-01-20T15:20:00.000Z",
  "updated_at": "2026-01-20T15:20:30.000Z",
  "settlement_request_id": "d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a",
  "fee": "0.50",
  "metadata": {
    "orderId": "order-123"
  },
  "failure_reason": "Insufficient funds",
  "completed_at": "2026-01-20T15:20:30.000Z"
}

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
id
string
required

Payment ID

Example:

"pay_abc123"

Response

Payment retrieved successfully

​
id
string
required

Payment ID

Example:

"d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a"

​
type
enum<string>
required

Payment type

Available options:
PAYOUT,
PAYIN
Example:

"PAYOUT"

​
status
enum<string>
required

Payment status

Available options:
AWAITING_FUNDS,
PENDING,
PROCESSING,
SENT,
COMPLETED,
CANCELED,
FAILED,
EXPIRED,
REFUNDED,
SCHEDULED,
UNDER_REVIEW
Example:

"COMPLETED"

​
source
object
required

Source payment details

​
destination
object
required

Destination payment details

​
created_at
string
required

Payment creation timestamp

Example:

"2026-01-20T15:20:00.000Z"

​
updated_at
string
required

Payment last update timestamp

Example:

"2026-01-20T15:20:30.000Z"

​
settlement_request_id
object

Associated settlement request ID

Example:

"d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a"

​
fee
object

Fee amount

Example:

"0.50"

​
metadata
object

Custom metadata attached to the payment

Example:
{ "orderId": "order-123" }
​
failure_reason
object

Failure reason if payment failed

Example:

"Insufficient funds"

​
completed_at
object

Payment completion timestamp

Example:

"2026-01-20T15:20:30.000Z"