Java SDK

dependencies {
    implementation 'com.fyatu:fyatu-java:1.0.0'
}

<dependency>
    <groupId>com.fyatu</groupId>
    <artifactId>fyatu-java</artifactId>
    <version>1.0.0</version>
</dependency>

import com.fyatu.Fyatu;
import com.fyatu.model.Collection;
import com.fyatu.param.CreateCollectionParams;
import com.fyatu.param.CustomerParams;

public class Example {
    public static void main(String[] args) {
        Fyatu fyatu = Fyatu.builder()
            .appId("your_app_id")
            .secretKey("your_secret_key")
            .build();

        // Create a collection
        Collection collection = fyatu.collections().create(
            CreateCollectionParams.builder()
                .amount(10.00)
                .currency("USD")
                .reference("order_123")
                .description("Payment for Order #123")
                .customer(CustomerParams.builder()
                    .email("customer@example.com")
                    .name("Alice Example")
                    .build())
                .redirectUrl("https://yoursite.com/payment/success")
                .webhookUrl("https://yoursite.com/webhooks/fyatu")
                .build()
        );

        System.out.println(collection.getCheckoutUrl());
    }
}

# application.yml
fyatu:
  app-id: ${FYATU_APP_ID}
  secret-key: ${FYATU_SECRET_KEY}

@Configuration
@EnableConfigurationProperties(FyatuProperties.class)
public class FyatuConfig {

    @Bean
    public Fyatu fyatu(FyatuProperties properties) {
        return Fyatu.builder()
            .appId(properties.getAppId())
            .secretKey(properties.getSecretKey())
            .build();
    }
}

@Service
public class PaymentService {

    private final Fyatu fyatu;

    public PaymentService(Fyatu fyatu) {
        this.fyatu = fyatu;
    }

    public Collection createPayment(BigDecimal amount, String reference) {
        return fyatu.collections().create(
            CreateCollectionParams.builder()
                .amount(amount.doubleValue())
                .currency("USD")
                .reference(reference)
                .build()
        );
    }
}

Fyatu fyatu = Fyatu.builder()
    .appId("your_app_id")
    .secretKey("your_secret_key")

    // Optional configuration
    .baseUrl("https://api.fyatu.com/api/v3")
    .timeout(Duration.ofSeconds(30))
    .maxRetries(3)
    .httpClient(customHttpClient)
    .build();

import com.fyatu.exception.*;

try {
    Payout payout = fyatu.payouts().create(
        CreatePayoutParams.builder()
            .amount(100.0)
            .currency("USD")
            .recipientId("invalid_id")
            .build()
    );
} catch (ValidationException e) {
    System.out.println("Validation failed: " + e.getDetails());
} catch (AuthenticationException e) {
    System.out.println("Authentication failed: " + e.getMessage());
} catch (InsufficientBalanceException e) {
    System.out.println("Insufficient balance: " + e.getMessage());
} catch (FyatuException e) {
    System.out.println("API error [" + e.getCode() + "]: " + e.getMessage());
}

import com.fyatu.webhook.Webhook;
import com.fyatu.webhook.WebhookEvent;

// Spring Boot controller example
@RestController
public class WebhookController {

    @PostMapping("/webhooks/fyatu")
    public ResponseEntity<String> handleWebhook(
        @RequestBody String payload,
        @RequestHeader("X-Fyatu-Signature") String signature
    ) {
        boolean valid = Webhook.verifySignature(
            payload,
            signature,
            "your_webhook_secret"
        );

        if (!valid) {
            return ResponseEntity.status(HttpStatus.UNAUTHORIZED)
                .body("Invalid signature");
        }

        WebhookEvent event = Webhook.parseEvent(payload);
        System.out.println("Received event: " + event.getType());

        return ResponseEntity.ok("OK");
    }
}

import com.fyatu.FyatuAsync;
import java.util.concurrent.CompletableFuture;

FyatuAsync fyatuAsync = FyatuAsync.builder()
    .appId("your_app_id")
    .secretKey("your_secret_key")
    .build();

CompletableFuture<Collection> future = fyatuAsync.collections().create(
    CreateCollectionParams.builder()
        .amount(10.0)
        .currency("USD")
        .reference("order_123")
        .build()
);

future.thenAccept(collection -> {
    System.out.println("Created: " + collection.getId());
});