EPISHIP API Billing Payment Terminal overview

EPISHIP Billing Payment Terminal API icon 32px svg

Overview

The EPISHIP Billing Payment Terminal API lets you integrate physical point-of-sale (POS) hardware into your shipping workflow, enabling card-present transactions at kiosks and shipping counters. You can develop applications that integrate with EPISHIP to manage Stripe Terminal readers, initiate secure chip-and-pin payments, and programmatically capture funds after successful card swipes.

View Doc →

The following figure shows the relationship between your EPISHIP app, the EPISHIP API, and physical Payment Terminal hardware.

EPISHIP Billing Payment Terminal API icon 32px diagram

Figure 1. EPISHIP API relationship diagram. Terminal reader management and transaction flow.

EPISHIP App

EPISHIP’s terminal services give administrators the ability to register and monitor physical card readers (such as BBPOS or Verifone devices), ensuring that shipping kiosks are ready to accept in-person payments securely.

EPISHIP API

The REST API that acts as the bridge between your application and the card reader, controlling the state of the hardware and managing the financial transaction lifecycle.

Transaction Lifecycle

A strict three-step process where a Payment Intent is created, processed on the physical reader (waiting for customer interaction), and finally Captured to move the funds once the card is verified.

Simulation & Testing

A set of dedicated endpoints available in development environments to simulate card presentment events (e.g., swipe, decline, requires auth), allowing developers to build POS flows without physical hardware.

What can users do with the EPISHIP Payment Terminal API?

Users can use the EPISHIP Payment Terminal API to perform common workflows, such as:

  • Enable or disable specific payment terminal readers
  • List registered readers and filter by location or status
  • Create a Payment Intent to track a customer’s purchase
  • Push a payment request to a specific reader ID for customer input
  • Capture a confirmed payment to finalize the transaction
  • Cancel an in-flight reader action (e.g., if the customer changes their mind)
  • Simulate card dips and swipes for testing integration logic

Terminal properties available to view and filter through the EPISHIP Payment Terminal API:

  • Reader ID and Serial Number
  • Device Type (e.g., bbpos_wisepad3, verifone_P400)
  • Payment Intent Status (requires_payment_method, succeeded)
  • Connection Status (Online/Offline)
  • Location ID

Additional info

  • Learn more about developing with EPISHIP Billing API, including handling authentication, authorization, reference the Develop on EPISHIP API for your workspace. More →
  • Learn more about how to launch and run an EPISHIP Billing API app, read the Developer Page. More →

Related

Related Categories