{
    "info": {
        "_postman_id": "marzpay-api-collection",
        "name": "MarzPay API",
        "description": "Official Postman collection for the MarzPay merchant API. Set collection variables apiKey and apiSecret.\n\nDocs: https://wallet.wearemarz.com/documentation",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "auth": {
        "type": "basic",
        "basic": [
            {
                "key": "username",
                "value": "{{apiKey}}",
                "type": "string"
            },
            {
                "key": "password",
                "value": "{{apiSecret}}",
                "type": "string"
            }
        ]
    },
    "variable": [
        {
            "key": "baseUrl",
            "value": "https://wallet.wearemarz.com/api/v1"
        },
        {
            "key": "apiKey",
            "value": ""
        },
        {
            "key": "apiSecret",
            "value": ""
        },
        {
            "key": "transactionUuid",
            "value": ""
        },
        {
            "key": "reference",
            "value": ""
        },
        {
            "key": "webhookUuid",
            "value": ""
        },
        {
            "key": "serviceUuid",
            "value": ""
        }
    ],
    "item": [
        {
            "name": "Balance",
            "item": [
                {
                    "name": "GET /balance",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/balance"
                    }
                },
                {
                    "name": "GET /balance/history",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/balance/history"
                    }
                }
            ]
        },
        {
            "name": "Collections",
            "item": [
                {
                    "name": "POST /collect-money",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/collect-money",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"amount\":5000,\"phone_number\":\"+256712345678\",\"reference\":\"c97fae8b-9b7f-4192-9f72-6f0859d33e67\",\"country\":\"UG\",\"callback_url\":\"https://your-app.com/webhooks/marzpay\"}"
                        }
                    }
                },
                {
                    "name": "Card collection",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/collect-money",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"amount\":5000,\"method\":\"card\",\"reference\":\"123e4567-e89b-12d3-a456-426614174000\",\"country\":\"UG\"}"
                        }
                    }
                },
                {
                    "name": "GET /collect-money/services",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/collect-money/services"
                    }
                },
                {
                    "name": "Get collection",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/collect-money/{{transactionUuid}}"
                    }
                }
            ]
        },
        {
            "name": "Send Money",
            "item": [
                {
                    "name": "POST /send-money",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/send-money",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"amount\":10000,\"phone_number\":\"+256712345678\",\"reference\":\"payout-001\",\"country\":\"UG\"}"
                        }
                    }
                },
                {
                    "name": "GET /send-money/services",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/send-money/services"
                    }
                },
                {
                    "name": "Get disbursement",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/send-money/{{transactionUuid}}"
                    }
                }
            ]
        },
        {
            "name": "Bank Transfer",
            "item": [
                {
                    "name": "Validate account",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bank-transfer/validate",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"bank_name\":\"Equity Bank\",\"account_number\":\"60001256421\"}"
                        }
                    }
                },
                {
                    "name": "POST /bank-transfer",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bank-transfer",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"amount\":100000,\"description\":\"Vendor payment\",\"bank_name\":\"Equity Bank\",\"bank_account_number\":\"60001256421\",\"wallet_source\":\"main\"}"
                        }
                    }
                },
                {
                    "name": "GET /bank-transfer/banks",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bank-transfer/banks"
                    }
                },
                {
                    "name": "GET /bank-transfer/services",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bank-transfer/services"
                    }
                },
                {
                    "name": "Get transfer",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bank-transfer/{{reference}}"
                    }
                }
            ]
        },
        {
            "name": "Bill Payments",
            "item": [
                {
                    "name": "Verify LIGHT",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bill-payment/verify",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"utility_code\":\"LIGHT\",\"meter_number\":\"12345678901\"}"
                        }
                    }
                },
                {
                    "name": "POST /bill-payment",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bill-payment",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"reference\":\"550e8400-e29b-41d4-a716-446655440000\",\"utility_code\":\"LIGHT\",\"meter_number\":\"12345678901\",\"phone_number\":\"+256700000000\",\"amount\":10000}"
                        }
                    }
                },
                {
                    "name": "GET /bill-payment/services",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bill-payment/services"
                    }
                },
                {
                    "name": "GET /bill-payment/nwsc/areas",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bill-payment/nwsc/areas"
                    }
                },
                {
                    "name": "GET /bill-payment/dstv/bouquet-codes",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bill-payment/dstv/bouquet-codes"
                    }
                },
                {
                    "name": "GET /bill-payment/gotv/bouquet-codes",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bill-payment/gotv/bouquet-codes"
                    }
                },
                {
                    "name": "List payments",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bill-payment"
                    }
                },
                {
                    "name": "Get payment",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/bill-payment/{{reference}}"
                    }
                }
            ]
        },
        {
            "name": "Airtime & Data",
            "item": [
                {
                    "name": "GET /airtime-data/catalog",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/airtime-data/catalog"
                    }
                },
                {
                    "name": "Detect network",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/airtime-data/detect-network?msisdn=256771234567"
                    }
                },
                {
                    "name": "Buy airtime",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/airtime-data",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"reference\":\"550e8400-e29b-41d4-a716-446655440000\",\"purchase_type\":\"airtime\",\"msisdn\":\"256771234567\",\"amount\":5000}"
                        }
                    }
                },
                {
                    "name": "Buy bundle",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/airtime-data",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"reference\":\"660e8400-e29b-41d4-a716-446655440001\",\"purchase_type\":\"bundle\",\"msisdn\":\"256771234567\",\"bundle_id\":\"RACT_UG_Data_201\"}"
                        }
                    }
                },
                {
                    "name": "List purchases",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/airtime-data"
                    }
                },
                {
                    "name": "Get purchase",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/airtime-data/{{reference}}"
                    }
                }
            ]
        },
        {
            "name": "Phone Verification",
            "item": [
                {
                    "name": "POST /phone-verification/verify",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/phone-verification/verify",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"phone_number\":\"256712345678\"}"
                        }
                    }
                },
                {
                    "name": "GET /phone-verification/service-info",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/phone-verification/service-info"
                    }
                },
                {
                    "name": "GET /phone-verification/subscription-status",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/phone-verification/subscription-status"
                    }
                }
            ]
        },
        {
            "name": "Transactions",
            "item": [
                {
                    "name": "GET /transactions",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/transactions"
                    }
                },
                {
                    "name": "GET /transactions/by id",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/transactions/{{transactionUuid}}"
                    }
                }
            ]
        },
        {
            "name": "Services",
            "item": [
                {
                    "name": "GET /services",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/services"
                    }
                },
                {
                    "name": "GET /services/by id",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/services/{{serviceUuid}}"
                    }
                }
            ]
        },
        {
            "name": "Account",
            "item": [
                {
                    "name": "GET /account",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/account"
                    }
                }
            ]
        },
        {
            "name": "Webhooks",
            "item": [
                {
                    "name": "GET /webhooks",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/webhooks"
                    }
                },
                {
                    "name": "POST /webhooks",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/webhooks",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"name\":\"Production\",\"url\":\"https://your-app.com/webhooks/marzpay\",\"event_type\":\"collection.completed\",\"environment\":\"production\",\"is_active\":true}"
                        }
                    }
                },
                {
                    "name": "GET /webhooks/by id",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "url": "{{baseUrl}}/webhooks/{{webhookUuid}}"
                    }
                }
            ]
        }
    ]
}