com.dotdashpay.api

Class Payment

java.lang.Object

com.dotdashpay.api.Payment

public class Payment
extends java.lang.Object

Created by colorado on 11/4/15.

Method Summary

Modifier and Type	Method and Description
static void	authorizePayment(java.util.Map paymentData, ResponseHandler responseHandler) Authorize a payment, i.e.
static Payment	getInstance()
static void	listenForPaymentDataThenSettle(java.util.Map paymentData, ResponseHandler responseHandler) This is a convenience request that combines listenForPaymentData and settlePayment into a single request.
static void	refundPayment(java.lang.String transactionId, ResponseHandler responseHandler) Refund a settled payment.
static void	settlePayment(java.util.Map paymentData, ResponseHandler responseHandler) Settle a payment: you may call this function either after receiving data from `hardware.listenForPaymentData` or after receiving data from `payment.authorizePayment` If called directly after receiving payment data from the hardware, then this immediently charges the payer.
static void	voidPayment(java.lang.String transactionId, ResponseHandler responseHandler) Void an authorized payment.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static Payment getInstance()

authorizePayment

public static void authorizePayment(java.util.Map paymentData,
                                    ResponseHandler responseHandler)

Authorize a payment, i.e. verify that the payment_info is accurate and that the desired funds can be withdrawn. This request does not charge the card: you will have to call payment.settlePayment(returnObjFromAuthorizePayment) later. Alternatevily, you can later call `voidPayment(returnObjFromAuthorizePayment)` in order to void the given payment without ever having charged the card.

Parameters:

paymentData: - a Map with the following format: { "payid": {String} "payment id from waitForPaymentData callback" "dollars": {int}: number of dollars to charge (USD), "cents": {int, optional, default=0} number of cents to charge (USD) }

responseHandler -

settlePayment

public static void settlePayment(java.util.Map paymentData,
                                 ResponseHandler responseHandler)

Settle a payment: you may call this function either after receiving data from `hardware.listenForPaymentData` or after receiving data from `payment.authorizePayment` If called directly after receiving payment data from the hardware, then this immediently charges the payer. If called after authorizing the payment, then this request will finalize the transaction and the transaction can then not be voided.

Parameters:

paymentData -

responseHandler -

listenForPaymentDataThenSettle

public static void listenForPaymentDataThenSettle(java.util.Map paymentData,
                                                  ResponseHandler responseHandler)

This is a convenience request that combines listenForPaymentData and settlePayment into a single request. Once the user interacts with a payment peripheral, they are immediently charged for the amount you specify. Generally, this is quicker than calling listenForPaymentData then settlePayment.

Parameters:

paymentData - TODO

responseHandler -

refundPayment

public static void refundPayment(java.lang.String transactionId,
                                 ResponseHandler responseHandler)

Refund a settled payment. You can only call this function for a payment that was successfully settled

Parameters:

transactionId: - the transaction id returned from settlePayment

responseHandler -

voidPayment

public static void voidPayment(java.lang.String transactionId,
                               ResponseHandler responseHandler)

Void an authorized payment. You can only call this function for a payment that was successfully authorized but has not been settled. Call `refundPayment` if the payment was settled.

Parameters:

transactionId: - the transaction id returned from authorizePayment

responseHandler -