Payments Module

Wallet Charging

Execute secure deposit operations using external payment gateways. ShieldPay Engine integrates with providers like Stripe to facilitate real-time wallet funding.

How it works

When a user requests to charge their wallet, the engine communicates with the payment gateway to generate a unique Payment URL. The user is redirected to complete the transaction, and ShieldPay listens for a Webhook/Callback to verify the success and update the balance.

POST

Initiate Wallet Charge

Generates a secure payment link. The user must be redirected to the returned payment_url to complete the transaction.

Endpoint


                http://shield-pay.adhameldouh.com/api/v1/wallet/charge

Request Body

Param	Type	Required
amount	decimal	YES

**Note:** Transaction IDs are generated internally to track the status before the redirect.

JSON Response

200 OK

{
    "success": true,
    "method": "stripe"
    "url": "https://paymob.com/api/pay/...",
}

ShieldPay Card

4242 4242 4242 4242

Expiry Date 02 / 29

CVV 123