Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/Adyen/Model/Payments/AdditionalDataLevel23.php
Original file line number Diff line number Diff line change
Expand Up @@ -542,7 +542,7 @@ public function getEnhancedSchemeDataItemDetailLineItemNrCommodityCode()
/**
* Sets enhancedSchemeDataItemDetailLineItemNrCommodityCode
*
* @param string|null $enhancedSchemeDataItemDetailLineItemNrCommodityCode The code that identifies the item in a standardized commodity coding scheme. There are different commodity coding schemes: * [UNSPSC commodity codes](https://www.unspsc.org/) * [HS commodity codes](https://www.wcoomd.org/en/topics/nomenclature/overview.aspx) * [NAICS commodity codes](https://www.census.gov/naics/) * [NAPCS commodity codes](https://www.census.gov/naics/napcs/) * Encoding: ASCII * Max length: 12 characters * Must not start with a space or be all spaces. * Must not be all zeros.
* @param string|null $enhancedSchemeDataItemDetailLineItemNrCommodityCode The code that identifies the item in a standardized commodity coding scheme. There are different commodity coding schemes: * [UNSPSC commodity codes](https://www.ungm.org/public/unspsc) * [HS commodity codes](https://www.wcoomd.org/en/topics/nomenclature/overview.aspx) * [NAICS commodity codes](https://www.census.gov/naics/) * [NAPCS commodity codes](https://www.census.gov/naics/napcs/) * Encoding: ASCII * Max length: 12 characters * Must not start with a space or be all spaces. * Must not be all zeros.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The link for UNSPSC commodity codes has been updated. This is a good documentation update to ensure accuracy.

*
* @return self
*/
Expand Down Expand Up @@ -782,7 +782,7 @@ public function getEnhancedSchemeDataTotalTaxAmount()
/**
* Sets enhancedSchemeDataTotalTaxAmount
*
* @param string|null $enhancedSchemeDataTotalTaxAmount The amount of state or provincial [tax included in the total transaction amount](https://docs.adyen.com/payment-methods/cards/enhanced-scheme-data/l2-l3#requirements-to-send-level-2-3-esd), in [minor units](https://docs.adyen.com/development-resources/currency-codes). * For example, 2000 means USD 20.00. * Encoding: Numeric * Max length: 12 characters * Must not be all zeros.
* @param string|null $enhancedSchemeDataTotalTaxAmount The amount of state or provincial [tax included in the total transaction amount](https://docs.adyen.com/payment-methods/cards/enhanced-scheme-data/l2-l3#requirements-to-send-level-2-3-esd), in [minor units](https://docs.adyen.com/development-resources/currency-codes). * For example, 2000 means USD 20.00. * Encoding: Numeric * Max length: 12 characters * For L2 data: must not be all zeroes. * For L3 data: can be zero.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The documentation for enhancedSchemeDataTotalTaxAmount has been clarified to distinguish between L2 and L3 data requirements regarding zero values. This improves the precision of the API's usage guidelines.

*
* @return self
*/
Expand Down
2 changes: 1 addition & 1 deletion src/Adyen/Model/Payments/AdditionalDataSubMerchant.php
Original file line number Diff line number Diff line change
Expand Up @@ -531,7 +531,7 @@ public function getSubMerchantSubSellerSubSellerNrPhoneNumber()
/**
* Sets subMerchantSubSellerSubSellerNrPhoneNumber
*
* @param string|null $subMerchantSubSellerSubSellerNrPhoneNumber Required for transactions performed by registered payment facilitators. The phone number of the sub-merchant.* Format: Alphanumeric * Maximum length: 20 characters
* @param string|null $subMerchantSubSellerSubSellerNrPhoneNumber Required for transactions performed by registered payment facilitators. The phone number of the sub-merchant. * Format: Alphanumeric and special characters * Maximum length: 20 characters
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The format description for subMerchantSubSellerSubSellerNrPhoneNumber now explicitly includes 'special characters'. This adds important detail to the expected input format.

*
* @return self
*/
Expand Down
4 changes: 2 additions & 2 deletions src/Adyen/Model/Payments/Amount.php
Original file line number Diff line number Diff line change
Expand Up @@ -299,7 +299,7 @@ public function getCurrency()
/**
* Sets currency
*
* @param string $currency The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
* @param string $currency The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Adding 'of the amount' to the currency parameter description improves clarity and context for this field.

*
* @return self
*/
Expand All @@ -323,7 +323,7 @@ public function getValue()
/**
* Sets value
*
* @param int $value The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
* @param int $value The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Adding 'numeric value of the' to the value parameter description enhances clarity, specifying that it refers to the numerical representation of the amount.

*
* @return self
*/
Expand Down
4 changes: 3 additions & 1 deletion src/Adyen/Model/Payments/PaymentRequest.php
Original file line number Diff line number Diff line change
Expand Up @@ -534,6 +534,7 @@ public function getModelName()
public const ENTITY_TYPE_COMPANY_NAME = 'CompanyName';
public const FUNDING_SOURCE_CREDIT = 'credit';
public const FUNDING_SOURCE_DEBIT = 'debit';
public const FUNDING_SOURCE_PREPAID = 'prepaid';
public const RECURRING_PROCESSING_MODEL_CARD_ON_FILE = 'CardOnFile';
public const RECURRING_PROCESSING_MODEL_SUBSCRIPTION = 'Subscription';
public const RECURRING_PROCESSING_MODEL_UNSCHEDULED_CARD_ON_FILE = 'UnscheduledCardOnFile';
Expand Down Expand Up @@ -564,6 +565,7 @@ public function getFundingSourceAllowableValues()
return [
self::FUNDING_SOURCE_CREDIT,
self::FUNDING_SOURCE_DEBIT,
self::FUNDING_SOURCE_PREPAID,
];
}
/**
Expand Down Expand Up @@ -1288,7 +1290,7 @@ public function getLocalizedShopperStatement()
/**
* Sets localizedShopperStatement
*
* @param array<string,string>|null $localizedShopperStatement The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set. If not supplied, left empty, or for cross-border transactions, **shopperStatement** is used. Adyen currently supports the ja-Kana and ja-Hani character set for Visa, Mastercard and JCB payments in Japan using Japanese cards. This character set supports: * UTF-8 based Katakana, Kanji, capital letters, numbers and special characters. * Half-width or full-width characters.
* @param array<string,string>|null $localizedShopperStatement The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set. If this parameter is left empty, not provided, or not applicable (in case of cross-border transactions), then **shopperStatement** is used. Currently, `localizedShopperStatement` is only supported for payments with Visa, Mastercard, JCB, Diners, and Discover. **Supported characters**: Hiragana, Katakana, Kanji, and alphanumeric.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The documentation for localizedShopperStatement has been significantly updated to clarify conditions for usage, supported card types (Visa, Mastercard, JCB, Diners, and Discover), and supported character sets. This is a valuable improvement for developers using this field.

*
* @return self
*/
Expand Down
2 changes: 1 addition & 1 deletion src/Adyen/Model/Payments/PaymentRequest3d.php
Original file line number Diff line number Diff line change
Expand Up @@ -1015,7 +1015,7 @@ public function getLocalizedShopperStatement()
/**
* Sets localizedShopperStatement
*
* @param array<string,string>|null $localizedShopperStatement The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set. If not supplied, left empty, or for cross-border transactions, **shopperStatement** is used. Adyen currently supports the ja-Kana and ja-Hani character set for Visa, Mastercard and JCB payments in Japan using Japanese cards. This character set supports: * UTF-8 based Katakana, Kanji, capital letters, numbers and special characters. * Half-width or full-width characters.
* @param array<string,string>|null $localizedShopperStatement The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set. If this parameter is left empty, not provided, or not applicable (in case of cross-border transactions), then **shopperStatement** is used. Currently, `localizedShopperStatement` is only supported for payments with Visa, Mastercard, JCB, Diners, and Discover. **Supported characters**: Hiragana, Katakana, Kanji, and alphanumeric.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Similar to PaymentRequest.php, the localizedShopperStatement documentation has been updated with clearer conditions, supported card types, and character sets. This consistency across related models is beneficial.

*
* @return self
*/
Expand Down
2 changes: 1 addition & 1 deletion src/Adyen/Model/Payments/PaymentRequest3ds2.php
Original file line number Diff line number Diff line change
Expand Up @@ -1015,7 +1015,7 @@ public function getLocalizedShopperStatement()
/**
* Sets localizedShopperStatement
*
* @param array<string,string>|null $localizedShopperStatement The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set. If not supplied, left empty, or for cross-border transactions, **shopperStatement** is used. Adyen currently supports the ja-Kana and ja-Hani character set for Visa, Mastercard and JCB payments in Japan using Japanese cards. This character set supports: * UTF-8 based Katakana, Kanji, capital letters, numbers and special characters. * Half-width or full-width characters.
* @param array<string,string>|null $localizedShopperStatement The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set. If this parameter is left empty, not provided, or not applicable (in case of cross-border transactions), then **shopperStatement** is used. Currently, `localizedShopperStatement` is only supported for payments with Visa, Mastercard, JCB, Diners, and Discover. **Supported characters**: Hiragana, Katakana, Kanji, and alphanumeric.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The localizedShopperStatement documentation update here mirrors the changes in PaymentRequest.php and PaymentRequest3d.php, providing consistent and improved clarity for this field across different payment request types.

*
* @return self
*/
Expand Down
6 changes: 5 additions & 1 deletion src/Adyen/Model/Payments/Recurring.php
Original file line number Diff line number Diff line change
Expand Up @@ -237,8 +237,10 @@ public function getModelName()
}

public const CONTRACT_ONECLICK = 'ONECLICK';
public const CONTRACT_ONECLICKRECURRING = 'ONECLICK,RECURRING';
public const CONTRACT_RECURRING = 'RECURRING';
public const CONTRACT_PAYOUT = 'PAYOUT';
public const CONTRACT_EXTERNAL = 'EXTERNAL';
public const TOKEN_SERVICE_VISATOKENSERVICE = 'VISATOKENSERVICE';
public const TOKEN_SERVICE_MCTOKENSERVICE = 'MCTOKENSERVICE';
public const TOKEN_SERVICE_AMEXTOKENSERVICE = 'AMEXTOKENSERVICE';
Expand All @@ -253,8 +255,10 @@ public function getContractAllowableValues()
{
return [
self::CONTRACT_ONECLICK,
self::CONTRACT_ONECLICKRECURRING,
self::CONTRACT_RECURRING,
self::CONTRACT_PAYOUT,
self::CONTRACT_EXTERNAL,
];
}
/**
Expand Down Expand Up @@ -366,7 +370,7 @@ public function getContract()
/**
* Sets contract
*
* @param string|null $contract The type of recurring contract to be used. Possible values: * `ONECLICK` – Payment details can be used to initiate a one-click payment, where the shopper enters the [card security code (CVC/CVV)](https://docs.adyen.com/payments-fundamentals/payment-glossary#card-security-code-cvc-cvv-cid). * `RECURRING` – Payment details can be used without the card security code to initiate [card-not-present transactions](https://docs.adyen.com/payments-fundamentals/payment-glossary#card-not-present-cnp). * `ONECLICK,RECURRING` – Payment details can be used regardless of whether the shopper is on your site or not. * `PAYOUT` – Payment details can be used to [make a payout](https://docs.adyen.com/online-payments/online-payouts).
* @param string|null $contract The type of recurring contract to be used. Possible values: * `ONECLICK` – Payment details can be used to initiate a one-click payment, where the shopper enters the [card security code (CVC/CVV)](https://docs.adyen.com/payments-fundamentals/payment-glossary#card-security-code-cvc-cvv-cid). * `RECURRING` – Payment details can be used without the card security code to initiate [card-not-present transactions](https://docs.adyen.com/payments-fundamentals/payment-glossary#card-not-present-cnp). * `ONECLICK,RECURRING` – Payment details can be used regardless of whether the shopper is on your site or not. * `PAYOUT` – Payment details can be used to [make a payout](https://docs.adyen.com/online-payments/online-payouts). * `EXTERNAL` - Use this when you store payment details and send the raw card number or network token directly in your API request.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The documentation for the contract parameter has been updated to include the new EXTERNAL value, along with its specific use case. This is crucial for understanding the expanded functionality.

*
* @return self
*/
Expand Down
31 changes: 31 additions & 0 deletions src/Adyen/Model/Payments/ResponseAdditionalDataSepa.php
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ class ResponseAdditionalDataSepa implements ModelInterface, ArrayAccess, \JsonSe
protected static $openAPITypes = [
'sepadirectdebitDateOfSignature' => 'string',
'sepadirectdebitMandateId' => 'string',
'sepadirectdebitSepadirectdebitDueDate' => 'string',
'sepadirectdebitSequenceType' => 'string'
];

Expand All @@ -56,6 +57,7 @@ class ResponseAdditionalDataSepa implements ModelInterface, ArrayAccess, \JsonSe
protected static $openAPIFormats = [
'sepadirectdebitDateOfSignature' => null,
'sepadirectdebitMandateId' => null,
'sepadirectdebitSepadirectdebitDueDate' => null,
'sepadirectdebitSequenceType' => null
];

Expand All @@ -67,6 +69,7 @@ class ResponseAdditionalDataSepa implements ModelInterface, ArrayAccess, \JsonSe
protected static $openAPINullables = [
'sepadirectdebitDateOfSignature' => false,
'sepadirectdebitMandateId' => false,
'sepadirectdebitSepadirectdebitDueDate' => false,
'sepadirectdebitSequenceType' => false
];

Expand Down Expand Up @@ -158,6 +161,7 @@ public function isNullableSetToNull(string $property): bool
protected static $attributeMap = [
'sepadirectdebitDateOfSignature' => 'sepadirectdebit.dateOfSignature',
'sepadirectdebitMandateId' => 'sepadirectdebit.mandateId',
'sepadirectdebitSepadirectdebitDueDate' => 'sepadirectdebit.sepadirectdebit.dueDate',
'sepadirectdebitSequenceType' => 'sepadirectdebit.sequenceType'
];

Expand All @@ -169,6 +173,7 @@ public function isNullableSetToNull(string $property): bool
protected static $setters = [
'sepadirectdebitDateOfSignature' => 'setSepadirectdebitDateOfSignature',
'sepadirectdebitMandateId' => 'setSepadirectdebitMandateId',
'sepadirectdebitSepadirectdebitDueDate' => 'setSepadirectdebitSepadirectdebitDueDate',
'sepadirectdebitSequenceType' => 'setSepadirectdebitSequenceType'
];

Expand All @@ -180,6 +185,7 @@ public function isNullableSetToNull(string $property): bool
protected static $getters = [
'sepadirectdebitDateOfSignature' => 'getSepadirectdebitDateOfSignature',
'sepadirectdebitMandateId' => 'getSepadirectdebitMandateId',
'sepadirectdebitSepadirectdebitDueDate' => 'getSepadirectdebitSepadirectdebitDueDate',
'sepadirectdebitSequenceType' => 'getSepadirectdebitSequenceType'
];

Expand Down Expand Up @@ -242,6 +248,7 @@ public function __construct(?array $data = null)
{
$this->setIfExists('sepadirectdebitDateOfSignature', $data ?? [], null);
$this->setIfExists('sepadirectdebitMandateId', $data ?? [], null);
$this->setIfExists('sepadirectdebitSepadirectdebitDueDate', $data ?? [], null);
$this->setIfExists('sepadirectdebitSequenceType', $data ?? [], null);
}

Expand Down Expand Up @@ -335,6 +342,30 @@ public function setSepadirectdebitMandateId($sepadirectdebitMandateId)
return $this;
}

/**
* Gets sepadirectdebitSepadirectdebitDueDate
*
* @return string|null
*/
public function getSepadirectdebitSepadirectdebitDueDate()
{
return $this->container['sepadirectdebitSepadirectdebitDueDate'];
}

/**
* Sets sepadirectdebitSepadirectdebitDueDate
*
* @param string|null $sepadirectdebitSepadirectdebitDueDate The date that the the shopper's bank account is charged.
*
* @return self
*/
public function setSepadirectdebitSepadirectdebitDueDate($sepadirectdebitSepadirectdebitDueDate)
{
$this->container['sepadirectdebitSepadirectdebitDueDate'] = $sepadirectdebitSepadirectdebitDueDate;

return $this;
}

/**
* Gets sepadirectdebitSequenceType
*
Expand Down
Loading