Charge Wallet

POST

https://api.techrar.com/order/v1/merchant/wallets/topup/

This endpoint allows you to charge your wallet within techrar.

Permission

can_update_app_config - app configs update only

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.techrar.com/order/v1/merchant/wallets/topup/' \
--header 'app-id: 4' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "amount": 100
}'

Response Example

{
    "cart_price_updated": false,
    "vouchers": [
        {
            "id": 39201,
            "code": "topup",
            "title": "topup voucher",
            "discount_on": "total",
            "is_success": true,
            "item_direct_discount_overridden": false,
            "error_reason": null,
            "cashback_amount": 100.0,
            "amount": 0,
            "delivery_fee_amount": 0,
            "total_amount": 0,
            "items": []
        }
    ],
    "sub_total_amount": 100.0,
    "shipping_amount": 0.0,
    "setup_amount": 0.0,
    "net_amount": 100.0,
    "sub_total_discounts_amount": 0,
    "shipping_discounts_amount": 0,
    "total_discounts_amount": 0,
    "wallet_redeem_amount": 0.0,
    "cashback_amount": 100.0,
    "total_amount": 100.0,
    "total_amount_with_redeem": 100.0,
    "payment_methods": [
        {
            "provider_id": "myfatoorah",
            "methods": [
                {
                    "id": 11,
                    "name_en": "Apple Pay",
                    "name_ar": "أبل الدفع",
                    "image": "https://demo.myfatoorah.com/imgs/payment-methods/ap.png"
                },
                {
                    "id": 2,
                    "name_en": "VISA/MASTER",
                    "name_ar": "فيزا / ماستر",
                    "image": "https://demo.myfatoorah.com/imgs/payment-methods/vm.png"
                },
                {
                    "id": 1,
                    "name_en": "KNET",
                    "name_ar": "كي نت",
                    "image": "https://demo.myfatoorah.com/imgs/payment-methods/kn.png"
                }
            ]
        },
        {
            "provider_id": "tabby",
            "methods": [
                {
                    "id": "0",
                    "name_en": "Pay With Installments",
                    "name_ar": "Pay With Installments",
                    "image": null
                }
            ]
        },
        {
            "provider_id": "tamara",
            "methods": [
                {
                    "id": 4,
                    "name_en": "Pay with 4 Installments",
                    "name_ar": "ادفع على 4 دفعات",
                    "image": null
                }
            ]
        }
    ],
    "currency": "SAR",
    "order": {
        "id": 316,
        "created_at": "2025-07-01T16:22:47.706705+03:00",
        "status": "pending",
        "sub_total_amount": 100.0,
        "shipping_amount": 0.0,
        "net_amount": 100.0,
        "setup_amount": 0.0,
        "sub_total_discounts_amount": 0.0,
        "shipping_discounts_amount": 0.0,
        "total_discounts_amount": 0.0,
        "wallet_redeem_amount": 0.0,
        "total_amount": 100.0,
        "total_amount_with_redeem": 100.0,
        "currency": "SAR",
        "notes": null,
        "items": [
            {
                "id": 386,
                "item": {
                    "id": 125,
                    "custom_fields": null,
                    "images": [],
                    "discount": {
                        "is_applied": false,
                        "is_trial_applied": false,
                        "is_usage_price": false,
                        "price_after_discount_no_trial": 1.0,
                        "price_after_discount": 1.0
                    },
                    "stock": {
                        "in_stock": true,
                        "qty": 100
                    },
                    "modifiers": [],
                    "variants": [],
                    "varies_on": null,
                    "bundle_categories": [],
                    "plan_config": null,
                    "off_days": [],
                    "off_dates": [],
                    "app_id": 4,
                    "ordering": 0,
                    "type": "product",
                    "service_type": "digital",
                    "sku": "topup_item",
                    "price": 1.0,
                    "name_en": "Topup Item",
                    "name_ar": "عنصر الشحن",
                    "description_en": null,
                    "description_ar": null,
                    "is_plan_only": false,
                    "is_plan_enabled": false,
                    "served_from_date": null,
                    "served_to_date": null,
                    "served_from_time": null,
                    "served_to_time": null,
                    "categories": [
                        1,
                        7
                    ]
                },
                "name_en": "Topup Item",
                "name_ar": "عنصر الشحن",
                "price_before_discount": 1.0,
                "price_after_discount": 1.0,
                "qty": 100,
                "net_price": 100.0,
                "voucher_discounts_amount": 0.0,
                "total_price": 100.0,
                "auto_renew": false,
                "date": null,
                "time": null,
                "parent_order_item": null
            }
        ],
        "custom_fields": null
    },
    "checkout_url": "http://localhost:8000/order/v1/checkout/316/?entity=order"
}

Modified at 2025-07-03 07:47:20

Wallet Details

Merchant Settings