Constructor Detail

Method Detail

• onSubmit

   abstract Unit onSubmit(PaymentComponentState<?> state)

  In this method you should make a network call to the /payments endpoint of the Checkout API through your server.

  We provide a PaymentComponentState which contains information about the state of the payment component at the moment the user submits the payment.

  We also provide inside PaymentComponentState.data the parameters that we can infer from the component's configuration and the user input, especially the state.data.paymentMethod object with the shopper input details.

  Use PaymentComponentData.SERIALIZER to serialize this data to a JSONObject. The rest of the /payments call request data should be filled in, on your server, according to your needs.

  You should eventually call sendResult with a DropInServiceResult containing the result of the network request. Drop-in will be updated then based on the DropInServiceResult you sent.

  NOTICE: this method runs on the main thread, you should make sure the API call and any other long running operation is made on a background thread.

  Note that the PaymentComponentState is a abstract class, you can check and cast to one of its subclasses for a more component specific state.

  Only applicable for partial payments flow: in case of a partial payment, you should update Drop-in by calling sendResult with DropInServiceResult.Update.

  See https://docs.adyen.com/api-explorer/ for more information on the API documentation.

  Parameters:

  state - The state of the payment component at the moment the user submits the payment.

• onAdditionalDetails

   abstract Unit onAdditionalDetails(ActionComponentData actionComponentData)

  In this method you should make a network call to the /payments/details endpoint of the Checkout API through your server.

  We provide inside ActionComponentData the whole request data expected by the /payments/details endpoint. Use ActionComponentData.SERIALIZER to serialize this data to a JSONObject.

  You should eventually call sendResult with a DropInServiceResult containing the result of the network request. Drop-in will be updated then based on the DropInServiceResult you sent.

  NOTICE: this method runs on the main thread, you should make sure the API call and any other long running operation is made on a background thread.

  Only applicable for partial payments flow: in case of a partial payment, you should update Drop-in by calling sendResult with DropInServiceResult.Update.

  See https://docs.adyen.com/api-explorer/ for more information on the API documentation.

  Parameters:

  actionComponentData - The data from the action component.

• onBalanceCheck

   Unit onBalanceCheck(PaymentComponentState<?> paymentComponentState)

  Only applicable for partial payments flow.

  In this method you should make a network call to the /paymentMethods/balance endpoint of the Checkout API through your server. This method is called right after the user enters their partial payment method details and submits them.

  We provide a PaymentComponentState which has a PaymentComponentData object containing a non-serialized version of the partial payment method JSON. Use PaymentMethodDetails.SERIALIZER to serialize it to a JSONObject.

  NOTICE: this method runs on the main thread, you should make sure the API call and any other long running operation is made on a background thread.

  You should eventually call sendBalanceResult with a BalanceDropInServiceResult containing the result of the network request. Drop-in will be updated then based on the BalanceDropInServiceResult you sent.

  Note that not overriding this method while enabling partial payments will cause a MethodNotImplementedException to be thrown.

  See https://docs.adyen.com/api-explorer/ for more information on the API documentation.

  Parameters:

  paymentComponentState - The state from the partial payment method component.

• onOrderRequest

   Unit onOrderRequest()

  Only applicable for partial payments flow.

  In this method you should make a network call to the /orders endpoint of the Checkout API through your server. This method is called when the user is trying to pay a part of the Drop-in amount using a partial payment method.

  NOTICE: this method runs on the main thread, you should make sure the API call and any other long running operation is made on a background thread.

  You should eventually call sendOrderResult with a OrderDropInServiceResult containing the result of the network request. The base class will handle messaging the UI afterwards, based on the OrderDropInServiceResult.

  Note that not overriding this method while enabling partial payments will cause a MethodNotImplementedException to be thrown.

  See https://docs.adyen.com/api-explorer/ for more information on the API documentation.

• onOrderCancel

   Unit onOrderCancel(OrderRequest order, Boolean shouldUpdatePaymentMethods)

  Only applicable for partial payments flow.

  In this method you should make a network call to the /orders/cancel endpoint of the Checkout API through your server. This method is called during a partial payment, when the user removes their already submitted partial payments either by using the remove button or cancelling Drop-in.

  We provide order, an Order object that contains a non-serialized version of the order to be cancelled. Use Order.SERIALIZER to serialize it to a JSONObject.

  The shouldUpdatePaymentMethods flag indicates the next step you should take after the API call is made:

  • true means that Drop-in is still showing and you might want to call /paymentMethods with the new payment amount. Update Drop-in with the new list of payment methods, by passing DropInServiceResult.Update to sendResult.

  • false means that Drop-in is being dismissed by the user so there is no need to make any further calls.

  NOTICE: this method runs on the main thread, you should make sure the API call and any other long running operation is made on a background thread.

  Note that not overriding this method while enabling partial payments will cause a MethodNotImplementedException to be thrown.

  See https://docs.adyen.com/api-explorer/ for more information on the API documentation.

  Parameters:

  order - The data from order being cancelled.

  shouldUpdatePaymentMethods - indicates whether payment methods should be re-fetched and passed to Drop-in.