The Card Registration Object
You need to register a card in order to process a Direct PayIn. Card registration enables you to tokenize a Card. These are the steps to follow:
- Create a
CardRegistration
Object (1. 2. & 3. in the diagram) - Get a
PreRegistrationData
key (4. in the diagram) - The user posts
PreRegistrationData
,AccessKey
and card details through a form (PHP & JS samples) to theCardRegistrationURL
(5. in the diagram) - Get a
RegistrationData
back (6. in the diagram) - Edit the
CardRegistration
Object (POST method) with theRegistrationData
just received (7.8. in the diagram) - Get the
CardId
ready to use into the Direct PayIn Object (9. in the diagram)
- If you don’t want to save the card you must change the field ACTIVE in the card object to false as shown here
- You need to do your tests in sandbox mode only with the testing cards
- From 24/02/2015, some out-dated browsers will not support payin webs nor card registrations – more info
IMPORTANT: card details must never pass via your server – therefore you must use the card registration process given below and not implement a different system where the card details may touch your server and then you use cURL etc to create the card – (this approach or anything similar) is strictly not allowed
Registration Flow
The card registration method lets you customise your payment page. This page can be hosted on your own.
Here is the registration flow (the last step correponds to the Direct PayIn):
- It is imperative to inform your users if you are registering their cards
- The validity of a registered card (CardId) before a payment or a pre-authorisation is 30min maximum. Once one of these operations is made, the card
Validity
field change to "VALID". Then, it is available up to the expiry date
Parameters
Id
string:
Maximum length is 255 characters
The item's ID
CreationDate
timestamp
When the item was created
Tag
string:
Maximum length is 255 characters
Custom data that you can add to this item
UserId
string:
Maximum length is 255 characters
The object owner's UserId
Currency
Currency:
AED, AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, JPY, NOK, PLN, SEK, USD, ZAR
The currency - should be ISO_4217 format
AccessKey
string:
Maximum length is 255 characters
A special key to use when registering a card
PreregistrationData
string:
Maximum length is 255 characters
A specific value to pass to the CardRegistrationURL
CardRegistrationURL
string:
Maximum length is 255 characters
The URL to submit the card details form to
RegistrationData
string:
Maximum length is 255 characters
Having registered a card, this confirmation hash needs to be updated to the card item
CardType
CardType:
CB_VISA_MASTERCARD, DINERS, AMEX, MAESTRO, P24, IDEAL, BCMC
The type of Card
The type of card . The card type is optional, but the default parameter is "CB_VISA_MASTERCARD" .
CardId
string:
Maximum length is 255 characters
The ID of a card
ResultCode
string:
Maximum length is 255 characters
The result code
ResultMessage
string:
Maximum length is 255 characters
A verbal explanation of the ResultCode
Status
CardStatus:
CREATED, VALIDATED, ERROR
Status of the card registration