• Home
• jp.gopay
• gopay-java-sdk
• 0.11.9
• source code
• GoPaySDK.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

jp.gopay.sdk.GoPaySDK Maven / Gradle / Ivy

package jp.gopay.sdk;

import jp.gopay.sdk.builders.ResourceMonitor;
import jp.gopay.sdk.builders.applicationtoken.ApplicationTokenBuilders;
import jp.gopay.sdk.builders.authentication.AuthenticationBuilders;
import jp.gopay.sdk.builders.bankaccount.BankAccountsBuilders;
import jp.gopay.sdk.builders.batch_charge.BatchCreateCharge;
import jp.gopay.sdk.builders.cancel.CancelsBuilders;
import jp.gopay.sdk.builders.charge.ChargesBuilders;
import jp.gopay.sdk.builders.exchangerate.ExchangeRateBuilders;
import jp.gopay.sdk.builders.ledgers.LedgersBuilders;
import jp.gopay.sdk.builders.merchant.MerchantsBuilders;
import jp.gopay.sdk.builders.refund.RefundBuilders;
import jp.gopay.sdk.builders.store.StoreBuilders;
import jp.gopay.sdk.builders.subscription.SubscriptionBuilders;
import jp.gopay.sdk.builders.transactiontoken.TransactionTokensBuilders;
import jp.gopay.sdk.builders.transfer.TransferBuilders;
import jp.gopay.sdk.builders.utility.UtilityBuilders;
import jp.gopay.sdk.builders.webhook.WebhookBuilders;
import jp.gopay.sdk.models.common.*;
import jp.gopay.sdk.models.common.auth.*;
import jp.gopay.sdk.models.common.bankaccounts.JapaneseBankAccount;
import jp.gopay.sdk.models.errors.GoPayException;
import jp.gopay.sdk.models.errors.TooManyRequestsException;
import jp.gopay.sdk.models.request.transactiontoken.PaymentData;
import jp.gopay.sdk.models.response.cancel.Cancel;
import jp.gopay.sdk.models.response.charge.Charge;
import jp.gopay.sdk.models.response.merchant.MerchantCompanyContactInfo;
import jp.gopay.sdk.models.response.refund.Refund;
import jp.gopay.sdk.models.response.subscription.FullSubscription;
import jp.gopay.sdk.models.response.transactiontoken.TokenAliasKey;
import jp.gopay.sdk.settings.AbstractSDKSettings;
import jp.gopay.sdk.settings.GoPaySettings;
import jp.gopay.sdk.types.*;
import okhttp3.Call.Factory;
import okhttp3.ConnectionPool;
import okhttp3.OkHttpClient;

import java.io.Closeable;
import java.io.IOException;
import java.math.BigInteger;
import java.net.URL;
import java.util.List;

/**
 * Main class of the GoPay SDK. Provides methods for setting up credentials and communicating with the API.
 */

public class GoPaySDK extends AbstractSDK implements SDKMethods, Closeable {

    private GoPaySDK(AuthStrategy authStrategy, AbstractSDKSettings settings) {
        super(authStrategy, settings);
    }

    private GoPaySDK(AuthStrategy authStrategy, AbstractSDKSettings settings, ConnectionPool connectionPool) {
        super(authStrategy, settings, connectionPool);
    }

    @Override
    public GoPaySDK copy(AuthStrategy authStrategy){
        return new GoPaySDK(authStrategy, this.settings.copy());
    }

    @Override
    public GoPaySDK copy(AbstractSDKSettings settings){
        return new GoPaySDK(this.authStrategy, settings);
    }

    @Override
    public GoPaySDK copy(AuthStrategy authStrategy, AbstractSDKSettings settings) {
        return new GoPaySDK(authStrategy, settings);
    }

    @Override
    public GoPaySDK copy(){
        return new GoPaySDK(this.authStrategy, this.settings.copy());
    }

    @Override
    public GoPaySDK clone(AuthStrategy authStrategy){
        OkHttpClient client = (OkHttpClient)retrofit.callFactory();
        return new GoPaySDK(authStrategy, this.settings.copy(), client.connectionPool());
    }

    @Override
    public GoPaySDK clone(AbstractSDKSettings settings){
        OkHttpClient client = (OkHttpClient)retrofit.callFactory();
        return new GoPaySDK(this.authStrategy, settings, client.connectionPool());
    }

    @Override
    public GoPaySDK clone(AuthStrategy authStrategy, AbstractSDKSettings settings) {
        OkHttpClient client = (OkHttpClient)retrofit.callFactory();
        return new GoPaySDK(authStrategy, settings, client.connectionPool());
    }

    @Override
    public GoPaySDK clone() {
        OkHttpClient client = (OkHttpClient)retrofit.callFactory();
        return new GoPaySDK(this.authStrategy, this.settings, client.connectionPool());
    }

    /**
     * Create a GoPaySDK instance using an authentication strategy.
     *
     * @param authStrategy              The merchant's credentials.
     * @param settings                  The SDK settings.
     * @see AbstractSDKSettings
     * @see AuthStrategy
     * @see LoginTokenStrategy
     * @see AppTokenStrategy
     * @see LoginJWTStrategy
     * @see AppJWTStrategy
     * @see UnauthenticatedStrategy
     */
    public static GoPaySDK create(AuthStrategy authStrategy, AbstractSDKSettings settings) {
        return new GoPaySDK(authStrategy, settings);
    }

    /**
     * Create an unauthenticated GoPaySDK instance.
     *
     * @param settings       The SDK settings.
     * @see AbstractSDKSettings
     */
    public static GoPaySDK create(AbstractSDKSettings settings) {
        return create(new UnauthenticatedStrategy(), settings);
    }

    /**
     * Create an unauthenticated GoPaySDK instance with default production settings.
     *
     * @see AbstractSDKSettings
     */
    public static GoPaySDK create() {
        return create(new UnauthenticatedStrategy(), new GoPaySettings());
    }

    /**
     * Create a GoPaySDK instance with default settings using an authentication strategy.
     *
     * @param authStrategy              The merchant's credentials.
     * @see AbstractSDKSettings
     * @see AuthStrategy
     * @see LoginTokenStrategy
     * @see AppTokenStrategy
     * @see LoginJWTStrategy
     * @see AppJWTStrategy
     * @see UnauthenticatedStrategy
     * @see AbstractSDKSettings
     */
    public static GoPaySDK create(AuthStrategy authStrategy) {
        return create(authStrategy, new GoPaySettings());
    }

    /**
     * Asynchronously creates a GoPaySDK instance requesting a JWT for authentication.
     * @param userCredentials   The merchant's email and password
     * @throws TooManyRequestsException
     * @throws IOException
     * @throws GoPayException
     * @see UserCredentials
     */
    public static GoPaySDK create(UserCredentials userCredentials, AbstractSDKSettings settings) throws IOException, GoPayException{
        LoginJWTStrategy jwtCredentials = GoPaySDK.create(settings)
                .getLoginToken(userCredentials)
                .build()
                .dispatch()
                .getJWTAuthStrategy();
        return create(jwtCredentials, settings);
    }

    /*
     * 
GoPayMethods
     * 
These are the methods used to communicate with the Payments API
     * 
Each method returns a Request, which is only executed when the method
     * 
dispatch() is called.
     */

    /*
     * 
AUTHENTICATION
     * 
Methods for obtaining a set of credentials or to submit registration information for a new merchant
     */

    @Override
    public AuthenticationBuilders.LoginRequestBuilder getLoginToken(String email, String password) {
        return new AuthenticationBuilders.LoginRequestBuilder(retrofit, new EmailAddress(email), password);
    }

    @Override
    public AuthenticationBuilders.LoginRequestBuilder getLoginToken(UserCredentials userCredentials) {
        return getLoginToken(userCredentials.getEmail(), userCredentials.getPassword());
    }

    @Deprecated
    /**
     * Delete a login token.
     *
     * @return a request builder.
     * @see LogoutRequestBuilder
     */
    public AuthenticationBuilders.LogoutRequestBuilder deleteLoginToken() {
        return new AuthenticationBuilders.LogoutRequestBuilder(retrofit);
    }

    @Override
    public AuthenticationBuilders.LogoutRequestBuilder logout() {
        return new AuthenticationBuilders.LogoutRequestBuilder(retrofit);
    }

    /*
     * 
STORES
     * Methods for stores management tasks.
     */

    @Override
    public StoreBuilders.ListStoresRequestBuilder listStores() {
        return new StoreBuilders.ListStoresRequestBuilder(retrofit);
    }

    @Override
    public StoreBuilders.GetStoreRequestBuilder getStore(StoreId storeId) {
        return new StoreBuilders.GetStoreRequestBuilder(retrofit, storeId);
    }

    @Override
    public StoreBuilders.CreateStoreRequestBuilder createStore(String name) {
        return new StoreBuilders.CreateStoreRequestBuilder(retrofit, name);
    }

    @Override
    public StoreBuilders.UpdateStoreRequestBuilder updateStore(StoreId storeId) {
        return new StoreBuilders.UpdateStoreRequestBuilder(retrofit, storeId);
    }

    @Override
    public StoreBuilders.DeleteStoreRequestBuilder deleteStore(StoreId storeId) {
        return new StoreBuilders.DeleteStoreRequestBuilder(retrofit, storeId);
    }

    @Override
    public StoreBuilders.GetCheckoutInfoRequestBuilder getCheckoutInfo(Domain origin) {
        return new StoreBuilders.GetCheckoutInfoRequestBuilder(retrofit, origin);
    }

    @Override
    public StoreBuilders.GetCheckoutInfoRequestBuilder getCheckoutInfo() {
        return new StoreBuilders.GetCheckoutInfoRequestBuilder(retrofit);
    }

    @Override
    public StoreBuilders.CreateCustomerIdRequestBuilder createCustomerId(StoreId storeId, String customerId) {
        return new StoreBuilders.CreateCustomerIdRequestBuilder(retrofit, storeId, customerId);
    }

    /*
     * 
APPLICATION TOKENS
     * 
Methods used for the management of application tokens
     */

    @Override
    public ApplicationTokenBuilders.ListApplicationTokenRequestBuilder listAppTokens(StoreId storeId) {
        return new ApplicationTokenBuilders.ListApplicationTokenRequestBuilder(retrofit, storeId);
    }

    @Override
    public ApplicationTokenBuilders.DeleteApplicationTokenRequestBuilder deleteAppToken(StoreId storeId, AppTokenId appTokenId) {
        return new ApplicationTokenBuilders.DeleteApplicationTokenRequestBuilder(
                retrofit, storeId, appTokenId);
    }

    @Deprecated
    @Override
    public ApplicationTokenBuilders.CreateApplicationTokenRequestBuilder createAppToken(StoreId storeId) {
        return new ApplicationTokenBuilders.CreateApplicationTokenRequestBuilder(retrofit, storeId);
    }

    @Override
    public ApplicationTokenBuilders.CreateApplicationTokenRequestBuilder createAppToken(StoreId storeId, List domains) {
        return new ApplicationTokenBuilders.CreateApplicationTokenRequestBuilder(retrofit, storeId, domains);
    }

    @Override
    public ApplicationTokenBuilders.UpdateApplicationTokenRequestBuilder updateAppToken(StoreId storeId, AppTokenId appTokenId, List domains) {
        return new ApplicationTokenBuilders.UpdateApplicationTokenRequestBuilder(retrofit, storeId, appTokenId, domains);
    }

    @Override
    public ApplicationTokenBuilders.CreateMerchantApplicationJWTRequestBuilder createMerchantAppJWT(){
        return new ApplicationTokenBuilders.CreateMerchantApplicationJWTRequestBuilder(retrofit);
    }

    @Override
    public ApplicationTokenBuilders.ListMerchantApplicationJWTRequestBuilder listMerchantAppJWT(){
        return new ApplicationTokenBuilders.ListMerchantApplicationJWTRequestBuilder(retrofit);
    }

    @Override
    public ApplicationTokenBuilders.DeleteMerchantApplicationJWTRequestBuilder deleteAppJWT(AppJWTId appJWTId){
        return new ApplicationTokenBuilders.DeleteMerchantApplicationJWTRequestBuilder(retrofit, appJWTId);
    }

    @Override
    public ApplicationTokenBuilders.CreateStoreApplicationJWTRequestBuilder createStoreAppJWT(StoreId storeId){
        return new ApplicationTokenBuilders.CreateStoreApplicationJWTRequestBuilder(retrofit, storeId);
    }

    @Override
    public ApplicationTokenBuilders.ListStoreApplicationJWTRequestBuilder listStoreAppJWT(StoreId storeId){
        return new ApplicationTokenBuilders.ListStoreApplicationJWTRequestBuilder(retrofit, storeId);
    }

    @Override
    public ApplicationTokenBuilders.DeleteStoreApplicationJWTRequestBuilder deleteAppJWT(StoreId storeId, AppJWTId appJWTId){
        return new ApplicationTokenBuilders.DeleteStoreApplicationJWTRequestBuilder(retrofit, storeId, appJWTId);
    }


    /*
     * 
TRANSFERS
     * 
 Obtain information about the transfers to the merchant
     */

    @Override
    public TransferBuilders.ListTransferRequestBuilder listTransfers() {
        return new TransferBuilders.ListTransferRequestBuilder(retrofit);
    }

    @Override
    public TransferBuilders.GetTransferRequestBuilder getTransfer(TransferId transferId) {
        return new TransferBuilders.GetTransferRequestBuilder(retrofit, transferId);
    }

    /*
     * 
CHARGES
     * 
Methods used for making charges and obtaining detailed information about previous ones.
     */

    @Override
    public ChargesBuilders.ListChargesRequestBuilder listCharges(StoreId storeId) {
        return new ChargesBuilders.ListChargesRequestBuilder(retrofit, storeId);
    }

    @Override
    public ChargesBuilders.ListChargesRequestBuilder listCharges() {
        return new ChargesBuilders.ListChargesRequestBuilder(retrofit);
    }

    @Override
    public ChargesBuilders.GetChargeRequestBuilder getCharge(StoreId storeId, ChargeId chargeId) {
        return new ChargesBuilders.GetChargeRequestBuilder(retrofit, storeId, chargeId);
    }

    @Override
    public ResourceMonitor chargeCompletionMonitor(StoreId storeId, ChargeId chargeId) {
        return ChargesBuilders.createChargeCompletionMonitor(retrofit, storeId, chargeId);

    }

    @Override
    public ChargesBuilders.CreateChargeRequestBuilder createCharge(TransactionTokenId tokenId,
                                                                           BigInteger amount, String currency) {
        return createCharge(tokenId, amount, currency, true);
    }

    @Override
    public ChargesBuilders.CreateChargeRequestBuilder createCharge(TransactionTokenId tokenId,
                                                                           BigInteger amount, String currency, Boolean capture) {
        return new ChargesBuilders.CreateChargeRequestBuilder(retrofit, tokenId, new MoneyLike(amount, currency), capture);
    }

    @Override
    public ChargesBuilders.CreateChargeRequestBuilder createCharge(TransactionTokenId tokenId, MoneyLike money) {
        return createCharge(tokenId, money.getAmount(), money.getCurrency());
    }

    @Override
    public ChargesBuilders.CreateChargeRequestBuilder createCharge(TransactionTokenId tokenId, MoneyLike money, Boolean capture) {
        return createCharge(tokenId, money.getAmount(), money.getCurrency(), capture);
    }

    @Override
    public ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder createChargeWithTokenAlias(StoreId storeId, TokenAliasKey alias, MoneyLike money, Boolean capture) {
        return new ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder(storeId, money, capture, this, alias);
    }

    @Override
    public ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder createChargeWithTokenAlias(StoreId storeId, String alias, MoneyLike money, Boolean capture) {
        return new ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder(storeId, money, capture, this, TokenAliasKey.parse(alias));
    }

    @Override
    public ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder createChargeWithTokenAlias(StoreId storeId, TokenAliasKey alias, MoneyLike money) {
        return new ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder(storeId, money, true, this, alias);
    }

    @Override
    public ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder createChargeWithTokenAlias(StoreId storeId, String alias, MoneyLike money) {
        return new ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder(storeId, money, true, this, TokenAliasKey.parse(alias));
    }

    @Override
    public ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder createChargeWithTokenAlias(StoreId storeId, TokenAliasKey alias, Boolean capture) {
        return new ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder(storeId, null, capture, this, alias);
    }

    @Override
    public ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder createChargeWithTokenAlias(StoreId storeId, String alias, Boolean capture) {
        return new ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder(storeId, null, capture, this, TokenAliasKey.parse(alias));
    }

    @Override
    public ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder createChargeWithTokenAlias(StoreId storeId, TokenAliasKey alias) {
        return new ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder(storeId, null, true, this, alias);
    }

    @Override
    public ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder createChargeWithTokenAlias(StoreId storeId, String alias) {
        return new ChargesBuilders.CreateChargeWithTokenAliasRequestBuilder(storeId, null, true, this, TokenAliasKey.parse(alias));
    }

    @Override
    public BatchCreateCharge batchCreateCharge() {
        return batchCreateCharge(10, 15_000);
    }


    @Override
    public BatchCreateCharge batchCreateCharge(int createMaxRetry, int statusCheckTimeout) {
        return new BatchCreateCharge(retrofit, createMaxRetry, statusCheckTimeout);
    }

    @Override
    public ChargesBuilders.CreateChargeRequestBuilder authorizeCharge(TransactionTokenId tokenId,
                                                                              BigInteger amount, String currency) {
        return createCharge(tokenId, amount, currency, false);
    }

    @Override
    public ChargesBuilders.CreateChargeRequestBuilder authorizeCharge(TransactionTokenId tokenId, MoneyLike money) {
        return authorizeCharge(tokenId, money.getAmount(), money.getCurrency());
    }

    @Override
    public ChargesBuilders.CaptureAuthorizedChargeRequestBuilder captureAuthorizedCharge(StoreId storeId, ChargeId chargeId,
                                                                                                 BigInteger amount, String currency) {
        return new ChargesBuilders.CaptureAuthorizedChargeRequestBuilder(retrofit, storeId, chargeId, new MoneyLike(amount, currency));
    }

    @Override
    public ChargesBuilders.CaptureAuthorizedChargeRequestBuilder captureAuthorizedCharge(StoreId storeId, ChargeId chargeId, MoneyLike money) {
        return captureAuthorizedCharge(storeId, chargeId, money.getAmount(), money.getCurrency());
    }

    @Override
    public ChargesBuilders.UpdateChargeRequestBuilder updateCharge(StoreId storeId, ChargeId chargeId) {
        return new ChargesBuilders.UpdateChargeRequestBuilder(retrofit, storeId, chargeId);
    }

    /*
     * 
SUBSCRIPTIONS
     * 
Methods for the management of subscriptions
     */

    @Override
    public SubscriptionBuilders.ListSubscriptionsMerchantRequestBuilder listSubscriptions() {
        return new SubscriptionBuilders.ListSubscriptionsMerchantRequestBuilder(retrofit);
    }

    @Override
    public SubscriptionBuilders.ListSubscriptionsRequestBuilder listSubscriptions(StoreId storeId) {
        return new SubscriptionBuilders.ListSubscriptionsRequestBuilder(retrofit, storeId);
    }

    @Override
    public SubscriptionBuilders.GetSubscriptionRequestBuilder getSubscription(StoreId storeId, SubscriptionId subscriptionId) {
        return new SubscriptionBuilders.GetSubscriptionRequestBuilder(retrofit, storeId, subscriptionId);
    }

    @Override
    public ResourceMonitor subscriptionCompletionMonitor(StoreId storeId, SubscriptionId subscriptionId) {
        return SubscriptionBuilders.createSubscriptionCompletionMonitor(retrofit, storeId, subscriptionId);
    }

    @Override
    public SubscriptionBuilders.CreateSubscriptionRequestBuilder createSubscription(
                                                        TransactionTokenId transactionTokenId, BigInteger amount,
                                                        String amountCurrency, SubscriptionPeriod period) {
        return createSubscription(transactionTokenId, new MoneyLike(amount, amountCurrency), period);
    }

    @Override
    public SubscriptionBuilders.CreateSubscriptionRequestBuilder createSubscription(TransactionTokenId transactionTokenId,
                                                                                                    MoneyLike money,
                                                                                                    SubscriptionPeriod period) {
        return new SubscriptionBuilders.CreateSubscriptionRequestBuilder(retrofit, transactionTokenId, money, period);
    }

    @Override
    public SubscriptionBuilders.UpdateSubscriptionRequestBuilder updateSubscription(StoreId storeId,
                                                                                    SubscriptionId subscriptionId) {
        return new SubscriptionBuilders.UpdateSubscriptionRequestBuilder(retrofit, storeId, subscriptionId);
    }

    @Override
    public SubscriptionBuilders.ListChargesForPaymentRequestBuilder listChargesForPayment(StoreId storeId, SubscriptionId subscriptionId, ScheduledPaymentId paymentId) {
        return new SubscriptionBuilders.ListChargesForPaymentRequestBuilder(retrofit, storeId, subscriptionId, paymentId);
    }

    @Override
    public SubscriptionBuilders.ListSubscriptionChargesRequestBuilder listSubscriptionCharges(StoreId storeId, SubscriptionId subscriptionId) {
        return new SubscriptionBuilders.ListSubscriptionChargesRequestBuilder(retrofit, storeId, subscriptionId);
    }


    @Override
    public SubscriptionBuilders.DeleteSubscriptionRequestBuilder deleteSubscription(StoreId storeId, SubscriptionId subscriptionId) {
        return new SubscriptionBuilders.DeleteSubscriptionRequestBuilder(retrofit, storeId, subscriptionId);
    }

    @Override
    public SubscriptionBuilders.ListScheduledPaymentsRequestBuilder listScheduledPayments(StoreId storeId, SubscriptionId subscriptionId) {
        return new SubscriptionBuilders.ListScheduledPaymentsRequestBuilder(retrofit, storeId, subscriptionId);
    }

    @Override
    public SubscriptionBuilders.GetScheduledPaymentRequestBuilder getScheduledPayment(StoreId storeId, SubscriptionId subscriptionId, ScheduledPaymentId paymentId) {
        return new SubscriptionBuilders.GetScheduledPaymentRequestBuilder(retrofit, storeId, subscriptionId, paymentId);
    }

    @Override
    public SubscriptionBuilders.UpdateScheduledPaymentRequestBuilder updateScheduledPayment(StoreId storeId, SubscriptionId subscriptionId, ScheduledPaymentId paymentId) {
        return new SubscriptionBuilders.UpdateScheduledPaymentRequestBuilder(retrofit, storeId, subscriptionId, paymentId);
    }

    @Override
    public SubscriptionBuilders.SimulateInstallmentsPlanRequestBuilder simulateSubscriptionPlan(MoneyLike money, PaymentTypeName paymentType, SubscriptionPeriod period) {
        return new SubscriptionBuilders.SimulateInstallmentsPlanRequestBuilder(retrofit, money, paymentType, period);
    }

    @Override
    public SubscriptionBuilders.SimulateInstallmentsPlanRequestBuilder simulateSubscriptionPlan(StoreId storeId, MoneyLike money, PaymentTypeName paymentType, SubscriptionPeriod period) {
        return new SubscriptionBuilders.SimulateInstallmentsPlanRequestBuilder(retrofit, storeId, money, paymentType, period);
    }

    /*
     * 
REFUNDS
     * 
Methods for managing refunds.
     */


    @Override
    public RefundBuilders.ListRefundsRequestBuilder listRefunds(StoreId storeId,
                                                                ChargeId chargeId) {
        return new RefundBuilders.ListRefundsRequestBuilder(retrofit, storeId, chargeId);
    }

    @Override
    public RefundBuilders.GetRefundRequestBuilder getRefund(StoreId storeId, ChargeId chargeId,
                                                            RefundId refundId) {
        return new RefundBuilders.GetRefundRequestBuilder(retrofit, storeId, chargeId, refundId);
    }

    @Override
    public RefundBuilders.CreateRefundRequestBuilder createRefund(StoreId storeId, ChargeId chargeId,
                                                                  BigInteger amount, String currency, RefundReason reason) {
        return new RefundBuilders.CreateRefundRequestBuilder(retrofit, storeId, chargeId, amount, currency, reason);
    }

    @Override
    public RefundBuilders.CreateRefundRequestBuilder createRefund(StoreId storeId, ChargeId chargeId, MoneyLike money, RefundReason reason) {
        return createRefund(storeId, chargeId, money.getAmount(), money.getCurrency(), reason);
    }

    @Override
    public ResourceMonitor refundCompletionMonitor(StoreId storeId, ChargeId chargeId, RefundId refundId) {

        return RefundBuilders.createRefundCompletionMonitor(retrofit, storeId, chargeId, refundId);

    }

    /*
     * 
CANCEL
     * 
Methods used for cancelling charges.
     */


    @Override
    public CancelsBuilders.ListAllCancelsRequestBuilder listCancels(StoreId storeId, ChargeId chargeId){
        return new CancelsBuilders.ListAllCancelsRequestBuilder(retrofit, storeId, chargeId);
    }

    @Override
    public CancelsBuilders.GetCancelRequestBuilder getCancel(StoreId storeId, ChargeId chargeId, CancelId cancelId){
        return new CancelsBuilders.GetCancelRequestBuilder(retrofit, storeId, chargeId, cancelId);
    }

    @Override
    public ResourceMonitor cancelCompletionMonitor(StoreId storeId, ChargeId chargeId, CancelId cancelId) {
        return CancelsBuilders.createRefundCompletionMonitor(retrofit, storeId, chargeId, cancelId);
    }

    @Override
    public CancelsBuilders.CreateCancelRequestBuilder createCancel(StoreId storeId, ChargeId chargeId){
        return new CancelsBuilders.CreateCancelRequestBuilder(retrofit, storeId, chargeId);
    }

    @Override
    public CancelsBuilders.UpdateCancelRequestBuilder updateCancel(StoreId storeId, ChargeId chargeId, CancelId cancelId){
        return new CancelsBuilders.UpdateCancelRequestBuilder(retrofit, storeId, chargeId, cancelId);
    }


    /*
     * 
BANK ACCOUNTS
     * Methods for managing bank accounts.
     */

    @Override
    public BankAccountsBuilders.ListAllBankAccountsRequestBuilder listBankAccounts() {
        return new BankAccountsBuilders.ListAllBankAccountsRequestBuilder(retrofit);
    }

    @Override
    public BankAccountsBuilders.GetBankAccountRequestBuilder getBankAccount(BankAccountId bankAccountId) {
        return new BankAccountsBuilders.GetBankAccountRequestBuilder(retrofit, bankAccountId);
    }

    @Override
    public BankAccountsBuilders.CreateBankAccountRequestBuilder createBankAccount(JapaneseBankAccount bankAccount) {
        return new BankAccountsBuilders.CreateBankAccountRequestBuilder(retrofit, bankAccount);
    }

    @Override
    public BankAccountsBuilders.UpdateBankAccountRequestBuilder updateBankAccount(BankAccountId bankAccountId) {
        return new BankAccountsBuilders.UpdateBankAccountRequestBuilder(retrofit, bankAccountId);
    }

    @Override
    public BankAccountsBuilders.DeleteBankAccountRequestBuilder deleteBankAccount(BankAccountId bankAccountId) {
        return new BankAccountsBuilders.DeleteBankAccountRequestBuilder(retrofit, bankAccountId);
    }

    @Override
    public BankAccountsBuilders.GetPrimaryBankAccountRequestBuilder getPrimaryBankAccount() {
        return new BankAccountsBuilders.GetPrimaryBankAccountRequestBuilder(retrofit);
    }

    /*
     * 
MERCHANTS
     * Methods that provide or update information on the merchant.
     */

    @Override
    public MerchantsBuilders.GetMerchantVerificationRequestBuilder getMerchantVerification() {
        return new MerchantsBuilders.GetMerchantVerificationRequestBuilder(retrofit);
    }


    @Override
    public MerchantsBuilders.UpdateMerchantVerificationRequestBuilder updateMerchantVerification() {
        return new MerchantsBuilders.UpdateMerchantVerificationRequestBuilder(retrofit);
    }

    @Override
    public MerchantsBuilders.CreateMerchantVerificationRequestBuilder createMerchantVerification(URL homepageUrl, String companyDescription,
                                                                                                         MerchantCompanyContactInfo companyContactInfo,
                                                                                                         BusinessType businessType,
                                                                                                         String systemManagerName) {
        return new MerchantsBuilders.CreateMerchantVerificationRequestBuilder(retrofit, homepageUrl, companyDescription,
                companyContactInfo, businessType, systemManagerName);
    }

    @Override
    public MerchantsBuilders.GetMeRequestBuilder getMe() {
        return new MerchantsBuilders.GetMeRequestBuilder(retrofit);
    }

    @Override
    public MerchantsBuilders.GetTransactionHistoryRequestBuilder getTransactionHistory(StoreId storeId) {
        return new MerchantsBuilders.GetTransactionHistoryRequestBuilder(retrofit, storeId);
    }

    @Override
    public MerchantsBuilders.GetTransactionHistoryRequestBuilder getTransactionHistory() {
        return new MerchantsBuilders.GetTransactionHistoryRequestBuilder(retrofit, null);
    }

    /*
     * 
WEBHOOKS
     * Methods for managing webhooks.
     */

    @Override
    public WebhookBuilders.ListWebhookMerchantRequestBuilder listWebhooks() {
        return new WebhookBuilders.ListWebhookMerchantRequestBuilder(retrofit);
    }

    @Override
    public WebhookBuilders.GetWebhookMerchantRequestBuilder getWebhook(WebhookId webhookId) {
        return new WebhookBuilders.GetWebhookMerchantRequestBuilder(retrofit, webhookId);
    }

    @Override
    public WebhookBuilders.CreateWebhookMerchantRequestBuilder createWebhook(URL url) {
        return new WebhookBuilders.CreateWebhookMerchantRequestBuilder(retrofit, url);
    }

    @Override
    public WebhookBuilders.UpdateWebhookMerchantRequestBuilder updateWebhook(WebhookId webhookId) {
        return new WebhookBuilders.UpdateWebhookMerchantRequestBuilder(retrofit, webhookId);
    }

    @Override
    public WebhookBuilders.DeleteWebhookMerchantRequestBuilder deleteWebhook(WebhookId webhookId) {
        return new WebhookBuilders.DeleteWebhookMerchantRequestBuilder(retrofit, webhookId);
    }

    @Override
    public WebhookBuilders.ListWebhookRequestBuilder listWebhooks(StoreId storeId) {
        return new WebhookBuilders.ListWebhookRequestBuilder(retrofit, storeId);
    }

    @Override
    public WebhookBuilders.GetWebhookRequestBuilder getWebhook(StoreId storeId, WebhookId webhookId) {
        return new WebhookBuilders.GetWebhookRequestBuilder(retrofit, storeId, webhookId);
    }

    @Override
    public WebhookBuilders.CreateWebhookRequestBuilder createWebhook(StoreId storeId, URL url) {
        return new WebhookBuilders.CreateWebhookRequestBuilder(retrofit, storeId, url);
    }

    @Override
    public WebhookBuilders.UpdateWebhookRequestBuilder updateWebhook(StoreId storeId, WebhookId webhookId) {
        return new WebhookBuilders.UpdateWebhookRequestBuilder(retrofit, storeId, webhookId);
    }

    @Override
    public WebhookBuilders.DeleteWebhookRequestBuilder deleteWebhook(StoreId storeId, WebhookId webhookId) {
        return new WebhookBuilders.DeleteWebhookRequestBuilder(retrofit, storeId, webhookId);
    }

    /*
     * 
TRANSACTION TOKEN
     */

    @Override
    public TransactionTokensBuilders.CreateTransactionTokenRequestBuilder createTransactionToken(String email,
                                                                                                 PaymentData paymentData, TransactionTokenType type) {
        return new TransactionTokensBuilders.CreateTransactionTokenRequestBuilder(retrofit, new EmailAddress(email), paymentData, type);
    }

    @Override
    public TransactionTokensBuilders.CreateTransactionTokenRequestBuilder createTransactionToken(PaidyPaymentData paymentData, TransactionTokenType type) {
        return new TransactionTokensBuilders.CreateTransactionTokenRequestBuilder(retrofit, null, paymentData, type);
    }

    @Override
    public TransactionTokensBuilders.CreateTransactionTokenRequestBuilder createTransactionToken(QrScanData paymentData, TransactionTokenType type) {
        return new TransactionTokensBuilders.CreateTransactionTokenRequestBuilder(retrofit, null, paymentData, type);
    }

    @Override
    public TransactionTokensBuilders.DeleteTransactionTokenRequestBuilder deleteTransactionToken(StoreId storeId, TransactionTokenId tokenId) {
        return new TransactionTokensBuilders.DeleteTransactionTokenRequestBuilder(retrofit, storeId, tokenId);
    }

    @Override
    public TransactionTokensBuilders.GetTransactionTokenRequestBuilder getTransactionToken(StoreId storeId,
                                                                                                   TransactionTokenId tokenId) {
        return new TransactionTokensBuilders.GetTransactionTokenRequestBuilder(retrofit, storeId, tokenId);
    }

    @Override
    public TransactionTokensBuilders.UpdateTransactionTokenRequestBuilder updateTransactionToken(StoreId storeId, TransactionTokenId tokenId) {
        return new TransactionTokensBuilders.UpdateTransactionTokenRequestBuilder(retrofit, storeId, tokenId);
    }

    @Override
    public TransactionTokensBuilders.ListTransactionTokensRequestBuilder listTransactionTokens(StoreId storeId) {
        return new TransactionTokensBuilders.ListTransactionTokensRequestBuilder(retrofit, storeId);
    }

    @Override
    public TransactionTokensBuilders.ListTransactionTokensMerchantRequestBuilder listTransactionTokens() {
        return new TransactionTokensBuilders.ListTransactionTokensMerchantRequestBuilder(retrofit);
    }

    @Override
    public TransactionTokensBuilders.CreateTemporaryTokenAliasRequestBuilder createTokenAlias(TransactionTokenId transactionTokenId) {
        return new TransactionTokensBuilders.CreateTemporaryTokenAliasRequestBuilder(retrofit, transactionTokenId);
    }

    @Override
    public TransactionTokensBuilders.GetTemporaryTokenAliasRequestBuilder getTokenAlias(StoreId storeId, TokenAliasKey aliasKey) {
        return new TransactionTokensBuilders.GetTemporaryTokenAliasRequestBuilder(retrofit, storeId, aliasKey);
    }

    @Override
    public TransactionTokensBuilders.GetTemporaryTokenAliasAsImageRequestBuilder getTokenAliasImage(StoreId storeId, TokenAliasKey aliasKey) {
        return new TransactionTokensBuilders.GetTemporaryTokenAliasAsImageRequestBuilder(retrofit, storeId, aliasKey);
    }

    @Override
    public TransactionTokensBuilders.DeleteTemporaryTokenAliasRequestBuilder deleteTokenAlias(StoreId storeId, TokenAliasKey aliasKey) {
        return new TransactionTokensBuilders.DeleteTemporaryTokenAliasRequestBuilder(retrofit, storeId, aliasKey);
    }

    @Override
    public TransactionTokensBuilders.ConfirmTransactionTokenRequestBuilder confirmTransactionToken(StoreId storeId, TransactionTokenId tokenId, String confirmationCode) {
        return new TransactionTokensBuilders.ConfirmTransactionTokenRequestBuilder(retrofit, storeId, tokenId, confirmationCode);
    }

    /*
     * 
LEDGERS
     * 
Methods for obtaining information related to ledgers
     */

    @Override
    public LedgersBuilders.ListLedgersRequestBuilder listLedgers(TransferId transferId) {
        return new LedgersBuilders.ListLedgersRequestBuilder(retrofit, transferId);
    }

    /*
    * 
EXCHANGE RATES
    * 
Methods related to exchange rates and money conversions
    */
    @Override
    public ExchangeRateBuilders.ConvertMoneyBuilder convertMoney(MoneyLike moneyToConvert, String targetCurrency) {
        return new ExchangeRateBuilders.ConvertMoneyBuilder(retrofit, moneyToConvert, targetCurrency);
    }

    @Override
    public UtilityBuilders.HeartBeatRequestBuilder beat() {
        return new UtilityBuilders.HeartBeatRequestBuilder(retrofit);
    }

    @Override
    public void close() throws IOException {
        Factory client = retrofit.callFactory();
        if(client instanceof OkHttpClient) {
            ((OkHttpClient)client).dispatcher().executorService().shutdown();
        }
    }
}