TPN Register
The TPN register is used to download the parameters to configure the merchant configuration data from the backend application portal.
Always perform a parameter update in the iPOSgo! app after making any changes to parameter settings on the iPOSpays portal to ensure the latest configurations are applied.
Watch This Video for a Visual Walkthrough of the Steps
Input Request Parameters
- To access the SDK Reader wrapper class, import DeepLinking, and initiate an instance of the class as follows:
import DeepLinking
- Create a variable to access the methods
var readerInstance = Wrapper()
API CALL
struct RegisterData: Register
{
var tpn: String
var merchantCode: String
}
let payload = RegisterData(tpn: "12345678912", merchantCode: "12345678912")
readerInstance.downloadParameter(param: payload)Parameter Name
Parameters Name | Description |
TPN | A unique 12-digit code assigned to the device that processes the transaction. |
merchantCode | Unique code to identify the merchant |
Delegate Response and Error Handling
To handle responses and errors from the SDK, implement the DLProtocolV2 delegate methods as shown below:
extension ViewController: DLProtocolV2 {
func didReceiveRespV2Error(err: String?) {
print(">>>>>>ERROR :", err ?? "")
}
func didReceiveV2Response(success: URL?) {
print(">>>>>url", success ?? "")
}
func didReceive_TransactionResponse(res: String?) {
print(">>>res", res ?? "")
}
}Transaction Response Structure
The didReceive_TransactionResponse(res:) method returns the following response, which allows the user to track transaction details:
transactionData: {
"TPN": "794525543578",
"TimeStamp": "20250602115852",
"TXN Ref No": "830266506984"
}This response provides essential metadata for the transaction that was just processed.
It includes:
Parameters Name | Description |
TPN | A unique 12-digit code assigned to the device that processes the transaction. |
TimeStamp | The exact date and time of the transaction, in YYYYMMDDhhmmss format. |
TXN Ref No | A unique reference number assigned to the transaction. |
These values can be used to log, track, or reconcile transactions.
To obtain the Merchant Code:
Log in to the iPOSpays portal using a merchant account.
Go to Settings → Generate ECOM/TOP Merchant Keys. Choose a Tap on Phone (TOP) TPN from the drop-down menu → copy the merchant code and save it.
On this page
- TPN Register