Skip to main content

Fiscal Code Usage

The Pin-on-Demand API supports orders where a fiscal code must be provided by the customer during sales processing at the POS. This can be done to either make a direct top-up to the customer’s account, or to print a PIN which is associated to the customer based on the fiscal code provided.

Flow and process description​

  1. The customer requests a PaysafeCard PIN for an available face value at a POS and shows their fiscal code
  2. The POS employee selects the product and face value
  3. The POS employee scans/enters the customer fiscal code
  4. An execute order request is made to the PaysafeCard system, including the customer fiscal code
  5. PaysafeCard performs validation checks and a valid response is returned (the status of the order is DELIVERED)
    • 5.1 For direct top-up, this includes the customer’s credit limit, terminal limits, account status and fiscal code
    • 5.2 For a normal PIN request, this only includes the fiscal code
  6. The voucher is printed by the business partner system containing the serial number, product, face value, currency, date, terminal ID and the T & C’s and handed out to the customer
    • 6.1 For a PIN sale, the PIN is printed normally
    • 6.2 For a direct top-up, no PIN is printed
  7. (Optional) A cancellation can be made via the cancel order request during the cooldown period (the status of the order is CANCELLED)
  8. PaysafeCard performs validation checks (order status, order id, date) and a valid response is returned
  9. A cancellation receipt is printed by the business partner system and handed out to the customer

Note: If the amount is loaded directly into the customer PaysafeCard account, the implementation of cancel order at the POS is mandatory to avoid possible fraud cases.

POS flow pod_tax_id_pos

Customer flow pod_tax_id_customer

Below, all additional error codes for the Pin-on-Demand REST API related to the fiscal code usage are listed with the corresponding description.

CodeNumberMessage
illegal_customer_id_type10026CustomerId type CIVIL_NUMBER is not allowed in country XX.
account_not_found_for_mobile3036No valid Account found with '0'='1'.
transaction_limit_reached_sdd_upgrade_possible3052With this topup your balance would be higher than your remaining spending limit.
civil_number_enforced_but_not_provided31621The CIVIL_NUMBER must be provided for this distributor.

Other errors can be communicated to the customer as “general technical error”.

In general when one of these errors occur, the business partner should contact PaysafeCard for more information via integration@paysafecard.com if the account is not live.

For live accounts, techsupport@paysafecard.com should be contacted.