Load state from file

Set order status and optionally update other fields

Update state with new values

Make API request using OpenAPI signing method. Args: endpoint: API path (e.g. '/binancepay/openapi/user/c2c/parseQr')

Parse API error and return user-friendly info

Check if configuration is ready for use.

Show configuration guide when config is not ready.

Payment Flow - Step 2: Confirm Payment Routes to the correct extension endpoint based on payment_type in state.

Payment Flow - Step 3: Poll payment status until final result

Decode QR code from image file. Tries pyzbar first, then opencv.

Load configuration with priority: ENV > config.json > defaults If config.json doesn't exist, create a template and show setup guide.

Unified Purchase Flow - Step 1: Parse QR Auto-detects QR type and delegates to the matching extension.

Look up extension by payment_type string (e.g. 'C2C', 'PIX').

Get current order status

Make API request and parse response with given class. Used by extensions to call APIs with their own response models. Args:

Mark the end of an API call

Get file metadata for debugging/transparency.

Build the state_helpers dict that extensions use to manage state.

Make OpenAPI-style request with header-based signature. Signature format: HMAC-SHA512(payload, api_secret) Payload: timestamp\\n + no

Parse API response into unified format. OpenAPI format: {"status": "SUCCESS", "code": "000000", "data": {...}, "errorMessage": null}

Show configuration status and guide user to complete setup

Decode QR code from image. Three MUTUALLY EXCLUSIVE input modes (no fallback between them): - --image <path> : Decode from file path

Show help information

Generate a receive QR code / payment link. Args: config: Loaded config dict currency: Currency code (e.g. 'USDT', 'BTC'). Co

Clear state and start fresh

Resume from current state - automatically continue the payment flow.

Set payment amount (and optionally currency) for orders without preset amount

Show current order status and next steps

Build PIX confirmPayment params (no bizType needed).

PIX poll does NOT include bizType.

Clear all state for a fresh start

Call confirmPayment endpoint (shared response format).

Create default config.json file with template and instructions.

Decode QR from clipboard image. Returns: (success: bool, qr_data: str or None, message: str)

PIX EMV QR codes contain 'br.gov.bcb.pix' as GUI identifier.

Find the matching extension for a given QR code string.

Merge endpoints from all extensions into one dict. Keys are prefixed with payment_type to avoid collisions. e.g. 'c2c_parse_qr', 'pix_parse_q

Get timestamp of last API call

Get hint for next action based on current status

Parse PIX EMV QR code (TLV format) for local preview display. This extracts merchant info from the QR data before calling the API. The A

PIX purchase flow - Step 1: Parse PIX QR code

Call queryPaymentStatus endpoint (shared response format).

Save clipboard image to file (cross-platform)

Save clipboard image to file on Linux using xclip

Save clipboard image to file on macOS using osascript

Save clipboard image to file on Windows

Save state to file

Save timestamp of API call

Validate configuration.

Wait if needed to respect API rate limits