Skip to main content
GET
Get payment transaction

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the Base44 app.

transaction_id
string
required

ID of the transaction, taken from transaction_id on a row from List payment transactions.

Query Parameters

provider
enum<string>
required

Payment provider whose transactions to use. Either stripe or wix. stripe covers payments taken through the app's Stripe integration, and wix covers payments taken through Wix Payments (Base44 Payments). The provider has to be connected to the app.

Available options:
stripe,
wix
timestamp
string<date-time> | null

The row's own timestamp from List payment transactions, which makes the lookup faster. Leave it out rather than guess, since a wrong value can make the transaction look like it isn't the app's.

action
enum<string> | null

The row's own action from the transactions list. Either payment or refund. Send refund for a refund row so the payment it refunded is returned. Defaults to payment.

Available options:
payment,
refund

Response

The payment, as the provider reports it now.

One payment in full, as its payment provider reports it.

transaction_id
string
required

Provider ID of the payment. For Stripe this is the charge, which can differ from the ID you looked it up by.

Example:

"ch_T7mK2p9Q4r6S8v"

status
string
default:""

Where the payment stands. Either succeeded, pending, failed, refunded, partially_refunded, pending_refund, or chargeback. Other provider values come through in lowercase.

Example:

"partially_refunded"

payment_type
string
default:""

Either one_time or recurring, or an empty string when the provider doesn't say.

Example:

"one_time"

created_date
string
default:""

When the payment was made, as an ISO 8601 timestamp. Empty when the provider doesn't say.

Example:

"2026-08-25T10:00:00Z"

currency
string
default:USD

Three-letter ISO 4217 code of the payment's currency, in uppercase. Defaults to USD.

Example:

"USD"

amount
integer
default:0

Amount paid, in the smallest unit of the payment's currency.

Example:

2500

fee
integer | null

Processing fee the provider took, in the smallest unit of the payment's currency, or null when none was taken, as on a declined payment.

Example:

103

net
integer | null

What the merchant kept after the fee, in the smallest unit of the payment's currency, or null when no money moved.

Example:

2397

service_fee
integer | null

Application fee taken on top of the processing fee, in the smallest unit of the payment's currency, or null when there is none.

Example:

50

refunded_amount
integer
default:0

Total refunded so far, in the smallest unit of the payment's currency.

Example:

1000

refunds
TransactionRefund · object[]

Refunds against the payment. Empty when there are none.

Example:
method_kind
string
default:""

Payment method type as the provider names it, for example card. Empty when the provider doesn't say.

Example:

"card"

method_moto
boolean
default:false

true when the merchant entered the card for the customer, as in a phone or mail order, and false otherwise. Always false for Stripe.

Example:

false

card_network
string | null

Card network, or null when the payment wasn't by card.

Example:

"visa"

card_masked
string | null

Masked card number, or null when the payment wasn't by card. Stripe gives only the last four digits.

Example:

"4242"

card_holder
string | null

Cardholder name, or null when the provider doesn't have it.

Example:

"Jane Doe"

provider_id
string
default:""

Processor that handled the payment. Always stripe for Stripe. For Wix, the processor Wix routed the payment through.

Example:

"stripe"

merchant_account_id
string | null

Merchant account at the processor, or null when unknown. Always null for Stripe.

Example:

"4f1c2a7e-9b3d-4e8f-a6c5-2d7e9f0b1a3c"

display_order_id
string | null

Order number shown to the customer, or null when there is none. Always null for Stripe.

Example:

"10042"

items
TransactionOrderItem · object[]

Items bought. Empty when the provider doesn't list them.

Example:
billing
TransactionAddress · object | null

Billing details the customer gave, or null when there are none.

Example:
shipping
TransactionAddress · object | null

Shipping details, or null when the payment has none.

Example:
disputes
TransactionDispute · object[]

Disputes against the payment. Empty when there are none.

Example:
history
TransactionHistoryEvent · object[]

Timeline of the payment, its refunds, and its disputes, newest first.

Example:
decline_reason
string | null

Why the payment was declined, as the provider words it, or null when it wasn't declined.

Example:

"Your card has insufficient funds."