git clone https://github.com/dione24/sahelpay-sdks.git
cd sahelpay-sdks/python
pip install -e .

from sahelpay import Client

sahelpay = Client(secret_key='sk_test_xxx')  # base URL https://api.sahelpay.ml dans tous les cas

payment = sahelpay.payments.create(
    amount=5000,
    provider='ORANGE_MONEY',  # seul moyen de paiement
    customer_phone='+22370123456',  # facultatif avec le checkout hébergé
    description='Commande #123',
    client_reference='order-123',
    return_url='https://votre-site.com/checkout/return?order=order-123',
    idempotency_key='order-123',  # obligatoire côté API : toujours la fournir
)

redirect(payment.redirect_url)

link = sahelpay.payment_links.create(
    name='Commande #123',
    fixed_amount=5000,  # prix imposé : le SDK envoie amount_mode FIXED
    success_redirect_url='https://votre-site.com/merci',
)

redirect(link.url)  # https://pay.sahelpay.africa/<slug>

sahelpay.payment_links.update(link.id, name='Commande #123 (bis)')
sahelpay.payment_links.delete(link.id)  # archivage définitif

failed = sahelpay.webhooks.list_logs(status='FAILED', limit=20)
for log in failed['logs']:
    sahelpay.webhooks.retry(log['id'])

order = sahelpay.secure_orders.create(
    amount=15000, description='Robe wax taille M',
    customer_phone='+22370000000', idempotency_key='order-9',
)
sahelpay.secure_orders.confirm_delivery(order['id'], '482913')

payment = sahelpay.payments.retrieve(payment.id)   # GET /v1/payments/{id}/status
print(payment.status)  # INITIATED, PENDING, SUCCESS, FAILED, EXPIRED

by_order = sahelpay.payments.search('order-123')   # par client_reference, None si introuvable

payment = sahelpay.payments.create(
    amount=4000,
    provider='ORANGE_MONEY',
    customer_phone='+22370123456',
    hosted_checkout=False,  # la simulation démarre à l'initiation
    mock=True,
    idempotency_key='test-4000-1',
)

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

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

# 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':  # dédupliquez sur event.id
        order_id = event.data.client_reference
        # Mettre à jour la commande

    return jsonify({'received': True})

# Django
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt

@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':
        pass  # Mettre à jour la commande

    return JsonResponse({'received': True})