jlinn / stripe-api-php Goto Github PK

View Code? Open in Web Editor NEW

82.0 10.0 13.0 242 KB

A PHP client library for Stripe's API

License: MIT License

PHP 100.00%

stripe-api-php's Introduction

stripe-api-php

A PHP client library for Stripe's API.

Documentation

More comprehensive documentation for this library can be found here.

Usage

Installing via Composer

$ php composer.phar require jlinn/stripe-api-php

Making API Calls

Initialize the client object

use Stripe\Stripe;
$stripe = new Stripe("your_api_key");

Charges calls

// create a charge
$request = $stripe->charges->createChargeRequest(350, "usd")->setCustomer($customer->getId());
$stripe->charges->createCharge($request);

//Without a Customer
$card Request = new CreateCardRequest($number, $expMonth, $expYear, $cvc);
$request = $stripe->charges->createChargeRequest(350, "usd")->setCard($card);
$stripe->charges->createCharge($request);

// retrieve a charge
$charge = $stripe->charges->getCharge("charge_id");

Customers calls

use Stripe\Request\Cards\CreateCardRequest;

// create a customer
$request = $stripe->customers->createCustomerRequest();
$request->setEmail("[email protected]")->setDescription("A customer!");
$request->setCard(new CreateCardRequest("4242424242424242", 1, 2020));
$customer = $stripe->customers->createCustomer($request);
// get the newly-created customer's id
$customerId = $customer->getId();

// retrieve a customer
$customer = $stripe->customers()->getCustomer("customer_id");

Development Status

Currently, all Stripe API calls which do not require Stripe Connect have been implemented. Documentation and Stripe Connect calls are next on the to-do list.

stripe-api-php's People

Contributors

Stargazers

Watchers

Forkers

dongilbert neka pborreli hybrid1969 webmechanicx downsider raistlfiren ashwch cloudxtreme gpomer catding 5202m

stripe-api-php's Issues

Implement application fees calls

Strip Product

Hi,

I want to use product base purchase as well as normal checkout. How can I see the products and buy them?

Currently using this with the stripe api in test mode and whenever i use the customers class to get a customer with a customer id, it does not return a default card or a list of cards associated with the customer, is this the default behaviour?

Charge a card token w/o a customer

There does not seem to be any way to charge a card token that does not have a customer.

Before creating a PR I wanted to find out if you were open to having this in your lib.

guzzle/guzzle is abandoned

Hi Jlinn, I just install your project and I'm getting this error:
The package you have installed, Guzzle 3, is deprecated.
Package guzzle/guzzle is abandoned, you should avoid using it. Use guzzlehttp/guzzle instead.

Can you help me please? Thanks

Implement coupons calls

Easily create new CreateCustomerRequest

In order to create a new customer, you have to bring in the CreateCustomerRequest class via use, which is a little verbose (especially if you're using DI / Service Location to access your stripe instance). What do you think of adding a createCustomerRequest() method on this class - https://github.com/jlinn/stripe-api-php/blob/master/src/Stripe/Api/Customers.php#L17 - it would return new CreateCustomerRequest, but it saves time if you already have access to the stripe object.

Implement events calls

stripe->cards->listCards returns null

$stripe = new Stripe($stripeAPIKey);
$cards = $stripe->cards->listCards($stripeCustID);

$cards is empty when making a request for a valid customer ID.

$stripeAPIKey is valid, $stripeCustID is valid, stripe dashboard shows several cards for that customer ID.

Further, the stripe logs do not show any requests made when this is run.

Implement invoices calls

Listing entities

Firstly, I have to say that thank you for writing this Stripe API. It blows the official API out of the water.

However, I noticed an issue with list operations; I'm not sure if it's a bug or a break in BC, but the parameters "count" and "offset" aren't used by the Stripe REST API. Stripe seems to use the format:
limit: number of records (analogous to "count")
starting_after / ending_before: these are record ids, used to page the results

Also, there are other filter parameters for specific records, like "customer" and "date" for listing invoices, which it would be really useful to have access to.

Do you have plans to implement these?

Implement disputes calls

Implement discounts calls

You're rocking it!

Sorry - I don't know of another way to contact you - lol. Are you on Twitter?

So what else still needs completed that you have yet to work on? I should have some more time this week to move this forward. I'll be getting heavy into that project I need this for in the next week or so and be able to test this in real-world usage.

The main thing I see missing is comprehensive docs.

One other thing - have you considered my previous suggestion of moving this over to @thephpleague? I've got a couple packages there, and they are doing fairly well - the community around it has been great.