CreateMotoTransactionRequest

transaction object

pointOfSaleIduuidrequired

Id of the point of sale to associate the payment with.

Example: 01924737-9c18-71c0-ab1a-88698eaceabf

referencestringnullable

This is the transaction reference, similar to an order ID.
The reference SHOULD be unique for each payment, as some acquirers enforce per-payment uniqueness.
Using a duplicate reference may result in failed payments or make reconciliation difficult.
Only ASCII alphanumeric characters and dashes are allowed.

Worldline specific: - is removed if present and if the value is longer than 12 position, the left most part is used.

Possible values: non-empty and <= 36 characters, Value must match regular expression ^[A-Za-z0-9-]{1,36}$

Example: reference-1

amountintegerrequired

The amount must be defined in minor units. E.g. 2,50 DKK must be set as 250. If amount is set to 0 a token will be created only and returned to the integrator.

Example: 100

currencystringrequired

The currency code of the payment. For Danish Kroner defined as DKK. ISO 4217 alpha-3 (e.g., DKK)

Possible values: Value must match regular expression ^[A-Z]{3}$

Example: DKK

instantCapturestringnullable

If the payment should be captured instantly or not.

• OFF indicates that the payment should not be captured instantly.
• VOID indicates that the payment should be captured instantly and if somehow the instant capture fails the payment is voided.
• NO_VOID indicates that the payment should be captured instantly and if the capture fails the authorization is kept (no void is made)

Possible values: [OFF, VOID, NO_VOID]

Example: OFF

processorProcessor (string)[]nullable

List of processors to use. This is the routing of the payment. The value can be shift4, clearhaus and nets.

Processor priority follows the order in the list. If the first processor fails or declines, the next processor in the list will be attempted, and so on until all processors have been tried. Note that the actual processing order is not guaranteed and may depend on external factors, such as the specific payment card used by the cardholder.

Possible values: [shift4, clearhaus, nets, worldline]

Example: ["shift4"]

textOnStatementstringnullable

This is the text set on the transaction in the bank viewed by the card holder. That can be e.g. "order 123". Defaults to the ePay transaction id. Some providers does not support long texts, ePay will automatically cut the text to fit the providers requirements.

Possible values: non-empty and <= 39 characters

Example: order 123

attributes objectnullable

A list of pass through attributes that is sent back to the merchant on webhooks. Max size is 1kb.

property name*string

customerIdstringnullable

An optional merchant defined customer id used to uniquely identify a user in the merchant system. This field is required to enable stored payment methods and enhanced age verification.

Example: User159

customer object

Customer info. These data points are used during SCA/3DS and is required for some schemes. These data may also be sent to the specific payment provider, if required to complete the payment such as Klarna. It is recommended to send all the info that is available to improve the approval rate.

firstNamestringnullable

The first name of the paying customer.

Possible values: non-empty

Example: Peter

lastNamestringnullable

The last name of the paying customer.

Possible values: non-empty

Example: Nielsen

birthdatedatenullable

The date of birth of the cardholder in YYYY-MM-DD format.

Example: 2000-07-25

emailstringnullable

The email of the paying customer.

Possible values: non-empty

Example: email@example.com

phoneNumberstringnullable

E.164 phone number format with a single space between country code and local number. No additional spaces allowed.

Format: "+[countryCode] [number]".

Possible values: Value must match regular expression ^\+\d{1,3} \d+$

Example: +45 12345678

shippingAddress objectnullable

The shipping address of the purchase. If no wares are shipped, leave this empty. If billing and shipping address is the same, then fill both properties with identical information.

countryCodestringnullable

ISO 3166-1 alpha-2 country code

Possible values: >= 2 characters and <= 2 characters

Example: DK

postalCodestringnullable

The local postal code of the address

Possible values: non-empty and <= 16 characters

Example: 1400

citystringnullable

The city

Possible values: non-empty and <= 50 characters

Example: København

line1stringnullable

The first address line. Most address only has a singular line.

Possible values: non-empty and <= 50 characters

Example: Torvegade 45

line2stringnullable

Second address line. Only use if address contains multiple lines. Always start with line1.

Possible values: non-empty and <= 50 characters

Example: 2. th.

line3stringnullable

Third address line. Only use if address contains multiple lines. Always start with line1 and line2.

Possible values: non-empty and <= 50 characters

Example: Christianshavn

billingAddress objectnullable

The billing address of the customer. Often the personal address of the customer or the business address of paying company. If billing and shipping address is the same, then fill both properties with identical information.

countryCodestringnullable

ISO 3166-1 alpha-2 country code

Possible values: >= 2 characters and <= 2 characters

Example: DK

postalCodestringnullable

The local postal code of the address

Possible values: non-empty and <= 16 characters

Example: 1400

citystringnullable

The city

Possible values: non-empty and <= 50 characters

Example: København

line1stringnullable

The first address line. Most address only has a singular line.

Possible values: non-empty and <= 50 characters

Example: Torvegade 45

line2stringnullable

Second address line. Only use if address contains multiple lines. Always start with line1.

Possible values: non-empty and <= 50 characters

Example: 2. th.

line3stringnullable

Third address line. Only use if address contains multiple lines. Always start with line1 and line2.

Possible values: non-empty and <= 50 characters

Example: Christianshavn

preAuthUrlurinullable

If not null then pre-authorization webhook are enabled for all transaction attempts for the session. Max length is 1024.

Possible values: non-empty and <= 1024 characters

Example: https://example.com/preAuth

subscription object

iduuid

An optional subscription ID can be used to update an existing active subscription with new payment details, such as a new card or a completely different payment method.

amountinteger

An optional amount in minor units (e.g., 1095 = 10.95 DKK) that can be used to differentiate the recurring subscription amount from the current transaction amount. This is useful if customers are not expected to pay today, but must pay a monthly fee going forward - In this case set amount=0 and subscription.amount=XXX. Defaults to the transaction amount if not given.

typestringrequired

The type of subscription.

• UNSCHEDULED Pay-as-you-go type subscriptions with no fixed interval for charges.
• SCHEDULED Fixed interval charges like a subscription paid monthly.

Possible values: [UNSCHEDULED, SCHEDULED]

Example: SCHEDULED

referencestring

An optional merchant defined reference for the subscription. If none is given, then the session reference will be used as a fallback.

Example: subscription-1

expiryDatedate

An optional field indicating the expiry of the subscription. This date is used during 3DS, and may improve conversion rates. ePay does not reject payments after this date.

interval object

An optional subscription schedule for SCHEDULED type subscriptions. Must be omitted for UNSCHEDULED type subscriptions. Is required by some payment methods such as Vipps Mobilepay. Is used during 3DS - May improve conversion rates.

periodstringrequired

The period unit between charges

Possible values: [DAY, WEEK, MONTH, YEAR]

frequencyintegerrequired

The number of period units between each charge. 1-31. Example: Frequency: 3, Period: DAY One charge every 3 days.

paymentMethod object

card object

cardNumberstring

The primary account number (PAN) of the card to charge. Must be Luhn compliant.

Possible values: >= 15 characters and <= 19 characters

Example: 1234567812345678

expiryMonthstring

The month part of the expiry of the card to charge.

Possible values: >= 2 characters and <= 2 characters

Example: 07

expiryYearstring

The year part of the expiry of the card to charge.

Possible values: >= 2 characters and <= 2 characters

Example: 35

securityCodestring

The CVV / CVC of the card to charge

Possible values: >= 2 characters and <= 3 characters

Example: 123

brandstringnullable

An optional parameter that can be used to choose which brand of a cobranded card to charge. Such as when payment with a VisaDankort card. Otherwise leave blank.

Example: Visa

CreateMotoTransactionRequest

{
  "transaction": {
    "pointOfSaleId": "01924737-9c18-71c0-ab1a-88698eaceabf",
    "reference": "reference-1",
    "amount": 100,
    "currency": "DKK",
    "instantCapture": "OFF",
    "processor": [
      "shift4"
    ],
    "textOnStatement": "order 123",
    "attributes": {},
    "customerId": "User159",
    "customer": {
      "firstName": "Peter",
      "lastName": "Nielsen",
      "birthdate": "2000-07-25",
      "email": "email@example.com",
      "phoneNumber": "+45 12345678",
      "shippingAddress": {
        "countryCode": "DK",
        "postalCode": "1400",
        "city": "København",
        "line1": "Torvegade 45",
        "line2": "2. th.",
        "line3": "Christianshavn"
      },
      "billingAddress": {
        "countryCode": "DK",
        "postalCode": "1400",
        "city": "København",
        "line1": "Torvegade 45",
        "line2": "2. th.",
        "line3": "Christianshavn"
      }
    },
    "preAuthUrl": "https://example.com/preAuth",
    "subscription": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "amount": 0,
      "type": "SCHEDULED",
      "reference": "subscription-1",
      "expiryDate": "2024-07-29",
      "interval": {
        "period": "DAY",
        "frequency": 0
      }
    }
  },
  "paymentMethod": {
    "card": {
      "cardNumber": 1234567812345678,
      "expiryMonth": "07",
      "expiryYear": "35",
      "securityCode": "123",
      "brand": "Visa"
    }
  }
}