Test mode: Create a ReceivedCredit Test helper

Use this endpoint to simulate a test mode ReceivedCredit initiated by a third party. In live mode, you can’t directly create ReceivedCredits initiated by third parties.

Parameters

  • amountintegerRequired

    Amount (in cents) to be transferred.

  • currencyenumRequired

    Three-letter ISO currency code, in lowercase. Must be a supported currency.

  • financial_accountstringRequired

    The FinancialAccount to send funds to.

  • networkenumRequired

    Specifies the network rails to be used. If not set, will default to the PaymentMethod’s preferred network. See the docs to learn more about money movement timelines for each network type.

  • descriptionstring

    An arbitrary string attached to the object. Often useful for displaying to users.

  • initiating_payment_method_detailsobject

    Initiating payment method details for the object.

Returns

A test mode ReceivedCredit object.

POST /v1/test_helpers/treasury/received_credits
curl https://api.stripe.com/v1/test_helpers/treasury/received_credits \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d amount=1000 \
-d currency=usd \
-d financial_account=fa_1MtkSr2eZvKYlo2CsJozwFWD \
-d network=ach
Response
{
"id": "rc_1MtkSr2eZvKYlo2CcysvUbEw",
"object": "treasury.received_credit",
"amount": 1000,
"created": 1680755425,
"currency": "usd",
"description": "Stripe Test",
"failure_code": null,
"financial_account": "fa_1MtkSr2eZvKYlo2CsJozwFWD",
"hosted_regulatory_receipt_url": "https://payments.stripe.com/regulatory-receipt/CBQaFwoVYWNjdF8xMDMyRDgyZVp2S1lsbzJDKOKVuaEGMgagXvSInCY6NpMvimqdsEKNHRrHZ3OGyVm_l5LfDMezNeY83F5Mq-rryXZ-J1z-jfFBv30wz5WxDH97VRBIzw",
"initiating_payment_method_details": {
"billing_details": {
"address": {
"city": null,
"country": null,
"line1": null,
"line2": null,
"postal_code": null,
"state": null
},
"email": null,
"name": "Jane Austen"
},
"type": "us_bank_account",
"us_bank_account": {
"bank_name": "STRIPE TEST BANK",
"last4": "6789",
"routing_number": "110000000"
}
},
"linked_flows": {
"credit_reversal": null,
"issuing_authorization": null,
"issuing_transaction": null,
"source_flow": null,
"source_flow_type": null
},
"livemode": false,
"network": "ach",
"reversal_details": {
"deadline": 1681084800,
"restricted_reason": null
},
"status": "succeeded",
"transaction": "trxn_1MtkSr2eZvKYlo2CuFFh9Rh0"
}

Received Debits 

ReceivedDebits represent funds pulled from a FinancialAccount. These are not initiated from the FinancialAccount.

Credit Reversals 

You can reverse some ReceivedCredits depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal.

Debit Reversals 

You can reverse some ReceivedDebits depending on their network and source flow. Reversing a ReceivedDebit leads to the creation of a new object known as a DebitReversal.

Feature 

A feature represents a monetizable ability or functionality in your system. Features can be assigned to products, and when those products are purchased, Stripe will create an entitlement to the feature for the purchasing customer.