README.md

Python Mycelium Gear API

Access all API features of https://gear.mycelium.com. API documentation is available at https://admin.gear.mycelium.com/docs

Create a bitcoin payment gateway for your eshop. Create custom orders with Mycelium Gear Gateway.

Create new Gateway

In order to use Mycelium Gear API you need to get a gateway ID and secret. Create new gateway here.

Don't forget to save your gateway secret somewhere safe!

Examples

Prepare class object

from mycelium_gear import MyCeliumGear 
mg = MyCeliumGear(MYCELIUMGEAR_GATEWAY_ID, MYCELIUMGEAR_GATEWAY_SECRET)

Create order

amount = 30  # 30$ for example
keychain_id = 0

order = mg.create_order(amount, keychain_id)

order_id = order['order_id']  # Needed for callback requests
payment_id = order['payment_id']  # Needed for cancelling and fetching order

Example order

{
  'address': 'mneywByC3o1jpZ1FOi7LMvY21SwwTLjQ65',
  'amount': 367380,
  'amount_in_btc': '0.0036738',
  'amount_paid_in_btc': '0.0',
  'amount_to_pay_in_btc': '0.0036738',
  'id': 216041,
  'keychain_id': 7,
  'last_keychain_id': 7,
  'payment_id': '10916e608d3a433ca29c12a7616q26798203a951cb51ea6fabe4411a9797dce5',
  'status': 0,
  'tid': None,
  'transaction_ids': []
}

Cancel order

mg.cancel_order(payment_id)

Manualy Check order status

order = mg.check_order(payment_id)

Check order status from Gear's webhook

flask implement

@app.route('/mycelium/callback')
def mycelium_callback():
    if mg.is_order_callback_valid('GET',
                                  request.url, 
                                  request.headers.get('X-Signature')):
        
        data = request.args
        # work with data
        order_status = data['status']
        # and so on...
    return '', 200

Support me

Bitcoin donations are welcome at 1BDF5Uyo8PXRMXiRCv2njktdQJZhxEPvaY. Thank you!