README

Laravel Binance C2B integration

Binance Merchant Acquiring (C2B) integration made for Laravel 8.

Getting started

This integration covers the next API functions:

• Create Order
• Query Order
• Close Order
• Refund Order
• Query Refund Order
• Wallet Balance Query V2

This integration complies with the protocol rules and generates the requests headers as specified by Binance.

Installation

To start using the integration in your project you have to:

1. Install the composer package using composer require persiscal/binance.
2. Configure your .env with the .env variables, replacing the default BINANCE_KEY and BINANCE_SECRET with your Binance C2B credentials.
3. Configure your web routes as in the web routes.
4. (Optional) Configure the binance-api successRouteName, cancelRouteName and webhookRouteName if needed.

Testing

This package contains two commands.

The first one will return the balance of the account.

php artisan binance:get-balance

The latter one may help to test and troubleshoot the creation, querying and closing of a test order.

php artisan binance:test-order

Support

If you're having an issue or you find a bug, feel free to send me an email to gcampana@persiscal.com.

Roadmap

• Webhook signature verification
• Webhook order verification
• Refund order verification

Contributing

Please refer to each project's style and contribution guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow.

1. Fork the repo on GitLab
2. Clone the project to your own machine
3. Commit changes to your own branch
4. Push your work back up to your fork
5. Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

Authors

• Gaston Campana Piarrou - Member of Persiscal

Aknowledgement

• Nonce string generation made by Monyancha
• HandlesResponseErrors trait inspired on TechTailor

License

The MIT License (MIT). Please see License File for more information.