GO-iPay

A Go client library for the iPay.ua Payment Gateway API. This library provides a simple and reliable way to integrate iPay.ua payment processing into your Go applications.

Features

• Simple and intuitive API
• Comprehensive error handling
• Full iPay.ua API coverage
• Thread-safe client implementation
• Configurable timeout and retry options
• Detailed logging support

Installation

go get github.com/stremovskyy/go-ipay

Documentation

Complete documentation is available in:

• Usage Guide - Comprehensive guide to using the library
• Code Examples - Real-world examples and best practices

For API reference and package documentation:

• GoDoc Documentation

Quick Start

package main

import (
    "github.com/stremovskyy/go-ipay"
)

func main() {
    // Create a new client with default options
    client := go_ipay.NewDefaultClient()

    // Configure merchant details
    merchant := &go_ipay.Merchant{
        Name:        "Your Merchant Name",
        MerchantID:  "your-merchant-id",
        MerchantKey: "your-merchant-key",
    }

    // Use the client...
}

Configuration Options

The client can be configured with various options:

client := go_ipay.NewClient(
    WithTimeout(time.Second * 30),
    WithRetryAttempts(3),
    WithLogger(customLogger),
)

Error Handling

The library provides detailed error types for better error handling:

if err != nil {
    switch e := err.(type) {
    case *go_ipay.ValidationError:
        // Handle validation error
    case *go_ipay.APIError:
        // Handle API error
    default:
        // Handle other errors
    }
}

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Please make sure to update tests as appropriate.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Security

For security issues, please email security@yourdomain.com instead of using the issue tracker.

Acknowledgments

• iPay.ua for providing the payment gateway service
• Contributors who have helped improve this library

Support

If you are having problems, please let us know by raising a new issue.