Java SDK

<dependency>
    <groupId>io.github.qpay-sdk</groupId>
    <artifactId>qpay-java</artifactId>
    <version>1.0.0</version>
</dependency>

implementation 'io.github.qpay-sdk:qpay-java:1.0.0'

implementation("io.github.qpay-sdk:qpay-java:1.0.0")

import mn.qpay.sdk.QPayConfig;
 
QPayConfig config = QPayConfig.builder()
        .baseURL("https://merchant.qpay.mn")
        .username("YOUR_USERNAME")
        .password("YOUR_PASSWORD")
        .invoiceCode("YOUR_INVOICE_CODE")
        .callbackURL("https://yoursite.com/payment/callback")
        .build();

QPayConfig config = QPayConfig.fromEnv();

import java.net.http.HttpClient;
import java.time.Duration;
 
HttpClient httpClient = HttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(60))
        .build();
 
QPayClient client = new QPayClient(config, httpClient);

import mn.qpay.sdk.*;
import mn.qpay.sdk.models.*;
 
QPayConfig config = QPayConfig.fromEnv();
QPayClient client = new QPayClient(config);
 
InvoiceResponse invoice = client.createSimpleInvoice(
        CreateSimpleInvoiceRequest.builder()
                .invoiceCode(config.getInvoiceCode())
                .senderInvoiceNo("ORDER-001")
                .invoiceDescription("Payment for Order #001")
                .amount(50000.0)
                .callbackURL(config.getCallbackURL())
                .build()
);
 
System.out.println("Invoice ID: " + invoice.getInvoiceId());
System.out.println("QR Image: " + invoice.getQrImage());
System.out.println("Short URL: " + invoice.getQPayShortUrl());
 
for (var url : invoice.getUrls()) {
    System.out.println("  " + url.getName() + ": " + url.getLink());
}

CreateSimpleInvoiceRequest request = CreateSimpleInvoiceRequest.builder()
        .invoiceCode("YOUR_INVOICE_CODE")
        .senderInvoiceNo("ORDER-003")
        .invoiceDescription("Simple payment")
        .amount(25000.0)
        .callbackURL("https://yoursite.com/payment/callback")
        .build();
 
InvoiceResponse invoice = client.createSimpleInvoice(request);

client.cancelInvoice("invoice-id-here");

import mn.qpay.sdk.models.common.Offset;
 
PaymentCheckRequest request = PaymentCheckRequest.builder()
        .objectType("INVOICE")
        .objectId("INVOICE_ID")
        .offset(new Offset(1, 10))
        .build();
 
PaymentCheckResponse response = client.checkPayment(request);
 
if (response.getCount() > 0) {
    System.out.println("Payment received! Paid: " + response.getPaidAmount());
    for (PaymentCheckResponse.PaymentCheckRow row : response.getRows()) {
        System.out.println("  " + row.getPaymentId() + ": " + row.getPaymentStatus()
                + " (" + row.getPaymentAmount() + " " + row.getPaymentCurrency() + ")");
    }
} else {
    System.out.println("No payment yet");
}

PaymentListRequest request = PaymentListRequest.builder()
        .objectType("INVOICE")
        .objectId("INVOICE_ID")
        .startDate("2024-01-01")
        .endDate("2024-12-31")
        .offset(new Offset(1, 20))
        .build();
 
PaymentListResponse response = client.listPayments(request);
 
System.out.println("Total: " + response.getCount());
for (PaymentListResponse.PaymentListItem item : response.getRows()) {
    System.out.println("  " + item.getPaymentId() + " | " + item.getPaymentAmount()
            + " MNT | " + item.getPaymentStatus());
}

PaymentDetail detail = client.getPayment("payment-id-here");
System.out.println("Payment " + detail.getPaymentId() + ": " + detail.getPaymentStatus());

import mn.qpay.sdk.*;
import mn.qpay.sdk.models.*;
import org.springframework.web.bind.annotation.*;
 
@RestController
public class QPayCallbackController {
 
    private final QPayClient qpayClient;
 
    public QPayCallbackController() {
        this.qpayClient = new QPayClient(QPayConfig.fromEnv());
    }
 
    @PostMapping("/api/qpay/callback")
    public Map<String, String> handleCallback(@RequestBody Map<String, String> body) {
        String paymentId = body.get("payment_id");
 
        PaymentCheckResponse result = qpayClient.checkPayment(
                PaymentCheckRequest.builder()
                        .objectType("INVOICE")
                        .objectId(paymentId)
                        .build()
        );
 
        if (result.getCount() > 0) {
            // Payment verified -- update your order status
            System.out.println("Payment confirmed: " + paymentId);
        }
 
        return Map.of("status", "ok");
    }
}

try {
    client.createSimpleInvoice(request);
} catch (QPayException e) {
    System.err.println("Status: " + e.getStatusCode());   // e.g., 400
    System.err.println("Code: " + e.getCode());            // e.g., "INVOICE_CODE_INVALID"
    System.err.println("Message: " + e.getMessage());
    System.err.println("Raw body: " + e.getRawBody());
}

import mn.qpay.sdk.ErrorCodes;
 
try {
    client.getPayment("invalid-id");
} catch (QPayException e) {
    if (ErrorCodes.PAYMENT_NOTFOUND.equals(e.getCode())) {
        System.out.println("Payment does not exist");
    } else if (ErrorCodes.AUTHENTICATION_FAILED.equals(e.getCode())) {
        System.out.println("Authentication failed");
    } else if (ErrorCodes.PERMISSION_DENIED.equals(e.getCode())) {
        System.out.println("Permission denied");
    } else {
        System.out.println("Unexpected error: " + e);
    }
}