Satim Java Client

A Java library for integrating with the Satim.dz payment gateway, the official interbank electronic payment system in Algeria.

This library allows merchants and developers to process payments through CIB (Carte Interbancaire) and Edahabia cards.

Requirements

• Java 11 or higher
• Satim.dz merchant credentials (username, password, terminal ID)

Merchant credentials can be obtained from CIBWeb.dz.

Current Version

The current version of the project is 1.0.0-SNAPSHOT.

Installation

Maven

Add the following dependency to your pom.xml:

<dependency>
    <groupId>com.akraml</groupId>
    <artifactId>satim-java</artifactId>
    <version>VERSION</version>
</dependency>

Gradle

For Groovy DSL, use:

implementation 'com.akraml:satim-java:VERSION'

For Kotlin DSL, use:

implementation("com.akraml:satim-java:VERSION")

Quick Start

import com.akraml.satim.SatimAPI;
import com.akraml.satim.http.SatimHttpClient;

// Initialize the client
SatimHttpClient httpClient = new ApacheHttpClient(
    "your-username",
    "your-password",
    "your-terminal-id"
);

SatimAPI api = new SatimAPI(httpClient);

// Register a payment
api.registerPayment()
    .amount(100000)
    .returnUrl("https://example.com/payment/callback")
    .execute()
    .thenAccept(reply -> {
        String paymentUrl = reply.getPaymentUrl();
        // Redirect customer to paymentUrl
    });

Documentation

For complete documentation, including detailed usage examples, API reference, and configuration options, feel free to visit the official documentation.

License

This project is licensed under the MIT License.

Disclaimer

This library is not officially affiliated with or endorsed by Satim.dz, CIBWeb.dz, or any financial institution.