Inbound AVS-R

Inbound AVS-R transactions will be handled differently depending on whether or not you make use of Electrum’s Account Mirror.

If You Use the Electrum Account Mirror

Electrum will handle all incoming AVS-R requests using the Electrum Account Mirror and will deal with BankservAfrica directly with no involvement from your core banking system. So, there is nothing that you need to implement for the processing of inbound AVS-R. However it is very important that Electrum’s Account Mirror is kept up to date. See this page for more details on how to inform the Electrum Account Mirror of any updates to your accounts records.

If You do Not Use the Electrum Account Mirror

If you choose not to use Electrum’s Account Mirror, then Electrum will forward each incoming AVS-R request to you.

avs-r inbound

Electrum sends you an inboundAccountVerification message (AccountVerificationRequest schema) requesting that you verify a customer account held at your bank.

AccountVerificationRequest Schema

required	object (MessageIdentifiers) Holds a point-to-point unique message identification string as well as a message's creation date time.
	object (SupplementaryData) A list of key-value pairs to support adding any supplementary/additional data to an Electrum Regulated Payments API message.
required	object (TransactionIdentifiers) Holds a series of identifiers to identify the transaction or an individual message that is part of a transaction.
required	object (Party) This model is the basic representation of a Party. It is expanded on depending on whether the party is a person or an organisation.
required	object (Party) This model is the basic representation of a Party. It is expanded on depending on whether the party is a person or an organisation.
	object (Party) This model is the basic representation of a Party. It is expanded on depending on whether the party is a person or an organisation.
	object (InstitutionIdentification)
schema required	string Value: "AccountVerificationRequest"
required	object (Verification)

You return an inboundAccountVerificationReport message (AccountVerificationResponse schema) containing the results of the account verification.

AccountVerificationResponse Schema

required	object (MessageIdentifiers) Holds a point-to-point unique message identification string as well as a message's creation date time.
	object (SupplementaryData) A list of key-value pairs to support adding any supplementary/additional data to an Electrum Regulated Payments API message.
required	object (TransactionIdentifiers) Holds a series of identifiers to identify the transaction or an individual message that is part of a transaction.
required	object (Party) This model is the basic representation of a Party. It is expanded on depending on whether the party is a person or an organisation.
required	object (Party) This model is the basic representation of a Party. It is expanded on depending on whether the party is a person or an organisation.
	object (Party) This model is the basic representation of a Party. It is expanded on depending on whether the party is a person or an organisation.
	object (InstitutionIdentification)
	object (Assignment)
	object (MessageIdentifiers) Holds a point-to-point unique message identification string as well as a message's creation date time.
	object (Verification)
	object (VerificationReport)
schema required	string Value: "AccountVerificationResponse"
	object (Status)