Properties
To honour the COF guidelines and to instruct our platform to process transactions accordingly, the DirectAPI implements a set of properties. Each JSON in our collection representing the use cases contain the respective properties and its correct value.
Property | Description |
---|---|
cardPaymentMethodSpecificInput.tokenize |
Indicates that you want to tokenise the card used in this transaction. Fixed value "true". For every successful transaction, our platform returns a cardPaymentMethodSpecificInput.token |
cardPaymentMethodSpecificInput.isRecurring |
Indicates that this payment is part of a series of recurring payments (sample A). Your customers have authorised you to charge fixed amounts (MITs) on a recurring basis (i.e. for subscriptions) as a standing instruction (sample E). Fixed value "true". |
cardPaymentMethodSpecificInput.recurring. recurringPaymentSequenceIndicator |
Indicates that this payment is the first of a series of recurring payments (sample A). Your customers have authorised you to charge fixed amounts (MITs) on a recurring basis (i.e. for subscriptions) as a standing instruction (sample E). Fixed value "first". |
cardPaymentMethodSpecificInput.unscheduledCardOnFileRequestor |
Indicates the requestor of this transaction:
|
cardPaymentMethodSpecificInput. unscheduledCardOnFileSequenceIndicator |
Indicates that this payment is part of a series of unscheduled recurring payments:
|
cardPaymentMethodSpecificInput.threeDSecure. challengeIndicator |
Manage 3-D Secure for initial/subsequent payments. Indicate the preferred 3-D Secure flow for this transaction. |
cardPaymentMethodSpecificInput.token hostedCheckoutSpecificInput.tokens |
The card profile(s) stored on our platform for CIT subsequent payments (sample C). |
subsequentCardPaymentMethodSpecificInput. subsequentType |
Describes the fair use of card data for MITs without a token (samples D through J). Depending on the use case, different values apply:
The following values describe established industry practices, allowing you to process transactions without your customers' explicit consent:
|
{payment.id} |
The payment.id of the previous transaction from a payment series (samples D through J). Add it as a path parameter to the SubsequentPayment endpoint Url. |