org.killbill.billing.payment.api

Interface PaymentGatewayApi

All Superinterfaces:

KillbillApi

public interface PaymentGatewayApi
extends KillbillApi

Method Summary

Modifier and Type	Method and Description
HostedPaymentPageFormDescriptor	buildFormDescriptor(Account account, java.util.UUID paymentMethodId, java.lang.Iterable<PluginProperty> customFields, java.lang.Iterable<PluginProperty> properties, CallContext context) Build metadata for the client to create a redirect form
HostedPaymentPageFormDescriptor	buildFormDescriptorWithPaymentControl(Account account, java.util.UUID paymentMethodId, java.lang.Iterable<PluginProperty> customFields, java.lang.Iterable<PluginProperty> properties, PaymentOptions paymentOptions, CallContext context) Build metadata for the client to create a redirect form
GatewayNotification	processNotification(java.lang.String notification, java.lang.String pluginName, java.lang.Iterable<PluginProperty> properties, CallContext context) Process a notification from the gateway This potentially does more than just deserialize the payload.
GatewayNotification	processNotificationWithPaymentControl(java.lang.String notification, java.lang.String pluginName, java.lang.Iterable<PluginProperty> properties, PaymentOptions paymentOptions, CallContext context) Process a notification from the gateway This potentially does more than just deserialize the payload.

Method Detail

buildFormDescriptor

HostedPaymentPageFormDescriptor buildFormDescriptor(Account account,
                                                    java.util.UUID paymentMethodId,
                                                    java.lang.Iterable<PluginProperty> customFields,
                                                    java.lang.Iterable<PluginProperty> properties,
                                                    CallContext context)
                                             throws PaymentApiException

Build metadata for the client to create a redirect form

Parameters:

account - account

customFields - form fields

properties - custom properties for the gateway

context - call context

Returns:

redirect form metadata

Throws:

PaymentApiException

buildFormDescriptorWithPaymentControl

HostedPaymentPageFormDescriptor buildFormDescriptorWithPaymentControl(Account account,
                                                                      java.util.UUID paymentMethodId,
                                                                      java.lang.Iterable<PluginProperty> customFields,
                                                                      java.lang.Iterable<PluginProperty> properties,
                                                                      PaymentOptions paymentOptions,
                                                                      CallContext context)
                                                               throws PaymentApiException

Build metadata for the client to create a redirect form

Parameters:

account - account

customFields - form fields

properties - custom properties for the gateway

paymentOptions - options to control payment behavior

context - call context

Returns:

redirect form metadata

Throws:

PaymentApiException

processNotification

GatewayNotification processNotification(java.lang.String notification,
                                        java.lang.String pluginName,
                                        java.lang.Iterable<PluginProperty> properties,
                                        CallContext context)
                                 throws PaymentApiException

Process a notification from the gateway

This potentially does more than just deserialize the payload. The plugin may have to acknowledge it with the gateway.

Parameters:

notification - serialized notification object

pluginName - the payment plugin name

properties - custom properties for the gateway

context - call context

Returns:

gateway notification object used to build the response to the gateway

Throws:

PaymentApiException

processNotificationWithPaymentControl

GatewayNotification processNotificationWithPaymentControl(java.lang.String notification,
                                                          java.lang.String pluginName,
                                                          java.lang.Iterable<PluginProperty> properties,
                                                          PaymentOptions paymentOptions,
                                                          CallContext context)
                                                   throws PaymentApiException

Process a notification from the gateway

This potentially does more than just deserialize the payload. The plugin may have to acknowledge it with the gateway.

Parameters:

notification - serialized notification object

pluginName - the payment plugin name

properties - custom properties for the gateway

paymentOptions - options to control payment behavior

context - call context

Returns:

gateway notification object used to build the response to the gateway

Throws:

PaymentApiException