Payment
A payment represents a completed or attempted charge. Payments track the amount, status, currency, and payment method used.
The unique identifier for the payment.
"pay_xxxxxxxxxxxxxx"
The current lifecycle state of this payment (e.g., 'draft', 'open', 'paid', 'void').
draft, open, paid, pending, uncollectible, unresolved, void The friendly status of the payment.
succeeded, pending, failed, past_due, canceled, price_too_low, uncollectible, refunded, auto_refunded, partially_refunded, dispute_warning, dispute_needs_response, dispute_warning_needs_response, resolution_needs_response, dispute_under_review, dispute_warning_under_review, resolution_under_review, dispute_won, dispute_warning_closed, resolution_won, dispute_lost, dispute_closed, resolution_lost, drafted, incomplete, unresolved, open_dispute, open_resolution True only for payments that are paid, have not been fully refunded, and were processed by a payment processor that allows refunds.
True when the payment status is open and its membership is in one of the retry-eligible states (active, trialing, completed, or past_due); otherwise false. Used to decide if Whop can attempt the charge again.
True when the payment is tied to a membership in past_due, the payment status is open, and the processor allows voiding payments; otherwise false.
The datetime the payment was created.
"2023-12-01T05:00:00.401Z"
The time at which this payment was successfully collected. Null if the payment has not yet succeeded. As a Unix timestamp.
"2023-12-01T05:00:00.401Z"
The time of the last payment attempt.
"2023-12-01T05:00:00.401Z"
The time of the next schedule payment retry.
"2023-12-01T05:00:00.401Z"
When an alert came in that this transaction will be disputed
"2023-12-01T05:00:00.401Z"
When the payment was refunded (if applicable).
"2023-12-01T05:00:00.401Z"
The plan attached to this payment.
The product this payment was made for
The user that made this payment.
The membership attached to this payment.
The member attached to this payment.
The tokenized payment method reference used for this payment. Null if no token was used.
The company for the payment.
The promo code used for this payment.
The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, eth, ape, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, btc, cny The total to show to the creator (excluding buyer fees).
6.9
The subtotal to show to the creator (excluding buyer fees).
6.9
The total in USD to show to the creator (excluding buyer fees).
6.9
The payment refund amount(if applicable).
6.9
Whether this payment was auto refunded or not
How much the payment is for after fees
6.9
The application fee charged on this payment.
Card network reported by the processor (e.g., 'visa', 'mastercard', 'amex'). Present only when the payment method type is 'card'.
mastercard, visa, amex, discover, unionpay, jcb, diners, link, troy, visadankort, visabancontact, china_union_pay, rupay, jcbrupay, elo, maestro, tarjeta_naranja, cirrus, nspk_mir, verve, ebt, private_label, local_brand, uatp, wexcard, uzcard, meeza, hrg_store_card, girocard, fuel_card, dankort, carnet, atm_card, china_union_payuzcard, codensa, cabal, unknown The last four digits of the card used to make this payment. Null if the payment was not made with a card.
"4242"
The address of the user who made the payment.
The type of payment instrument used for this payment (e.g., card, Cash App, iDEAL, Klarna, crypto). Null when the processor does not supply a type.
acss_debit, affirm, afterpay_clearpay, alipay, alma, amazon_pay, apple, apple_pay, au_becs_debit, bacs_debit, bancontact, billie, bizum, blik, boleto, capchase_pay, card, cashapp, claritypay, coinbase, crypto, custom, customer_balance, demo_pay, eps, eu_bank_transfer, fpx, giropay, google_pay, gopay, grabpay, id_bank_transfer, ideal, interac, kakao_pay, klarna, konbini, kr_card, kr_market, kriya, link, mb_way, mobilepay, mondu, multibanco, naver_pay, netbanking, ng_bank, ng_bank_transfer, ng_card, ng_market, ng_ussd, ng_wallet, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, paypay, payto, pix, platform_balance, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, scalapay, sepa_debit, sequra, sezzle, shop_pay, shopeepay, sofort, south_korea_market, splitit, sunbit, swish, tamara, twint, upi, us_bank_account, venmo, vipps, wechat_pay, zip, unknown The machine-readable reason this charge was created, such as initial subscription purchase, renewal cycle, or one-time payment.
subscription_create, subscription_cycle, subscription_update, one_time, manual, subscription The number of failed payment attempts for the payment.
42
If the payment failed, the reason for the failure.
The custom metadata stored on this payment. This will be copied over to the checkout configuration for which this payment was made
The number of financing installments for the payment. Present if the payment is a financing payment (e.g. Splitit, Klarna, etc.).
42
The financing transactions attached to this payment. Present if the payment is a financing payment (e.g. Splitit, Klarna, etc.).
The disputes attached to this payment. Null if the actor in context does not have the payment:dispute:read permission.
The resolution center cases opened by the customer on this payment. Null if the actor in context does not have the payment:resolution_center_case:read permission.