Package io.moov.sdk

Class ApplePay

    • Method Detail

      • registerMerchantDomains

        public RegisterApplePayMerchantDomainsRequestBuilder registerMerchantDomains()
        Add domains to be registered with Apple Pay.

        Any domains that will be used to accept payments must first be [verified](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) with Apple.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Returns:
        The call builder
      • registerMerchantDomains

        public RegisterApplePayMerchantDomainsResponse registerMerchantDomains​(java.lang.String accountID,
                                                                               RegisterApplePayMerchantDomains registerApplePayMerchantDomains)
                                                                        throws java.lang.Exception
        Add domains to be registered with Apple Pay.

        Any domains that will be used to accept payments must first be [verified](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) with Apple.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Parameters:
        accountID - ID of the Moov account representing the merchant.
        registerApplePayMerchantDomains -
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • registerMerchantDomains

        public RegisterApplePayMerchantDomainsResponse registerMerchantDomains​(java.util.Optional<java.lang.String> xMoovVersion,
                                                                               java.lang.String accountID,
                                                                               RegisterApplePayMerchantDomains registerApplePayMerchantDomains)
                                                                        throws java.lang.Exception
        Add domains to be registered with Apple Pay.

        Any domains that will be used to accept payments must first be [verified](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) with Apple.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Specified by:
        registerMerchantDomains in interface SDKMethodInterfaces.MethodCallRegisterApplePayMerchantDomains
        Parameters:
        xMoovVersion - Specify an API version. API versioning follows the format `vYYYY.QQ.BB`, where - `YYYY` is the year - `QQ` is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10) - `BB` is the build number, starting at `.01`, for subsequent builds in the same quarter. - For example, `v2024.01.00` is the initial release of the first quarter of 2024. The `latest` version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
        accountID - ID of the Moov account representing the merchant.
        registerApplePayMerchantDomains -
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • updateMerchantDomains

        public UpdateApplePayMerchantDomainsRequestBuilder updateMerchantDomains()
        Add or remove domains to be registered with Apple Pay.

        Any domains that will be used to accept payments must first be [verified](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) with Apple.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Returns:
        The call builder
      • updateMerchantDomains

        public UpdateApplePayMerchantDomainsResponse updateMerchantDomains​(java.lang.String accountID,
                                                                           UpdateApplePayMerchantDomains updateApplePayMerchantDomains)
                                                                    throws java.lang.Exception
        Add or remove domains to be registered with Apple Pay.

        Any domains that will be used to accept payments must first be [verified](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) with Apple.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Parameters:
        accountID - ID of the Moov account representing the merchant.
        updateApplePayMerchantDomains -
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • updateMerchantDomains

        public UpdateApplePayMerchantDomainsResponse updateMerchantDomains​(java.util.Optional<java.lang.String> xMoovVersion,
                                                                           java.lang.String accountID,
                                                                           UpdateApplePayMerchantDomains updateApplePayMerchantDomains)
                                                                    throws java.lang.Exception
        Add or remove domains to be registered with Apple Pay.

        Any domains that will be used to accept payments must first be [verified](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) with Apple.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Specified by:
        updateMerchantDomains in interface SDKMethodInterfaces.MethodCallUpdateApplePayMerchantDomains
        Parameters:
        xMoovVersion - Specify an API version. API versioning follows the format `vYYYY.QQ.BB`, where - `YYYY` is the year - `QQ` is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10) - `BB` is the build number, starting at `.01`, for subsequent builds in the same quarter. - For example, `v2024.01.00` is the initial release of the first quarter of 2024. The `latest` version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
        accountID - ID of the Moov account representing the merchant.
        updateApplePayMerchantDomains -
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • getMerchantDomains

        public GetApplePayMerchantDomainsRequestBuilder getMerchantDomains()
        Get domains registered with Apple Pay.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.read` scope.

        Returns:
        The call builder
      • getMerchantDomains

        public GetApplePayMerchantDomainsResponse getMerchantDomains​(java.lang.String accountID)
                                                              throws java.lang.Exception
        Get domains registered with Apple Pay.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.read` scope.

        Parameters:
        accountID - ID of the Moov account representing the merchant.
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • getMerchantDomains

        public GetApplePayMerchantDomainsResponse getMerchantDomains​(java.util.Optional<java.lang.String> xMoovVersion,
                                                                     java.lang.String accountID)
                                                              throws java.lang.Exception
        Get domains registered with Apple Pay.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.read` scope.

        Specified by:
        getMerchantDomains in interface SDKMethodInterfaces.MethodCallGetApplePayMerchantDomains
        Parameters:
        xMoovVersion - Specify an API version. API versioning follows the format `vYYYY.QQ.BB`, where - `YYYY` is the year - `QQ` is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10) - `BB` is the build number, starting at `.01`, for subsequent builds in the same quarter. - For example, `v2024.01.00` is the initial release of the first quarter of 2024. The `latest` version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
        accountID - ID of the Moov account representing the merchant.
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • createSession

        public CreateApplePaySessionRequestBuilder createSession()
        Create a session with Apple Pay to facilitate a payment.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more. A successful response from this endpoint should be passed through to Apple Pay unchanged.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Returns:
        The call builder
      • createSession

        public CreateApplePaySessionResponse createSession​(java.lang.String accountID,
                                                           CreateApplePaySession createApplePaySession)
                                                    throws java.lang.Exception
        Create a session with Apple Pay to facilitate a payment.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more. A successful response from this endpoint should be passed through to Apple Pay unchanged.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Parameters:
        accountID - ID of the Moov account representing the merchant.
        createApplePaySession -
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • createSession

        public CreateApplePaySessionResponse createSession​(java.util.Optional<java.lang.String> xMoovVersion,
                                                           java.lang.String accountID,
                                                           CreateApplePaySession createApplePaySession)
                                                    throws java.lang.Exception
        Create a session with Apple Pay to facilitate a payment.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more. A successful response from this endpoint should be passed through to Apple Pay unchanged.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/apple-pay.write` scope.

        Specified by:
        createSession in interface SDKMethodInterfaces.MethodCallCreateApplePaySession
        Parameters:
        xMoovVersion - Specify an API version. API versioning follows the format `vYYYY.QQ.BB`, where - `YYYY` is the year - `QQ` is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10) - `BB` is the build number, starting at `.01`, for subsequent builds in the same quarter. - For example, `v2024.01.00` is the initial release of the first quarter of 2024. The `latest` version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
        accountID - ID of the Moov account representing the merchant.
        createApplePaySession -
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • linkToken

        public LinkApplePayTokenRequestBuilder linkToken()
        Connect an Apple Pay token to the specified account.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more. The `token` data is defined by Apple Pay and should be passed through from Apple Pay's response unmodified.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/cards.write` scope.

        Returns:
        The call builder
      • linkToken

        public LinkApplePayTokenResponse linkToken​(java.lang.String accountID,
                                                   LinkApplePay linkApplePay)
                                            throws java.lang.Exception
        Connect an Apple Pay token to the specified account.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more. The `token` data is defined by Apple Pay and should be passed through from Apple Pay's response unmodified.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/cards.write` scope.

        Parameters:
        accountID - ID of the Moov account representing the cardholder.
        linkApplePay - The JSON structure returned from Apple Pay when authorizing a payment session. Refer to [Apple's documentation](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypayment) for more information.
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails
      • linkToken

        public LinkApplePayTokenResponse linkToken​(java.util.Optional<java.lang.String> xMoovVersion,
                                                   java.lang.String accountID,
                                                   LinkApplePay linkApplePay)
                                            throws java.lang.Exception
        Connect an Apple Pay token to the specified account.

        Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more. The `token` data is defined by Apple Pay and should be passed through from Apple Pay's response unmodified.

        To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) you'll need to specify the `/accounts/{accountID}/cards.write` scope.

        Specified by:
        linkToken in interface SDKMethodInterfaces.MethodCallLinkApplePayToken
        Parameters:
        xMoovVersion - Specify an API version. API versioning follows the format `vYYYY.QQ.BB`, where - `YYYY` is the year - `QQ` is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10) - `BB` is the build number, starting at `.01`, for subsequent builds in the same quarter. - For example, `v2024.01.00` is the initial release of the first quarter of 2024. The `latest` version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
        accountID - ID of the Moov account representing the cardholder.
        linkApplePay - The JSON structure returned from Apple Pay when authorizing a payment session. Refer to [Apple's documentation](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypayment) for more information.
        Returns:
        The response from the API call
        Throws:
        java.lang.Exception - if the API call fails