-
Notifications
You must be signed in to change notification settings - Fork 850
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #649 from stripe/remi-add-customer-balance-transac…
…tions Add support for Customer Balance Transaction resource and APIs
- Loading branch information
Showing
9 changed files
with
205 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,88 @@ | ||
<?php | ||
|
||
namespace Stripe; | ||
|
||
/** | ||
* Class CustomerBalanceTransaction | ||
* | ||
* @package Stripe | ||
* | ||
* @property string $id | ||
* @property string $object | ||
* @property int $amount | ||
* @property string $credit_note | ||
* @property int $created | ||
* @property string $currency | ||
* @property string $customer | ||
* @property string $description | ||
* @property int $ending_balance | ||
* @property string $invoice | ||
* @property bool $livemode | ||
* @property StripeObject $metadata | ||
* @property string $type | ||
*/ | ||
class CustomerBalanceTransaction extends ApiResource | ||
{ | ||
const OBJECT_NAME = "customer_balance_transaction"; | ||
|
||
/** | ||
* Possible string representations of a balance transaction's type. | ||
* @link https://stripe.com/docs/api/customers/customer_balance_transaction_object#customer_balance_transaction_object-type | ||
*/ | ||
const TYPE_ADJUSTEMENT = 'adjustment'; | ||
const TYPE_APPLIED_TO_INVOICE = 'applied_to_invoice'; | ||
const TYPE_CREDIT_NOTE = 'credit_note'; | ||
const TYPE_INITIAL = 'initial'; | ||
const TYPE_INVOICE_TOO_LARGE = 'invoice_too_large'; | ||
const TYPE_INVOICE_TOO_SMALL = 'invoice_too_small'; | ||
const TYPE_UNSPENT_RECEIVER_CREDIT = 'unspent_receiver_credit'; | ||
|
||
/** | ||
* @return string The API URL for this balance transaction. | ||
*/ | ||
public function instanceUrl() | ||
{ | ||
$id = $this['id']; | ||
$customer = $this['customer']; | ||
if (!$id) { | ||
throw new Error\InvalidRequest( | ||
"Could not determine which URL to request: class instance has invalid ID: $id", | ||
null | ||
); | ||
} | ||
$id = Util\Util::utf8($id); | ||
$customer = Util\Util::utf8($customer); | ||
|
||
$base = Customer::classUrl(); | ||
$customerExtn = urlencode($customer); | ||
$extn = urlencode($id); | ||
return "$base/$customerExtn/balance_transactions/$extn"; | ||
} | ||
|
||
/** | ||
* @param array|string $_id | ||
* @param array|string|null $_opts | ||
* | ||
* @throws \Stripe\Error\InvalidRequest | ||
*/ | ||
public static function retrieve($_id, $_opts = null) | ||
{ | ||
$msg = "Customer Balance Transactions cannot be accessed without a customer ID. " . | ||
"Retrieve a balance transaction using Customer::retrieveBalanceTransaction('cus_123', 'cbtxn_123') instead."; | ||
throw new Error\InvalidRequest($msg, null); | ||
} | ||
|
||
/** | ||
* @param string $_id | ||
* @param array|null $_params | ||
* @param array|string|null $_options | ||
* | ||
* @throws \Stripe\Error\InvalidRequest | ||
*/ | ||
public static function update($_id, $_params = null, $_options = null) | ||
{ | ||
$msg = "Customer Balance Transactions cannot be accessed without a customer ID. " . | ||
"Update a balance transaction using Customer::updateBalanceTransaction('cus_123', 'cbtxn_123', $params) instead."; | ||
throw new Error\InvalidRequest($msg, null); | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
<?php | ||
|
||
namespace Stripe; | ||
|
||
class CustomerBalanceTransactionTest extends TestCase | ||
{ | ||
const TEST_CUSTOMER_ID = 'cus_123'; | ||
const TEST_RESOURCE_ID = 'cbtxn_123'; | ||
|
||
public function testHasCorrectUrl() | ||
{ | ||
$resource = \Stripe\Customer::retrieveBalanceTransaction(self::TEST_CUSTOMER_ID, self::TEST_RESOURCE_ID); | ||
$this->assertSame( | ||
"/v1/customers/" . self::TEST_CUSTOMER_ID . "/balance_transactions/" . self::TEST_RESOURCE_ID, | ||
$resource->instanceUrl() | ||
); | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters