HGPO Backend - Documentation

Overview

HGPO Backend is a Django-based service that provides backend infrastructure for e-commerce operations. It handles data synchronization between sales channels, payment processing, customer management, and automated workflows.

The service exposes REST APIs consumed by frontend applications and integrates with third-party platforms including Shopify, Amazon, Stripe, and Paperform.

Architecture

Framework: Django with Django REST Framework

Database: PostgreSQL

Task Queue: django-tasks with DatabaseBackend (production) or ImmediateBackend (development)

API Documentation: ReDoc/Swagger

Authentication: Token-based authentication

Features

Shopify Synchronization

Bi-directional sync with Shopify for customers, orders, products, and inventory. Webhooks handle real-time updates; scheduled jobs perform periodic reconciliation. Source code in shopify_sync/.
Amazon Integration

Integration with Amazon Marketplace for order management and fulfillment. Supports SP-API for programmatic access to Amazon seller data. Source code in amazon_sync/.
Stripe Payment Processing

Payment processing via Stripe API. Supports one-time payments, subscriptions, refunds, and webhook handling for payment events. Source code in stripe_app/.
Paperform Webhooks

Receives form submission webhooks from Paperform and triggers downstream workflows. Used for lead capture, surveys, and customer feedback. Source code in paperform_app/.
Payment Management

Centralized payment tracking across multiple providers. Records transactions, handles refunds, and maintains audit logs. Source code in payments/.
Background Jobs

Asynchronous task processing using django-tasks with DatabaseBackend. Tasks are defined with the @task decorator and executed by db_worker processes. Supports delayed execution and retries with exponential backoff. HTTP-triggered jobs available via asyncjobs/.
Utilities

Helper functions and administrative tools for data management, reporting, and system maintenance. Source code in misc/.

Integrations

The following external services are integrated:

Shopify: Admin API and Webhooks for store data synchronization
Amazon: Selling Partner API (SP-API) for marketplace operations
Stripe: Payment Intents API and Billing API for payment processing
Paperform: Webhook endpoints for form submissions

API Reference

Complete API documentation is available via ReDoc. All endpoints require authentication unless otherwise specified.

View API Documentation →