Download the PHP package etern8ty/beanstream without Composer
On this page you can find all versions of the php package etern8ty/beanstream. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package beanstream
Bambora PHP API
Composer ready PHP wrapper for Bambora NA Payment API.
Installation
The recommended way to install the library is using Composer.
1) Add this json to your composer.json file:
2) Next, run this from the command line:
3) Finally, add this line to your php file that will be using the SDK:
Handling Exceptions
If the server returns an unexpected response or error, PHP API throws \Beanstream\Exception.
Positive error codes correspond to Beanstream API errors, see Bambora NA Payment API
Negative codes correspond to cURL errors (original cURL error codes are positive, in \Beanstream\Exception those are just reversed). Exception with zero error code are PHP API specific, e.g. The curl extension is required or Unexpected response format.
Generally, any unsuccessful request, e.g. insufficient data or declined transaction, results in \Beanstream\Exception, thus try..catch is recommended for intercepting and handling them, see example below.
Your First Integration
See examples.php for more examples.
Tips
Authentication
Beanstream defines separate API access passcodes for payment, profile and reporting API requests. It is possible to use the same value for all of them, and create a single instance of \Beanstream\Gateway. You can also initialize separate \Beanstream\Gateway instances for each type of request. API access passcodes are configured via the Beanstream dashboard (See administration -> account settings -> order settings for payment and search passcodes, configuration -> payment profile configuration for profile passcode).
Billing Address Province
Beanstream requires the province field submitted along with billing data to be a two-letter code. It only requires it when the specified country is US or CA, for other country codes set it to -- (two dashes) even if the corresponding country does have states or provinces.
Backwards Compatibility
The default $platform value assigned is 'api', which sends your requests to the endpoint 'api.na.bambora.com'. The ensure backwards compatibility, you may assign $platform = 'www' which will send your requests to the legacy endpoint 'www.beanstream.com/api'.
Ensuring TLS 1.2-Only Compatibility
If you would like to test compatibility with the LIVE TLS 1.2-only environment, assign $platform = 'tls12-api', instead of 'api'; This will point your requests to the endpoint 'tls12-api.na.bambora.com'. Please be advised that this endpoint is provided for a limited time, and is intended for integration compatibility testing only, and is not intended for any type of load tests. More details can be found on the Bambora North America Knowledge Base.
