com.worldline.connect.sdk.java.v1.domain

Class OrderReferences

java.lang.Object

com.worldline.connect.sdk.java.v1.domain.OrderReferences

public class OrderReferences
extends Object

Constructor Summary

Constructors

Constructor and Description
OrderReferences()

Method Summary

Modifier and Type	Method and Description
String	getDescriptor() Descriptive text that is used towards to customer, either during an online checkout at a third party and/or on the statement of the customer.
OrderInvoiceData	getInvoiceData() Object containing additional invoice data
Long	getMerchantOrderId() Your order identifier Note: This does not need to have a unique value for each transaction.
String	getMerchantReference() Note that the maximum length of this field for transactions processed on the GlobalCollect platform is 30. Note that the maximum length of this field for transactions processed on the WL Online Payment Acceptance Platform platform is 50. Your unique reference of the transaction that is also returned in our report files.
String	getProviderId() Provides an additional means of reconciliation for Gateway merchants
String	getProviderMerchantId() Provides an additional means of reconciliation, this is the MerchantId used at the provider
void	setDescriptor(String value) Descriptive text that is used towards to customer, either during an online checkout at a third party and/or on the statement of the customer.
void	setInvoiceData(OrderInvoiceData value) Object containing additional invoice data
void	setMerchantOrderId(Long value) Your order identifier Note: This does not need to have a unique value for each transaction.
void	setMerchantReference(String value) Note that the maximum length of this field for transactions processed on the GlobalCollect platform is 30. Note that the maximum length of this field for transactions processed on the WL Online Payment Acceptance Platform platform is 50. Your unique reference of the transaction that is also returned in our report files.
void	setProviderId(String value) Provides an additional means of reconciliation for Gateway merchants
void	setProviderMerchantId(String value) Provides an additional means of reconciliation, this is the MerchantId used at the provider

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OrderReferences

public OrderReferences()

Method Detail

getDescriptor

public String getDescriptor()

Descriptive text that is used towards to customer, either during an online checkout at a third party and/or on the statement of the customer. For card transactions this is usually referred to as a Soft Descriptor. The maximum allowed length varies per card acquirer:

• AIB - 22 characters
• American Express - 25 characters
• Atos Origin BNP - 15 characters
• Barclays - 25 characters
• Catella - 22 characters
• CBA - 20 characters
• Elavon - 25 characters
• First Data - 25 characters
• INICIS (INIPAY) - 22-30 characters
• JCB - 25 characters
• Merchant Solutions - 22-25 characters
• Payvision (EU & HK) - 25 characters
• SEB Euroline - 22 characters
• Sub1 Argentina - 15 characters
• Wells Fargo - 25 characters

Note that we advise you to use 22 characters as the max length as beyond this our experience is that issuers will start to truncate. We currently also only allow per API call overrides for AIB and Barclays
For alternative payment products the maximum allowed length varies per payment product:

• 402 e-Przelewy - 30 characters
• 404 INICIS - 80 characters
• 802 Nordea ePayment Finland - 234 characters
• 809 iDeal - 32 characters
• 836 SOFORT - 42 characters
• 840 PayPal - 127 characters
• 841 WebMoney - 175 characters
• 849 Yandex - 64 characters
• 861 Alipay - 256 characters
• 863 WeChat Pay - 32 characters
• 880 BOKU - 20 characters
• 8580 Qiwi - 255 characters
• 1504 Konbini - 80 characters

All other payment products don't support a descriptor.

setDescriptor

public void setDescriptor(String value)

Descriptive text that is used towards to customer, either during an online checkout at a third party and/or on the statement of the customer. For card transactions this is usually referred to as a Soft Descriptor. The maximum allowed length varies per card acquirer:

• AIB - 22 characters
• American Express - 25 characters
• Atos Origin BNP - 15 characters
• Barclays - 25 characters
• Catella - 22 characters
• CBA - 20 characters
• Elavon - 25 characters
• First Data - 25 characters
• INICIS (INIPAY) - 22-30 characters
• JCB - 25 characters
• Merchant Solutions - 22-25 characters
• Payvision (EU & HK) - 25 characters
• SEB Euroline - 22 characters
• Sub1 Argentina - 15 characters
• Wells Fargo - 25 characters

Note that we advise you to use 22 characters as the max length as beyond this our experience is that issuers will start to truncate. We currently also only allow per API call overrides for AIB and Barclays
For alternative payment products the maximum allowed length varies per payment product:

• 402 e-Przelewy - 30 characters
• 404 INICIS - 80 characters
• 802 Nordea ePayment Finland - 234 characters
• 809 iDeal - 32 characters
• 836 SOFORT - 42 characters
• 840 PayPal - 127 characters
• 841 WebMoney - 175 characters
• 849 Yandex - 64 characters
• 861 Alipay - 256 characters
• 863 WeChat Pay - 32 characters
• 880 BOKU - 20 characters
• 8580 Qiwi - 255 characters
• 1504 Konbini - 80 characters

All other payment products don't support a descriptor.

getInvoiceData

public OrderInvoiceData getInvoiceData()

Object containing additional invoice data

setInvoiceData

public void setInvoiceData(OrderInvoiceData value)

Object containing additional invoice data

getMerchantOrderId

public Long getMerchantOrderId()

Your order identifier
Note: This does not need to have a unique value for each transaction. This allows your to link multiple transactions to the same logical order in your system.

setMerchantOrderId

public void setMerchantOrderId(Long value)

Your order identifier
Note: This does not need to have a unique value for each transaction. This allows your to link multiple transactions to the same logical order in your system.

getMerchantReference

public String getMerchantReference()

Note that the maximum length of this field for transactions processed on the GlobalCollect platform is 30.

Note that the maximum length of this field for transactions processed on the WL Online Payment Acceptance Platform platform is 50.

Your unique reference of the transaction that is also returned in our report files. This is almost always used for your reconciliation of our report files.

setMerchantReference

public void setMerchantReference(String value)

Note that the maximum length of this field for transactions processed on the GlobalCollect platform is 30.

Note that the maximum length of this field for transactions processed on the WL Online Payment Acceptance Platform platform is 50.

Your unique reference of the transaction that is also returned in our report files. This is almost always used for your reconciliation of our report files.

getProviderId

public String getProviderId()

Provides an additional means of reconciliation for Gateway merchants

setProviderId

public void setProviderId(String value)

Provides an additional means of reconciliation for Gateway merchants

getProviderMerchantId

public String getProviderMerchantId()

Provides an additional means of reconciliation, this is the MerchantId used at the provider

setProviderMerchantId

public void setProviderMerchantId(String value)

Provides an additional means of reconciliation, this is the MerchantId used at the provider