Troubleshooting

Authentication Issues

Problem: Getting AuthenticationError

Code
 
// Solution: Verify credentials are correct
const saligpay = new SaligPay({
    clientId: process.env.SALIGPAY_CLIENT_ID, // Double-check
    clientSecret: process.env.SALIGPAY_CLIENT_SECRET, // Double-check
    env: "sandbox", // Ensure correct environment
});

// Test authentication
try {
    await saligpay.authenticate();
    console.log("Authentication successful!");
} catch (error) {
    console.error("Auth failed:", error);
}

Token Expiration

Problem: AuthenticationError: Invalid access token

Code
 
// Solution: Use ensureAuthenticated()
await saligPay.ensureAuthenticated();

// This automatically refreshes expired tokens
const checkout = await saligpay.checkout.create(options);

Validation Errors

Problem: ValidationError: Amount must be greater than 0

Code
 
// Solution: Validate input before API call
const createCheckout = async (options: CreateCheckoutOptions) => {
    if (options.amount <= 0) {
        throw new Error("Amount must be greater than 0");
    }

    if (!options.externalId) {
        throw new Error("External ID is required");
    }

    return saligpay.checkout.create(options);
};

Webhook Issues

Problem: Invalid JSON payload

Code
 
// Solution: Ensure raw body is passed to webhook handler
app.use(express.raw({ type: "application/json" }));

app.post("/webhooks/saligpay", async (req, res) => {
    await saligpay.webhooks.listen(req, res, handler);
});

Environment Setup

Problem: Module not found or import errors

Code
 
// Solution: Ensure Node.js 18+ is installed
// Check Node version
console.log(process.version); // Should be v18.x.x or higher

If using TypeScript, ensure tsconfig.json has correct module settings:

Code
 
{
    "compilerOptions": {
        "module": "NodeNext",
        "moduleResolution": "NodeNext",
        "target": "ES2022"
    }
}