Skip to main content

Transfer Bank

See also API reference for NAD

This request is initiated when the Proxy Id (belonging to the same Customer) that the Customer is registering has already been registered with another Participant. The name of the Participant where the Proxy is registered will be displayed and confirmed with the Customer whether to proceed to transfer the proxy to the account of the current Participant. Upon confirmation of the Customer, Participant will send the request to Transfer Bank to RPP

The request can be initiated at the point of registration, or from the Enquiry by Secondary Id. For more information, refer to the respective sections

Successful End-to-End Proxy Transfer Bank Flow


StepSenderReceiverProcesses
1CustomerOFICustomer logs into Online Banking or Mobile Banking app and initiates a Proxy Transfer Bank via corresponding menu/link
2OFIRPPOFI 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
3RPPOFIRPP performs the following:If any of the validations are not successful:
  • Send a NEGATIVE/REJECT response
If all validations are successful:
  • Send all the registered proxies along with related account information
4OFICustomerOFI performs the following: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:
  • 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
5CustomerOFICustomer performs the following:
  • Review the information
  • Select the proxy to be updated
  • Confirm the proxy to be updated
6OFIRPPOFI performs the following:
  • Authorize and validate the Proxy Deregistration request
  • Any other validations
If all validations are successful:
  • Send Proxy Deregistration message request
7RPPOFIRPP performs the following:If any of the validations are not successful:
  • Send a NEGATIVE/REJECT response
If all validations are successful:
  • Create a new registration record
    • Creating a new proxy registration number
    • Copying the previous proxy information and update details with the new information (Participant name, account number and etc)
    • Set the status to Active
    • Set the old proxy registration record to Inactive
  • Send Proxy Registration message response
8OFICustomerOFI performs the following: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 Flows – Different Proxy Id


ConditionActionAlternatives
Customer selects a proxy to transfer bank, but the selected Proxy Id is different from OFI’s customer recordOFI shall:
  • Reject the Customer request
  • Display an appropriate error message to the Customer
  • Stop processing
-

Exception Conditions

Rejected by RPP

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

NoConditionActionAlternatives
1Message Validation ErrorAn 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
2Proxy Validation ErrorRPP 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

NoConditionActionAlternatives
1RPP failed to receive any incoming request from OFIRequest was sent by OFI but RPP failed to receive the requestOFI will display timeout error message to the Customer
2OFI failed to receive response from RPPRPP has responded to the OFI but OFI failed to receive the responseOFI 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

NoConditionScenarioSenderReceiverMessage Schema

Out: From Sender
In: To Receiver
1Proxy Transfer Bank AcceptedOFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: prxy.002.001.01
In: prxy.002.001.01
RPPPrevious OFIOut: prxy.901.001.01
In: prxy.901.001.01
2Message Validation Failure 1Request from OFI:
  • Signature could not be verified
  • Message parsing failed
  • Mandatory fields level validation failed
  • Unknown inbound message
OFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: admi.002.001.01
In: admi.002.001.01
OFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: prxy.002.001.01
In: prxy.002.001.01
3Message Validation Failure 2Response from RPP:
  • Signature could not be verified
OFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: prxy.002.001.01
In: prxy.002.001.01
4Proxy Validation FailureProxy validation includes:
  • Proxy has been registered and linked to another account (another Participant)
  • Number of proxies linked to the account has been exceeded
RPP returns a negative response due to duplicate proxy
OFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: prxy.002.001.01
In: prxy.002.001.01
OFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: pxy.002.001.01
In: prxy.002.001.01
5Proxy Transfer ValidationOFI checks the Proxy Id against Customer’s Proxy Id on recordOFIRPPOut: prxy.005.001.01
In: prxy.005.001.01
RPPOFIOut: prxy.006.001.01
In: prxy.006.001.01
OFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: prxy.002.001.01
In: prxy.002.001.01
6Timeout 1RPP did not receive requestOFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: NA
In: NA
7Timeout 2OFI did not receive requestOFIRPPOut: prxy.001.001.01
In: prxy.001.001.01
RPPOFIOut: prxy.002.001.01
In: NA

See also