hyp-api

Server-side wrapper for Hyp services (Yaad-Sarig), an Israeli payment solution. Designed for Node v20 and compatible with environments like Supabase Edge Functions.

⚠️ Important Disclaimer - Use at Your Own Risk

This library was heavily built with AI.

Though I've tested it on my side for all my needs, that doesn't mean this is bulletproof.

CRITICAL WARNING: This library is provided "AS IS" without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. The author and contributors of this library assume NO RESPONSIBILITY OR LIABILITY for any consequences arising from the use of this software, including but not limited to financial losses, data breaches, security vulnerabilities, payment processing errors, compliance violations, or any other damages or losses of any kind.

By using this library, you acknowledge and agree that: (1) You are using this software entirely at your own risk and discretion; (2) You have thoroughly read, understood, and tested all source code before implementing it in any environment, especially production; (3) You are solely responsible for ensuring the library meets your specific business requirements, security standards, and compliance obligations (including but not limited to PCI DSS, GDPR, and local financial regulations); (4) You will conduct comprehensive testing in development and staging environments before any production deployment; (5) You will implement appropriate security measures, monitoring, logging, and backup procedures; (6) You understand that payment processing involves sensitive financial data and potential regulatory requirements that you must address independently; (7) You will validate all transactions, implement proper error handling, and establish appropriate fraud prevention measures; and (8) The author provides no guarantees regarding the accuracy, reliability, security, or continued functionality of this software.

This library interfaces with third-party payment services and APIs that may change without notice, potentially breaking functionality. You are responsible for staying informed about such changes and updating your implementation accordingly. Always maintain updated dependencies, monitor for security vulnerabilities, and follow industry best practices for payment processing applications. If you do not agree to these terms or cannot accept full responsibility for the implementation and consequences of using this software, DO NOT USE THIS LIBRARY.

Install

npm install hyp-api

Quick Start

import { HypClient } from 'hyp-api';

const hyp = new HypClient({
  apiKey: process.env.HYP_API_KEY,
  masof: process.env.HYP_MASOF,
});

// Create a payment page
const paymentUrl = await hyp.createPaymentLink({
  Amount: 199,
  Info: 'Product Purchase',
  UserId: 'customer_123',
  ClientName: 'John Doe',
  email: '[email protected]',
  Sign: true,
});

What's Included

• 💳 Payment Processing - Hosted pages, server-side transactions, Apple/Google Pay
• 🔄 Recurring Billing - Automated subscriptions and billing management
• 📄 Professional Invoicing - EzCount integration with itemized invoices
• 🔒 Tokenization - Secure card storage for returning customers
• ⚡ Full TypeScript - Complete type safety and IntelliSense support
• 🛡️ Built-in Security - Automatic signature verification and validation

Documentation

📖 Complete documentation available at: Hyp API Documentation

Quick Links

• Installation Guide
• Quick Start Tutorial
• Payment Flows
• Code Examples
• API Reference

Need Help?

• 📖 Browse the complete documentation
• 💡 Check out working examples
• 🐛 Report issues on GitHub Issues

⚖️ Intellectual Property & License

IMPORTANT: This software and all associated documentation are the exclusive intellectual property of Yossi Saadi.

🚫 What You CANNOT Do

• Copy or reproduce any portion of the source code
• Fork, clone, or mirror this repository
• Create derivative works based on this implementation
• Redistribute or share the source code or documentation
• Copy the comprehensive documentation or educational materials

✅ What You CAN Do

• Use this library in your applications and projects
• Install via npm/yarn and import in your code
• Call the APIs and utilize the functionality
• Read the source for understanding and debugging

🛡️ Why This Matters

The comprehensive docs, TypeScript types, error handling, and examples are original intellectual work that took significant time and expertise to create.

By using this library, you agree to respect these terms and the intellectual property rights of the author.

License

PROPRIETARY SOFTWARE LICENSE - See LICENSE file for full terms.

© 2025 Yossi Saadi. All rights reserved.