Models

PaysimpleSDKResponse

PaysimpleSaleResponse

PaysimpleCardData

PaysimpleEmvResponse

🚧

EMV Receipt Requirements

THE FOLLOWING ARE REQUIRED FOR EMV RECEIPTS
Application Identifier (AID) of the application used.
Application Preferred Name (if available and supported) or Application Label
Cryptogram type/value
Host Response Code/Host Response Message (e.g. 00/AP, etc)
Host Response Message

PaysimpleSaleOutcome

AvailableDeviceResponse

Extends PaysimpleSDKResponse

PaysimpleSaleRequest

Enum ErrorType

Enum DeviceState

Methods

🚧

Some Methods Must Be Started on a Thread

Example calls will instruct if method needs to be started on a new thread.

Get BBPOS Instance

IPaysimpleBBPOS getInstance(Context context, PsEnvironment paysimpleEnvironment,PsDeviceType psDevice);

Gets PaySimple TriPOS instance.

IPaysimpleBBPOS psBBPOS = PaysimpleBBPOS.getInstance(this, PsEnvironment.SBX, PsDeviceType.BbposContactless);

Initialize and Connect Device

PaysimpleSDKResponse initializeAndConnect(String clientToken, String deviceIdentifier);

Initializes client and connects to BBPOS device. Needs a PaySimple client token and the name of the BBPOS device.

new Thread(() -> {
     PaysimpleSDKResponse res = _paysimpleBBPOS.initializeAndConnect(psToken, "CHB202044007347");
}).start();

Get Available Devices

AvailableDeviceResponse getAvailableDevices() throws InterruptedException;

Gets a list of available BBPOS devices.

new Thread(() -> {
      AvailableDeviceResponse devices = _paysimpleBBPOS.getAvailableDevices();
}).start();

Subscribe to Listeners

❗️

Required

User must call subscribeToDeviceInteractionListener before making payments with device.

Gives user ability to subscribe to listeners.

void subscribeToListener(PsListener listener);
void subscribeToDeviceInteractionListener(PsDeviceInteractionListener psDeviceInteractionListener);

Listeners implemented through calling class.

paysimpleBBPOS.subscribeToListener(this);
paysimpleBBPOS.subscribeToDeviceInteractionListener(this);

Get Device Info

ArrayList<String> getDeviceInfo();

Gets available device information returning an array containing device serial number, description, and device configuration if initialized.

Process Sale

Process sale with client token.

📘

Total Sales Amount Requirements

The amount in PaysimpleSaleRequest saleRequest must be the total amount including tips, fees etc...

PaysimpleSDKResponse processSale(String clientToken, PaysimpleSaleRequest saleRequest);

new Thread(() -> {
     try {
     BigDecimal amount = BigDecimal.valueOf(Math.random() * 100).setScale(2, 
     BigDecimal.ROUND_UP);

     PaysimpleSaleRequest saleRequest = new PaysimpleSaleRequest(amount);
     saleRequest.external_id = "1234";
     saleRequest.transact_description = "TX BBPOS";
     _paysimpleBBPOS.processSale(container.token, saleRequest);
     } catch (Exception e) {
     e.printStackTrace();
}
}).start();

De-Initialize BBPOS

De-initialize Paysimple SDK and disconnect device.

void deInitializeBBPOS() throws Exception;

new Thread(() -> {
     try {
          _paysimpleBBPOS.deInitializeBBPOS();
     } catch (Exception e) {
     e.printStackTrace();
}
}).start();

Hard Reset

Clears Express credentials, clears device configuration, and de-Initializes PaySimple SDK.

PaysimpleSDKResponse hardReset();

PaysimpleSDKResponse res = _paysimpleBBPOS.hardReset();

Is Device Connected

Checks if BBPOS device is connected.

boolean isDeviceConnected();

boolean isInit = _paysimpleBBPOS.isDeviceConnected();

Is SDK Initialized

Check if PaySimple SDK has been successfully initialized with Express credentials.

boolean isSdkInitialized();

boolean isInit = _paysimpleBBPOS.isSdkInitialized();

Cancel Current Action

Currently this applies to process payment flow. Call this if payment gets interrupted. Returns true if successful.

boolean cancelCurrentAction();;

new Thread(() -> {
     try {
         boolean succeed =  _paysimpleBBPOS.cancelCurrentAction();
     } catch (Exception e) {
          e.printStackTrace();
     }
}).start();

Delegates/Listeners

PsListener

Listens for general SDK related events. Required.

public interface PsListener {
    void updateResponse(Double progress, String... response);
    void onError(PaysimpleSDKError sdkError);
    void onDeviceEvent(DeviceState deviceState, String message);
    void onPaymentResponse(PaysimpleSaleResponse response);
}

PsDeviceInteractionListener

Listens for transaction related events.

public interface PsDeviceInteractionListener{
    void onAmountConfirmation(PsAmountConfirmationType var1, BigDecimal var2, PsConfirmAmountListener var3);
    void onPromptUserForCard(String var1);
    void onDisplayText(String var1);
    void onRemoveCard();
    void onCardRemoved();
    interface PsConfirmAmountListener {
        void psConfirmAmount(boolean var1);
    }
}