DocsNADDeregistration

Deregistration

See also API reference for NAD

Check API

Deregistration is used to deactivate a proxy from NAD. Once deregistration is successful, the proxy will not be allowed to be used for Pay by Proxy

Participant will allow Customer to deregister Active or Suspended proxy provided that the proxy is suspended by the Customer. For proxy that is suspended by the Participant, Customer will only be able to see the proxy and not allowed to perform any changes on it

In NAD deregistration, Enquiry by Secondary ID request is initiated first to retrieve all the Customer’s registered proxies in NAD. Participant will display the list of proxies for the Customer – proxies where the status is Active, Suspended (by the Customer) and Suspended (by the Participant)

If there is no record to be displayed, Participant will display a message to the Customer

Please note that Customer should not be able to deregister a proxy that is registered with another Participant or Suspended by Participant

Sample Use Cases

Sample Participant Proxy Deregistration

Proxy Deregistration Conditions

Proxy Exists	Exists in the same Participant	Same Account	Proxy Status	Action By RPP	Action by Participant
No	-	-	-	Scenario is not applicable	-
Yes	Yes	-	SUSPENDED (by Customer)	Deregister Proxy	Display Deregistration Accepted
Yes	Yes	-	SUSPENDED (by Participant)	Scenario is not applicable. Record can only be viewed	-
Yes	Yes	-	ACTIVE	Deregister Proxy	Display Deregistration Accepted
Yes	No	-	INACTIVE	Scenario is not applicable	-
Yes	No	-	SUSPENDED (by Customer)	Scenario is not applicable. Record can only be viewed	-
Yes	No	-	SUSPENDED (by Participant)	Scenario is not applicable. Record can only be viewed	-
Yes	No	-	ACTIVE	Scenario is not applicable. Record can only be viewed	-

Successful End-to-End Proxy Deregistration Flow

Step	Sender	Receiver	Processes
1	Customer	OFI	Customer logs into Online Banking or Mobile Banking app and initiates a Proxy Deregistration via corresponding menu/link
2	OFI	RFI	OFI performs the following: Authorize and validate the Proxy menu request Any other validations If all validations are successful: Send Enquiry by Secondary Id message request
3	RPP	OFI	RPP performs the following: Message Validations Business Validations Proxy Validations If any of the validations are not successful: Send a NEGATIVE/REJECT response If all validations are successful: Send all registered proxies along with related account information
4	OFI	Customer	OFI performs the following: Message Validations Business Validations If all validations are successful: If SUCCESSFUL response is received: Display a successful message to the Customer If UNSUCCESSFUL response ** received: Display an error message to the Customer Notes: OFI will not be able to modify proxy under Suspended status. This will only be displayed for Customer to view OFI will not be able to modify proxy belonging to another Participant. This will only be displayed for Customer to view
5	Customer	OFI	Customer performs the following: Review the information Select the proxy to be updated Confirm the proxy to be updated
6	OFI	RPP	OFI performs the following: Authorize and validate the Proxy Deregistration request Any other validations If all validations are successful: Send Proxy Deregistration message request
7	RPP	OFI	RPP performs the following: Message Validations Business Validations Proxy Validations If any of the validations are not successful: Send a NEGATIVE/REJECT response If all validations are successful: Deregister the proxy and account from NAD Set the status to Inactive Send Proxy Deregistration message response
8	OFI	Customer	OFI performs the following: Message Validations Business Validations If all validations are successful: If SUCCESSFUL response is received: Display a successful message to the Customer If UNSUCCESSFUL response is received: Display an error message to the Customer

Notes:

• The exception scenarios will be handled similarly to Account Enquiry flows

Exception Conditions

Rejected by RPP

Below are some of the conditions that the request may be rejected

No	Condition	Description	Action
1	Message Validation Error	An invalid message was sent to RPP. Some of the possible causes are: Unknown inbound message is received Message signature could not be verified Failed in message parsing Mandatory field validation has failed	RPP will not send the request to RFI. A REJECT response will be returned to OFI Notes: A copy of the request message in FULL will be returned in the REJECT response in <AddtlData> field. This can be used by the sender to investigate the issue with the message
2	Proxy Validation Error	RPP performs the following business validations: Customer has at least one registered proxy Proxy is registered in NAD Proxy is active	A NEGATIVE response will be sent to the OFI

Timeout

Below are some of the conditions that a timeout could occur

No	Condition	Description	Action
1	RPP failed to receive any incoming request from OFI	Request was sent by OFI but RPP failed to receive the request	OFI will display timeout error message to the Customer
2	OFI failed to receive or process response from RPP	RPP has responded to the OFI but OFI failed to receive the response	OFI will display timeout error message to the Customer Notes: It is recommended to perform an enquiry to check on the status of previous request

Message Schema

Below illustrates the message schema to be used for each transaction leg. For actual schema and message version, please refer to the API specifications instead

No	Condition	Scenario	Sender	Receiver	Message Schema Out: From Sender In: To Receiver
1	Proxy Deregistration Accepted	-	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
		-	RPP	OFI	Out: prxy.006.001.01 In: prxy.006.001.01
		-	OFI	RPP	Out: prxy.001.001.01 In: prxy.001.001.01
		-	RPP	OFI	Out: prxy.002.001.01 In: prxy.002.001.01
2	Message Validation Failure 1	Request from OFI: Signature could not be verified Message parsing failed Mandatory fields level validation failed Unknown inbound message	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
			RPP	OFI	Out: admi.002.001.01 In: admi.002.001.01
			OFI	RPP	Out: NA In: NA
			RPP	OFI	Out: NA In: NA
3	Message Validation Failure 2	Request from OFI: Signature could not be verified Message parsing failed Mandatory fields level validation failed Unknown inbound message	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
			RPP	OFI	Out: prxy.006.001.01 In: prxy.006.001.01
			OFI	RPP	Out: prxy.001.001.01 In: prxy.001.001.01
			RPP	OFI	Out: admi.002.001.01 In: admi.002.001.01
4	Message Validation Failure 3	Enquiry response from RPP: Signature could not be verified	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
			RPP	OFI	Out: prxy.006.001.01 In: prxy.006.001.01
			OFI	RPP	Out: NA In: NA
			RPP	OFI	Out: NA In: NA
5	Message Validation Failure 4	Modification response from RPP: Signature could not be verified	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
			RPP	OFI	Out: prxy.006.001.01 In: prxy.006.001.01
			OFI	RPP	Out: prxy.001.001.01 In: prxy.001.001.01
			RPP	OFI	Out: pxy.002.001.01 In: prxy.002.001.01
6	Proxy Validation Failure 1	Proxy validation includes: Customer has at least one registered proxy Proxy is registered in NAD Proxy is active RPP returns a negative response due to duplicate proxy	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
			RPP	OFI	Out: prxy.006.001.01 In: prxy.006.001.01
			OFI	RPP	Out: prxy.001.001.01 In: prxy.001.001.01
			RPP	OFI	Out: pxy.002.001.01 In: prxy.002.001.01
7	Timeout 1	RPP did not receive request	OFI	RPP	Out: prxy.005.001.01 In: NA
			RPP	OFI	Out: NA In: NA
			OFI	RPP	Out: NA In: NA
			RPP	OFI	Out: NA In: NA
8	Timeout 2	RPP did not receive request	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
			RPP	OFI	Out: prxy.006.001.01 In: prxy.006.001.01
			OFI	RPP	Out: prxy.001.001.01 In: NA
			RPP	OFI	Out: NA In: NA
9	Timeout 3	OFI did not receive response	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
			RPP	OFI	Out: prxy.006.001.01 In: NA
			OFI	RPP	Out: NA In: NA
			RPP	OFI	Out: NA In: NA
10	Timeout 4	OFI did not receive response	OFI	RPP	Out: prxy.005.001.01 In: prxy.005.001.01
			RPP	OFI	Out: prxy.006.001.01 In: prxy.006.001.01
			OFI	RPP	Out: prxy.001.001.01 In: prxy.001.001.01
			RPP	OFI	Out: prxy.002.001.01 In: NA

See also

• Recommended validation
• How does account enquiry work