Simulate card tap

https://api.kustom.co/ipp/v1/dev/sessions/{sessionId}/simulate-tap

Simulates a physical card tap on the terminal reader, bypassing the need for real hardware. Uses Stripe test helpers to simulate a card-present payment with the requested outcome. Only available in non-production environments.

Parameters

204

400

404

Example

Parameters2 fields

• sessionIdstring · uuidrequiredin path
• outcomestringoptionalin query
  • SUCCESS
  • DECLINED_GENERIC
  • INSUFFICIENT_FUNDS
  • LOST_CARD
  • STOLEN_CARD
  • EXPIRED_CARD
  • INCORRECT_CVC
  • PROCESSING_ERROR
  • INCORRECT_NUMBER
  • CARD_VELOCITY_EXCEEDED

204

Response0 fields

Card tap simulated successfully.

No response body — this status returns headers only.

400

Response0 fields

Session has no terminal payment attached.

No response body — this status returns headers only.

404

Response0 fields

Session not found.

No response body — this status returns headers only.

POST https://api.kustom.co/ipp/v1/dev/sessions/{sessionId}/simulate-tap

Response204400404

Response 204· Card tap simulated successfully.

No response body.

This status returns headers only — there is nothing to parse.

—

Response 400· Session has no terminal payment attached.

No response body.

This status returns headers only — there is nothing to parse.

—

Response 404· Session not found.

No response body.

This status returns headers only — there is nothing to parse.

—