pip install sahelpay

from sahelpay import Client

sahelpay = Client(secret_key='sk_test_xxx', environment='sandbox')

link = sahelpay.payment_links.create(
    title='Commande #123',
    price=5000,
    redirect_url='https://votre-site.com/checkout/return'
)

# Rediriger le client
redirect(link.url)

payment = sahelpay.payments.retrieve('txn_abc123')

print(payment.status)  # 'PENDING', 'SUCCESS', 'FAILED'
print(payment.amount)

payment = sahelpay.payments.create(
    amount=4000,
    provider='ORANGE_MONEY',
    customer_phone='+22370123456',
    return_url='https://votre-site.com/checkout/return',
    mock=True,
)

result = sahelpay.payments.check_status(payment.id)
print(result["status"])  # SUCCESS

sahelpay.webhooks.test()  # envoie webhook.test vers votre endpoint configuré

from sahelpay import Client

sahelpay = Client(secret_key='sk_test_xxx', environment='sandbox')

# Flask
@app.route('/webhooks/sahelpay', methods=['POST'])
def webhook():
    raw_body = request.get_data(as_text=True)
    signature = request.headers.get('X-SahelPay-Signature')

    try:
        event = sahelpay.webhooks.construct_event(
            raw_body,
            signature,
            current_app.config['SAHELPAY_WEBHOOK_SECRET'],
        )
    except Exception:
        return jsonify({'error': 'Invalid signature'}), 401

    if event.event == 'payment.success':
        # Mettre à jour la commande
        pass

    return jsonify({'received': True})

from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from sahelpay import Client

sahelpay = Client(secret_key=settings.SAHELPAY_SECRET_KEY)

@csrf_exempt
def webhook(request):
    raw_body = request.body.decode('utf-8')
    signature = request.headers.get('X-SahelPay-Signature')

    try:
        event = sahelpay.webhooks.construct_event(
            raw_body,
            signature,
            settings.SAHELPAY_WEBHOOK_SECRET,
        )
    except Exception:
        return JsonResponse({'error': 'Invalid signature'}, status=401)

    if event.event == 'payment.success':
        # Mettre à jour la commande
        pass

    return JsonResponse({'received': True})

payment = client.payments.create(
    amount=5000,
    provider='ORANGE_MONEY',  # seul rail intégré aujourd'hui
    customer_phone='+22370123456',
    description='Commande #123'
)

# Informations de routing (automatique)
print(payment.gateway_used)    # Identifiant technique interne
print(payment.routing_reason)  # Explication du routing choisi

from sahelpay import has_capability, get_methods_with_capability

# Vérifier si Orange Money supporte les payouts
has_capability('ORANGE_MONEY', 'payouts')  # True

# Lister les méthodes supportant les payouts
get_methods_with_capability('payouts')  # ['ORANGE_MONEY']