This repo contains the Java client for Craftgate API.
- Java 1.8 or newer
Apache Maven:
<dependency>
<groupId>io.craftgate</groupId>
<artifactId>craftgate</artifactId>
<version>1.0.80</version>
</dependency>Gradle Groovy DSL
implementation 'io.craftgate:craftgate:1.0.80'
Gradle Kotlin DSL
implementation("io.craftgate:craftgate:1.0.80")
To access the Craftgate API you'll first need to obtain API credentials (e.g. an API key and a secret key). If you don't already have a Craftgate account, you can signup at https://craftgate.io
Once you've obtained your API credentials, you can start using Craftgate by instantiating a Craftgate with your credentials.
Craftgate craftgate = new Craftgate("<YOUR API KEY>", "<YOUR SECRET KEY>");
...By default the Craftgate client connects to the production API servers at https://api.craftgate.io. For testing purposes, please use the sandbox URL https://sandbox-api.craftgate.io using the .
Craftgate craftgate = new Craftgate("<YOUR API KEY>", "<YOUR SECRET KEY>", "https://sandbox-api.craftgate.io");
...Included in the project are a number of examples that cover almost all use-cases. Refer to the sample/ folder] for more info.
If you've cloned this repo on your development machine and wish to run the examples you can run an example with the command ./gradlew test or run single test with the command ./gradlew test --tests PaymentSample.create_payment_sample
Let's quickly review an example where we implement a credit card payment scenario.
For more examples covering almost all use-cases, check out the examples in the
sample/folder
Craftgate craftgate = new Craftgate("api-key", "secret-key", "https://sandbox-api.craftgate.io");
List<PaymentItem> items = new ArrayList<>();
items.add(PaymentItem.builder()
.name("item 1")
.externalId(UUID.randomUUID().toString())
.price(BigDecimal.valueOf(30))
.build());
items.add(PaymentItem.builder()
.name("item 2")
.externalId(UUID.randomUUID().toString())
.price(BigDecimal.valueOf(50))
.build());
items.add(PaymentItem.builder()
.name("item 3")
.externalId(UUID.randomUUID().toString())
.price(BigDecimal.valueOf(20))
.build());
CreatePaymentRequest request = CreatePaymentRequest.builder()
.price(BigDecimal.valueOf(100))
.paidPrice(BigDecimal.valueOf(100))
.walletPrice(BigDecimal.ZERO)
.installment(1)
.currency(Currency.TRY)
.conversationId("456d1297-908e-4bd6-a13b-4be31a6e47d5")
.paymentGroup(PaymentGroup.LISTING_OR_SUBSCRIPTION)
.paymentPhase(PaymentPhase.AUTH)
.card(Card.builder()
.cardHolderName("Haluk Demir")
.cardNumber("5258640000000001")
.expireYear("2044")
.expireMonth("07")
.cvc("000")
.build())
.items(items)
.build();
PaymentResponse response = craftgate.payment().createPayment(request);
System.out.println(String.format("Create Payment Result: %s", response));For all contributions to this client please see the contribution guide here. By participating in this project, you agree to abide by our Code of Conduct.
If you discover a security vulnerability, please review our Security Policy for how to report it responsibly.
This project is licensed under the Apache License, Version 2.0 — see the LICENSE and NOTICE files for details.
