Skip to main content
GET
/
v1
/
platform
/
businesses
/
{business_id}
/
invoices
/
refunds
/
{refund_id}
/
payments
/
{payment_id}
Fetch refund payment
curl --request GET \
  --url https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/invoices/refunds/{refund_id}/payments/{payment_id}/ \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "refund_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "refunded_amount": 123,
  "refund_processing_fee": 123,
  "reconciled_bank_transactions": [
    {
      "bank_transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bank_transaction_date": "2023-11-07T05:31:56Z",
      "bank_transaction_amount_cents": 123,
      "bank_transaction_direction": "<string>",
      "reconciled_amount_cents": 123,
      "reconciliation_link_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "reconciled_at": "2023-11-07T05:31:56Z",
      "currency": "<string>",
      "payment_type": "<string>",
      "bank_account_name": "<string>",
      "notes": "<string>"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "external_id": "<string>",
  "completed_at": "2023-11-07T05:31:56Z",
  "method": "BANK_TRANSFER",
  "processor": "<string>",
  "transaction_tags": "<unknown>",
  "memo": "<string>",
  "metadata": "<unknown>"
}

Authorizations

​
Authorization
string
header
required

Partner-level JWT token (unscoped). Token payload includes partner_id. Business access is validated via partner ownership. Format: Bearer <your-jwt-token>

Use this for: Multi-business operations where the business_id is specified in the URL and partner has access to multiple businesses.

Path Parameters

​
business_id
string
required
​
payment_id
string<uuid>
required

A UUID string identifying this refund payment.

​
refund_id
string
required

Response

Serializer for refund payments. All amounts in cents.

​
id
string<uuid>
required

Unique refund payment identifier

​
refund_id
string<uuid>
required

ID of the refund this payment belongs to

​
refunded_amount
integer
required

Refunded amount in cents

​
refund_processing_fee
integer
required

Processing fee in cents

​
reconciled_bank_transactions
object[]
required

Bank transactions this refund payment is reconciled to

​
created_at
string<date-time>
required

Timestamp when refund payment record was created

​
updated_at
string<date-time>
required

Timestamp when refund payment record was last updated

​
external_id
string

Your unique identifier for idempotency (unique within refund)

Maximum string length: 255
​
completed_at
string<date-time> | null

Date and time when refund payment was completed

​
method
enum<string>

Payment method used for refund (CASH, CHECK, CREDIT_CARD, BANK_TRANSFER, etc.)

  • BANK_TRANSFER - Bank Transfer
  • CREDIT_CARD - Credit Card
  • DEBIT_CARD - Debit Card
  • ACH - ACH/Direct Debit
  • CHECK - Check/Cheque
  • CASH - Cash
  • PAYPAL - PayPal
  • STRIPE - Stripe
  • OTHER - Other
Available options:
BANK_TRANSFER,
CREDIT_CARD,
DEBIT_CARD,
ACH,
CHECK,
CASH,
PAYPAL,
STRIPE,
OTHER
​
processor
string

Payment processor used (e.g., Stripe, PayPal, manual)

Maximum string length: 100
​
transaction_tags
any

List of tags for categorization and reconciliation tracking

​
memo
string

Optional description or notes for this refund payment

​
metadata
any

Custom key-value pairs for payment context