Interactive Profiles
Interactive profiles offer the customer the possibility to use the stored payment data for further payments. Upon each use of a profile the customer is prompted to enter additional data if necessary. For credit card transactions the CVC2 (CVV) will be required to complete the transaction. Also, if the credit card is registered for 3-DS, the customer is redirected to the 3-DS website for authentication.
The merchant's account needs to be configured for interactive profile usage.
The interactive usage of profiles allows to store more than one payment detail (or profile) per customer ID. Therefore it is necessary to access profiles by the customerID
and the profileID
. The profileID
is set by the customer and only unique per customerID
.
Possible payment types
Currently allowed payment systems (pType
) for interactive payment profiles are credit cards (CC
), direct debit (ELV
).
Maximum number of profiles
The
customerID
can contain a maximum of 20 payment profiles.
If the maximum number of profiles have been reached and another profile creation is attempted, the returnCode
PROFILE_COUNT_EXCEEDED
is returned.
Available operations
General operations to implement interactive profile payments:
ListProfiles
DeleteProfile
Depending on the used integration, the following additional operations are needed:
- Redirect Integration:
SelectPayment
- Backend2Backend Integration:
AcceptPayment
Integration steps
Only the Redirect Integration is discussed further. Please contact the mPAY24 Support for more information about the profile usage with Backend2Backend Integration.
Enable profile usage
To enable profile usage for customers, the merchant has to provide the unique customer ID within the SelectPayment
request. Then the customer can store his payment details during the payment. To store a profile the customer enters a profile name (which must be unique per customer) and his payment details. The profile is only created if a successful transaction could be made with these details. E.g. if the card is expired, no profile is stored.
The following example shows the use of payment profiles with SelectPayment
. The customer with ID customer0012
can use all stored payment profiles or even create a new profile during the payment process.
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:etp="https://www.mpay24.com/soap/etp/1.5/ETP.wsdl">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<etp:SelectPayment>
<merchantID>90000</merchantID>
<mdxi>
<Order>
<Tid>825381</Tid>
<Price>1.00</Price>
<Customer Id="customer0012"/>
</Order>
</mdxi>
</etp:SelectPayment>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Upon initiating a new payment with the customerID
, the customer can choose to use the saved payment data (interactive profile usage) or carry out the transaction without using a profile.
The customer can not be forced to save a profile.
List profiles of a customer
With the ListProfiles
all customers and profiles of a merchant can be listed. It can be used to create a list of profiles stored by a specific customer.
The following request returns all payment profiles stored for the customer with ID customer0012
.
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:etp="https://www.mpay24.com/soap/etp/1.5/ETP.wsdl">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<etp:ListProfiles>
<merchantID>90000</merchantID>
<customerID>customer0012</customerID>
</etp:ListProfiles>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Delete profiles
The DeleteProfile
operation can delete either all or a specific payment profiles of a customer.
- If only a
customerID
is provided, all payment profiles are deleted. - If a
profileID
is provided, only this payment profile is deleted.
In the following example the profile with name Visa private
of the customer customer0012
is deleted.
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:etp="https://www.mpay24.com/soap/etp/1.5/ETP.wsdl">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<etp:DeleteProfile>
<merchantID>90000</merchantID>
<customerID>customer0012</customerID>
<profileID>Visa private</profileID>
</etp:DeleteProfile>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Contact the mPAY24 Support for further information regarding using interactive profiles for recurrent payments.
Updated 9 months ago