मुख्य कंटेंट तक स्किप करें

बैलेंस एपीआई फ़ंक्शन

बैलेंस प्राप्त करें​

एक Stripe खाते का बैलेंस प्राप्त करें।

एंडपॉइंट: https://api.stripe.com/v1/balance

ऑपरेशन: GET

उदाहरण​

cURL उदाहरण:

curl -X GET `https://api.stripe.com/v1/balance` \
  -u <YOUR_SECRET_KEY>:

प्रतिक्रियाएँ​

प्रतिक्रियाएँ मानक कोड लौटाएँगी।`

200: OK

{
  "object": "balance",
  "available": [
    {
      "amount": 0,
      "currency": "usd",
      "source_types": {
        "card": 0
      }
    }
  ],
  "livemode": false,
  "pending": [
    {
      "amount": 0,
      "currency": "usd",
      "source_types": {
        "card": 0
      }
    }
  ],
  "refund_and_dispute_prefunding": {
    "available": [
      {
        "amount": 0,
        "currency": "usd"
      }
    ],
    "pending": [
      {
        "amount": 0,
        "currency": "usd"
      }
    ]
  }
}

त्रुटि प्रतिक्रियाएं​

400: Bad Request

{
  "error": {
    "message": "यदि एक सरणी के बजाय स्पष्ट कुंजियों के साथ एक सरणी पास कर रहे हैं (उदाहरण के लिए foo[0]=a और foo[1]=b), तो कुंजियाँ 0 से शुरू होकर संख्यात्मक और क्रमागत होनी चाहिए। आपने कीज़ `1` पास कीं, जबकि हमें `0` मान वाली की की उम्मीद थी।",
    "param": "expand",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_kCeAL5FAly5bkh?t=1734734555",
    "type": "invalid_request_error"
  }
}

401: Unauthorized

{
  "error": {
    "type": "invalid_request_error",
    "message": "अमान्य API कुंजी प्रदान की गई: sk_test_********************1234"
  }
}

पैरामीटर​

क्वेरी पैरामीटर​
पैरामीटरप्रकारविवरण
expand[]array of stringsनिर्दिष्ट करता है कि प्रतिक्रिया में कौन से फ़ील्ड का विस्तार किया जाना चाहिए।

बैलेंस लेनदेन प्राप्त करें​

यह उन लेनदेन को लौटाता है जो Stripe खाते का बैलेंस बनाते हैं (उदाहरण के लिए, शुल्क, ट्रांसफर, भुगतान, रिफंड, आदि)। लेनदेन को क्रमबद्ध क्रम में लौटाया जाता है, जिसमें सबसे हाल के लेनदेन पहले दिखाई देते हैं।

एंडपॉइंट: https://api.stripe.com/v1/balance_transactions/{id}

ऑपरेशन: GET

उदाहरण​

cURL उदाहरण:

curl -X GET https://api.stripe.com/v1/balance_transactions/tr_1234567890 \
  -u <YOUR_SECRET_KEY>:

प्रतिक्रियाएँ​

प्रतिक्रियाएँ मानक कोड लौटाएँगी।

200: OK

{
  "object": "balance_transaction",
  "id": "tr_1234567890",
  "amount": 1000,
  "currency": "usd",
  "description": "Payment for invoice",
  "fee": 59,
  "fee_details": [
    {
      "amount": 59,
      "currency": "usd",
      "description": "Stripe processing fees",
      "type": "stripe_fee"
    }
  ],
  "net": 941,
  "status": "available",
  "type": "charge"
}

400: Bad Request

{
  "error": {
    "message": "यदि एक ऐरे के बजाय स्पष्ट कुंजियों के साथ एक ऐरे पास किया जा रहा है (जैसे foo[0]=a&foo[1]=b), तो कुंजियाँ 0 से शुरू होकर संख्यात्मक और क्रमागत होनी चाहिए। आपने कुंजियाँ `1` दीं, जबकि हमें `0` मान वाली कुंजी की उम्मीद थी।",
    "param": "expand",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_kCeAL5FAly5bkh?t=1734734555",
    "type": "invalid_request_error"
  }
}

401: Unauthorized

{
  "error": {
    "type": "invalid_request_error",
    "message": "अमान्य API कुंजी प्रदान की गई: sk_test_********************1234"
  }
}

पैरामीटर​

क्वेरी पैरामीटर​
पैरामीटरप्रकारविवरण
expand[]array of stringsनिर्दिष्ट करता है कि प्रतिक्रिया में कौन से फ़ील्ड का विस्तार किया जाना चाहिए।
पाथ वेरिएबल्स​
नामप्रकारआवश्यकविवरण
idstringRequiredपाथ वेरिएबल पहचानकर्ता