Endpoints
PayFacto API - v1.0 - POST /v1/redirect/GetResponse
PayFacto API - v1.0 - POST /v1/redirect/GetResponse Retrieves the result of a hosted payment session after the cardholder has been redirected back to the merchant's success or failure URL. Called immediately following the redirect from ...
PayFacto API - v1.0 - POST /v1/recur/GetResponse
PayFacto API - v1.0 - POST /v1/recur/GetResponse Retrieves the result of a hosted recurring billing session after the cardholder has been redirected back to the merchant's success or failure URL. Called immediately following the redirect from ...
PayFacto API - v1.0 - POST /v1/recur/ack
PayFacto API - v1.0 - POST /v1/recur/ack Confirms that the response from a recurring billing (token-based) transaction has been received. Instructs the PayFacto host to mark the transaction as COMPLETED. The ACK must be sent within 3 minutes of the ...
PayFacto API - v1.0 - POST /v1/nack
PayFacto API - v1.0 - POST /v1/nack Instructs the PayFacto host to reverse a previously approved card-not-present transaction. The NACK must be sent within 3 minutes of the original approval — after that window, PayFacto's automatic reversal process ...
PayFacto API - v1.0 - POST /v1/totalBatch
PayFacto API - v1.0 - POST /v1/totalBatch Queries the current open batch totals at a semi-integrated terminal. Returns a summary for all cards combined as well as totals by card type amounts accumulated since the last batch close. Used for end-of-day ...
PayFacto API - v1.0 - POST /v1/signature/get
PayFacto API - v1.0 - POST /v1/signature/get Retrieves the cardholder signature captured at a semi-integrated terminal for a specific transaction. The signature is returned as a Base64-encoded image. Used for record-keeping. No transaction is ...
PayFacto API - v1.0 - POST /v1/refundWithoutCard
PayFacto API - v1.0 - POST /v1/refundWithoutCard Processes a credit card refund without the physical card being present. PayFacto looks up the original approved transaction using OriginalTransactionNumber and routes the refund to the same card on ...
PayFacto API - v1.0 - POST /v1/redirect/CreatePurchaseSession
PayFacto API - v1.0 - POST /v1/redirect/CreatePurchaseSession Creates a hosted session for a credit card purchase. Returns a sessionUrl that the merchant redirects the cardholder to. Payment details are entered on a PayFacto-hosted form — the ...
PayFacto API - v1.0 - POST /v1/recur/VerifyUser
PayFacto API - v1.0 - POST /v1/recur/VerifyUser Checks whether a token is valid and active in the PayFacto recurring billing vault. Returns the associated masked card details on success. No transaction is processed and no vault record is modified. ...
PayFacto API - v1.0 - POST /v1/recur/ModSubscription
PayFacto API - v1.0 - POST /v1/recur/ModSubscription Updates the configuration of an existing recurring subscription. Only the fields being changed need to be submitted alongside the required identifiers — fields not included remain unchanged. ...
PayFacto API - v1.0 - POST /v1/recur/InfoSubscription
PayFacto API - v1.0 - POST /v1/recur/InfoSubscription Retrieves the full configuration and current status of a specific recurring subscription. Returns the billing schedule, amount, associated card, and status. No transaction is processed and no ...
PayFacto API - v1.0 - POST /v1/recur/InfoInvoice
PayFacto API - v1.0 - POST /v1/recur/InfoInvoice Retrieves the billing history for a specific recurring subscription. Returns a list of invoice records, each containing the billing date, amount, transaction identifiers, and result code for that ...
PayFacto API - v1.0 - POST /v1/recur/DelUser
PayFacto API - v1.0 - POST /v1/recur/DelUser Removes a cardholder's card registration from the PayFacto recurring billing vault. The cardholder is identified by the Token previously returned by /v1/recur/AddUser, /v1/recur/CreateSession, or ...
PayFacto API - v1.0 - POST /v1/recur/CreateSession
PayFacto API - v1.0 - POST /v1/recur/CreateSession Creates a hosted session for secure card registration. Returns a sessionUrl that the merchant redirects the cardholder to. Card details are entered on a PayFacto-hosted form — the merchant system ...
PayFacto API - v1.0 - POST /v1/recur/AddUser
PayFacto API - v1.0 - POST /v1/recur/AddUser Registers a cardholder's credit card in the PayFacto recurring billing vault without processing any transaction. No charge is made. On success, a token is returned that identifies the cardholder for future ...
PayFacto API - v1.0 - POST /v1/recur/AddSubscription
PayFacto API - v1.0 - POST /v1/recur/AddSubscription Creates a new recurring billing subscription on a credit card. The first charge is processed immediately; subsequent charges are automatically billed at the defined frequency until the end date. A ...
PayFacto API - v1.0 - POST /v1/recover
PayFacto API - v1.0 - POST /v1/recover Queries a semi-integrated terminal for the result of its last processed transaction. Used when a terminal becomes unresponsive or a previous transaction response was lost or ambiguous. The response includes the ...
PayFacto API - v1.0 - POST /v1/preAuthorization
PayFacto API - v1.0 - POST /v1/preAuthorization Reserves funds on a credit card without capturing or settling the transaction immediately. This is Step 1 of the Pre-Authorization / Completion flow. The four response values authorizationNumber, ...
PayFacto API - v1.0 - POST /v1/iapRefundCorrection
PayFacto API - v1.0 - POST /v1/iapRefundCorrection Reverses a previously posted IAP (Interac Automated Payment) Refund in full. Must be performed on the same business day as the original IAP Refund, before batch close. The ...
PayFacto API - v1.0 - POST /v1/iapRefund
PayFacto API - v1.0 - POST /v1/iapRefund Refunds a previously settled IAP (Interac Automated Payment) Purchase or IAP Completion after batch close. Full and partial refunds are supported — the refund amount must not exceed the original transaction ...
PayFacto API - v1.0 - POST /v1/iapPurchaseCorrection
PayFacto API - v1.0 - POST /v1/iapPurchaseCorrection Reverses a previously approved IAP (Interac Automated Payment) Purchase in full. Must be performed on the same business day as the original IAP Purchase, before batch close. The ...
PayFacto API - v1.0 - POST /v1/iapPurchase
PayFacto API - v1.0 - POST /v1/iapPurchase Initiates a single-step Interac debit purchase (IAP — Interac Automated Payment). Funds are immediately debited from the cardholder's Interac account and settled in one operation. No pre-authorization or ...
PayFacto API - v1.0 - POST /v1/iapPreAuthorization
PayFacto API - v1.0 - POST /v1/iapPreAuthorization Reserves funds on an Interac debit card (IAP — Interac Automated Payment) without immediately settling the charge. The authorizationNumber, transactionNumber, invoiceNumber, and amount from this ...
PayFacto API - v1.0 - POST /v1/iapCompletion
PayFacto API - v1.0 - POST /v1/iapCompletion Captures and finalizes a previously approved IAP (Interac Automated Payment) Pre-Authorization, converting the reserved Interac debit funds into a settled charge. The completion amount must not exceed the ...
PayFacto API - v1.0 - POST /v1/forcePost
PayFacto API - v1.0 - POST /v1/forcePost Posts a transaction to the PayFacto network using an authorization code already obtained from the card issuer out-of-band (e.g., by telephone). The AuthorizationNumber bypasses the normal real-time ...
PayFacto API - v1.0 - POST /v1/datacandy/redemption
PayFacto API - v1.0 - POST /v1/datacandy/redemption Redeems (debits) a specified amount from a DataCandy gift or loyalty card balance at point of sale. Returns a transactionConfirmationNumber that must be saved — a follow-up call to ...
PayFacto API - v1.0 - POST /v1/datacandy/partialCancel
PayFacto API - v1.0 - POST /v1/datacandy/partialCancel Reverses a partial amount from a previously committed DataCandy transaction, returning the specified amount to the card balance. The OriginalInvoiceNumber and OriginalTransactionNumber from the ...
PayFacto API - v1.0 - POST /v1/datacandy/increment
PayFacto API - v1.0 - POST /v1/datacandy/increment Adds a specified amount to an existing DataCandy gift card balance (reload or top-up). Returns a transactionConfirmationNumber that must be saved — a follow-up call to /v1/datacandy/completeCancel is ...
PayFacto API - v1.0 - POST /v1/datacandy/emptyCard
PayFacto API - v1.0 - POST /v1/datacandy/emptyCard Drains the entire balance from a DataCandy gift or loyalty card in a single operation. No Amount is required — the full available balance is removed. No commit or cancel follow-up is needed after a ...
PayFacto API - v1.0 - POST /v1/datacandy/completeCancel
PayFacto API - v1.0 - POST /v1/datacandy/completeCancel Commits or cancels a previously initiated DataCandy transaction (such as an activation or redemption). The transactionConfirmationNumber returned by the prior DataCandy operation and the Action ...
PayFacto API - v1.0 - POST /v1/datacandy/balance
POST /v1/datacandy/balance DataCandy — Balance Retrieves the current balance and profile information of a DataCandy gift or loyalty card. This is a read-only inquiry — no funds are moved and no Amount field is required. Version: v1.0 | Last updated: ...
PayFacto API - v1.0 - POST /v1/datacandy/activate
PayFacto API - v1.0 - POST /v1/datacandy/activate Activates a DataCandy gift or loyalty card and loads an initial balance onto it. Returns a transactionConfirmationNumber that must be stored — it is required to commit or cancel the transaction and to ...
PayFacto API - v1.0 - POST /v1/completion
PayFacto API - v1.0 - POST /v1/completion Captures and finalizes a previously approved Pre-Authorization, converting the reserved funds into a settled charge. The completion amount must not exceed the amount reserved in the original Pre-Authorization ...
PayFacto API - v1.0 - POST /v1/closeBatch
PayFacto API - v1.0 - POST /v1/closeBatch Closes the current open batch on a Semi-Integrated terminal, triggering settlement of all transactions accumulated in that batch with the banking acquirer. No new transactions can be submitted to the terminal ...
PayFacto API - v1.0 - POST /v1/cash
PayFacto API - v1.0 - POST /v1/cash Records a cash transaction on a Semi-Integrated terminal, allowing tip prompts and receipt printing to be handled by the payment terminal without involving a card or bank authorization. 1 Prerequisites ? API Key ...
PayFacto API - v1.0 - POST /v1/refundWithToken
PayFacto API - v1.0 - POST /v1/refundWithToken Returns funds to a cardholder after a settled transaction, using a previously stored card token instead of raw card data. Optionally links back to the original purchase via its invoice and transaction ...
PayFacto API - v1.0 - POST /v1/preAuthorizationWithToken
PayFacto API - v1.0 - POST /v1/preAuthorizationWithToken Reserves funds on a cardholder's account using a previously stored card token, without capturing the charge. The reservation must be finalized with a Completion transaction or released with a ...
PayFacto API - v1.0 - POST /v1/purchaseWithToken
PayFacto API - v1.0 - POST /v1/purchaseWithToken Obtains a credit card authorization for a financial transaction using a previously stored card token instead of raw card data. Supports E-Commerce (Internet), MOTO (Mail Order / Telephone Order). 1 ...
PayFacto API - v1.0 - POST /v1/ack
PayFacto API - v1.0 - POST /v1/ack Confirms that a transaction response was successfully received and marks the transaction as COMPLETED. Must be sent within 3 minutes of the original transaction response or PayFacto will automatically reverse the ...
PayFacto API - v1.0 - POST /v1/recur/InfoUser
PayFacto API - v1.0 - POST /v1/recur/InfoUser Retrieves all available information on an existing Token stored in the PayFacto Token Vault. Use this endpoint to look up a subscriber's card details, subscription state, and billing history before ...
Next page