Initiate adding a card on file for the organisation

post

https://eclipse-java-sandbox.ukheshe.rocks/eclipse-conductor/rest/v1/tenants/{tenantId}/organisations/{organisationId}/cards-on-file

Three scenarios are supported: (1) provide a cardId and alias to add an Eclipse-issued card as a Card on File; (2) provide neither cardId nor card data to receive an iFrame completion URL for the organisation to enter card details; (3) PCI-DSS compliant tenants may send card data directly to create the Card on File immediately.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

tenantId

int64

required

organisationId

int64

required

Body Params

Initiate addition of a card on file for a customer. This could be any credit/debit card not necessarily issued by Eclipse

alias

string

length between 1 and 50

Alias (some friendly name e.g. HSBC Gold Card) chosen by the customer for the card they are about to add. Required if cardId or cardData is provided directly as the customer wont be asked for a card alias in those cases.

authenticated

boolean

Optional. If provided and set to true, Eclipse will try to do a zero-based authenticated payment, expect to receive a completionUrl to complete 3DS flow.

callbackUrl

string

length between 10 and 2000

^http(s)?:\/\/.*\..*$

The URL Eclipse must post the EclipseCardOnFile to when the card is registered successfully

cardData

object

The card data

cardId

int64

Used to add an existing Eclipse issued card as a card on file

defaultCardOnFile

boolean

Optional. If provided then this card on file mark as default for this customer Only one default cardOnFile is allowed for customer.)

deleteAt

date-time

Optional. If provided then the card will only remain on file up till this date after which it will be deleted permanently (hard delete)

externalUniqueId

string

landingUrl

string

length between 10 and 2000

Where the customers iFrame/Browser should be navigated to after adding the card on file. If the URL contains <cardOnFileId> then it will be replaced with the cardOnFileId before the redirect.

reference

string

templateId

string

Optional. If provided then card ui will be rendered based on the provided templateId else fallback to default tenant template.

Responses

400

Bad Request

200OK

500Internal Server Error