go-pay/gopay
Gopay
GoPay is a Go SDK that aggregates multiple Chinese and international payment gateways behind a single, unified interface. It provides a consistent API for creating payment orders, processing refunds, handling asynchronous gateway callbacks, and querying transaction statuses across providers like Alipay and WeChat Pay.
The SDK abstracts away the differences between individual payment gateways through a gateway-agnostic interface, with built-in callback signature verification, error-code normalization, and request-response serialization. It includes dedicated client factories for each payment provider, using Go struct tags to map SDK fields to gateway-specific parameters at runtime.
Beyond core payment operations, GoPay supports retrieving user identifiers via OAuth authorization code exchange, generating mini-program payment parameters, and downloading settlement reports for reconciliation. The library handles the full payment order lifecycle, from creation through refund processing and status tracking, with consistent Go types and error handling across all supported gateways.
Features
- Payment Gateways - Integrates multiple Chinese and international payment gateways through a single Go SDK, handling order creation, callbacks, and refunds uniformly.
- Alipay Integrations - Handles Alipay payment flows such as order creation, callback verification, and refunds using Go code.
- Callback Handlers - Receives, validates, and responds to asynchronous payment notifications from various gateways in a Go service.
- Callback Parsers - Decodes and unmarshals asynchronous payment notifications from gateways into structured Go types.
- Multi-Provider SDKs - An SDK that unifies WeChat Pay, Alipay, and other Chinese payment gateways under a single Go interface for order creation, refunds, and callback handling.
- WeChat Pay Integrations - Implements WeChat Pay payment, refund, and notification verification APIs for server-side Go integration.
- Multi-Provider Payment Aggregations - A Go SDK that abstracts multiple Chinese payment providers behind a common API for creating orders, processing refunds, and handling gateway callbacks.
- Payment Order Management - Creates, queries, and reconciles payment orders across multiple gateways with consistent Go types and error handling.
- Order Creation Requests - Initiates payment requests to supported gateways, returning prepay IDs or order data for client-side checkout.
- Transaction Status Queries - Retrieves the current state of a payment order from the gateway, such as success, failure, or pending.
- Refund Processing Engines - Issues full or partial refunds across supported payment gateways and tracks refund status from a single Go interface.
- Refund Request Senders - Sends refund requests for completed transactions and tracks refund status through the gateway.
- Payment Transaction Callbacks - Receives and validates asynchronous payment notifications from gateways, responding with success or failure acknowledgments.
- Webhook Signature Verifiers - Validates incoming webhook payloads by recomputing HMAC or RSA signatures before dispatching to user code.
- Payment Signature Verification - Validates cryptographic signatures on incoming gateway callbacks to confirm payment notification authenticity.
- Payment Gateway Abstractions - Defines a unified Go interface that wraps multiple payment gateways behind a single method contract.
- Payment Parameter Generators - Generates the signed parameters required to start a payment from a mini-program front end.
- Order Status Queries - Queries the current status and details of payment orders using transaction identifiers.
- Struct Tag Mapping Utilities - Uses Go struct tags to map SDK fields to gateway-specific request parameters at runtime.
- Gateway Error Code Translators - Translates diverse gateway error codes into a consistent set of Go error types for unified handling.
- Gateway Format Serializers - Converts Go structs to gateway-native formats (JSON/XML) and back, handling field naming and nesting differences.
- Payment Client Factories - Creates isolated client instances per payment provider, each with its own endpoint, key, and serialization logic.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
