Register

Last updated: August 1, 2026 | Guide version: 1.0.8

Used when only register data will be sent to the Payment App to complete the registration process without any following payment operation. Payment app will do the registration and inform the merchant (sales) app side about the result.

Registering during a payment. A Payment request can also carry registerParameters. If the terminal is already registered with the same credentials, you do not need to send them again.

Call example

App2AppRequest app2AppRequest = new App2AppRequest();

RegisterParameters registerParameters = new RegisterParameters();
registerParameters.setMerchantId("SOFTPOSMERCHANT");
registerParameters.setTerminalId("TERMINAL");
registerParameters.setActivationCode("123456");
app2AppRequest.setRegisterParameters(registerParameters);

app2AppService.getOnlyRegister(app2appRequest, eventListener);

Request and response

Request

"onlyRegister": {
  "registerParameters": {
    "terminalId": "16010129",
    "merchantId": "000000009041042",
    "activationCode": "testCode"
  }
}

Success response

"response": {
  "a2aCode": "1009",
  "a2aMessage": "Registration successful"
}

Error response

"response": {
  "a2aCode": "1003",
  "a2aMessage": "Register error : Server Error please contact with your administrator",
  "errorCode": "104",
  "errorMainCode": "9",
  "errorSubCode": "32"
}