Kiosk only. POS, web, and iOS do not use this package. There is no native module, Expo config plugin, or binary.
Follow the sections below to wire it by hand. To hand the same work to an agent, copy the prompt in AI agent prompt.
Requirements
- A kiosk that already charges with
@fire-spark/core(setPaymentAdapters,setPaymentOptions,payIntent). - The merchant payment filled in the dashboard: service URL, unique code, user, password, and supervisor password.
- On each kiosk: terminal code, register number, and cashier code. All three have to be saved. If one is missing, the API does not send the payment and the button stays off the checkout.
Activate it
- In the dashboard, open your merchant, go to Payments, and create a payment with the provider Redeban and the method PIN pad.
- In Connection Settings, fill in:
There are no per-store settings. These values are shared by every Redeban datáfono of the merchant.
- On each kiosk, open the device and the Payments tab. Values live in
settings_overrides.payment_settings, keyed by payment id. See Configure a device.
A payment that is missing a device field never reaches the kiosk, so its button stays off the checkout. On the device list, the Payments column shows what is still empty.
Checkout button
Each Redeban payment is one button. The kiosk template already renders one card per payment fromservices.payments.list (CheckoutPaymentMethodCard). You do not add a button component.
Redeban has no modalities. paymentInstructionKind treats a PIN_PAD payment as a card, so the template shows the card illustration. The package is not part of the public template. Add it in the merchant kiosk app. useCheckoutPayments hides only the Fire spark staff datáfono (firespark and PIN_PAD). A Redeban payment stays on the list.
Use it in the SDK
Add the package to the kiosk app. It is not part of the public template. Pin it to the same version as@fire-spark/payments.
redebanPinPadPayments() takes no URL and no keys. Each charge reads the context that PaymentSession builds from getKioskConfig.
kioskConfig is what getKioskConfig returns. Device values arrive on overrides.payment_settings. The authenticated config includes secret_clave and secret_supervisor_password. The public storefront list strips those secrets. Each start asks SIPConnector for a new token. The token lasts 3 minutes. Leave it in the adapter.
The adapter draws nothing. When the charge starts it calls ui.message with the text Present the card on the pinpad and kind: "waiting".
Cancel aborts the
payIntent signal. The kiosk does not call Borrar and does not build the sale frame.
Charge the payment the customer picked:
payIntent({ payment }) still places one tender. To split Redeban with another method, call setTenders with an allocation and then payIntent(). See Use payments in the SDK.
The charge window is 370 seconds. It covers two poll phases of 184 seconds. Leave runtime.timeout_ms unset to keep that window. A value on the payment replaces it, so a shorter one cuts the sale in half.
order.getMissingPaymentFields(payment) lists device fields that are still empty. The API already hides an incomplete payment. Use the helper on the kiosk admin screen when you want to show what is missing.
What the customer sees
The waiting message and a cancel control. OnPAID, continue the order. The authorization code, brand, last 4 digits, receipt number, and terminal are on result.metadata.payment. There is no customer receipt text to print. The kiosk does not store them itself.
AMBIGUOUS is the error code, not a status. The status stays FAILED. The text comes from formatPaymentError in @fire-spark/payments.
Webhooks
None.Voids
order.cancel() voids an order that was not fulfilled. order.refund() refunds one that was. reversalFor always returns cancel, so both run the adapter’s full void. There is no partial refund, and the adapter has no refund operation.
The void sends the stored receipt and secret_supervisor_password from the payment. The kiosk does not ask for that password.
Common errors
Compatibility
AI agent prompt
Paste this into the agent that edits the kiosk app. It covers only Redeban. The sections above are the same work, written for a person.Integration prompt