<?php

[0] Fix | Delete

[1] Fix | Delete

namespace WPForms\Integrations\Square\Api;

[2] Fix | Delete

[3] Fix | Delete

use stdClass;

[4] Fix | Delete

use WPForms\Integrations\Square\Helpers;

[5] Fix | Delete

use WPForms\Vendor\Square\Models\Invoice;

[6] Fix | Delete

use WPForms\Vendor\Square\Exceptions\ApiException;

[7] Fix | Delete

use WPForms\Vendor\Square\Http\ApiResponse;

[8] Fix | Delete

use WPForms\Vendor\Square\Models\Address;

[9] Fix | Delete

use WPForms\Vendor\Square\Models\Card;

[10] Fix | Delete

use WPForms\Vendor\Square\Models\CatalogObject;

[11] Fix | Delete

use WPForms\Vendor\Square\Models\CatalogObjectType;

[12] Fix | Delete

use WPForms\Vendor\Square\Models\CatalogQuery;

[13] Fix | Delete

use WPForms\Vendor\Square\Models\CatalogQueryExact;

[14] Fix | Delete

use WPForms\Vendor\Square\Models\CatalogSubscriptionPlan;

[15] Fix | Delete

use WPForms\Vendor\Square\Models\UpdateSubscriptionResponse;

[16] Fix | Delete

use WPForms\Vendor\Square\Models\CatalogSubscriptionPlanVariation;

[17] Fix | Delete

use WPForms\Vendor\Square\Models\CreateCardRequest;

[18] Fix | Delete

use WPForms\Vendor\Square\Models\CreateCustomerRequest;

[19] Fix | Delete

use WPForms\Vendor\Square\Models\CreateOrderRequest;

[20] Fix | Delete

use WPForms\Vendor\Square\Models\CreatePaymentRequest;

[21] Fix | Delete

use WPForms\Vendor\Square\Models\CreatePaymentResponse;

[22] Fix | Delete

use WPForms\Vendor\Square\Models\CreateSubscriptionRequest;

[23] Fix | Delete

use WPForms\Vendor\Square\Models\CreateSubscriptionResponse;

[24] Fix | Delete

use WPForms\Vendor\Square\Models\Money;

[25] Fix | Delete

use WPForms\Vendor\Square\Models\Order;

[26] Fix | Delete

use WPForms\Vendor\Square\Models\OrderLineItem;

[27] Fix | Delete

use WPForms\Vendor\Square\Models\OrderLineItemDiscount;

[28] Fix | Delete

use WPForms\Vendor\Square\Models\OrderSource;

[29] Fix | Delete

use WPForms\Vendor\Square\Models\OrderState;

[30] Fix | Delete

use WPForms\Vendor\Square\Models\Payment;

[31] Fix | Delete

use WPForms\Vendor\Square\Models\RefundPaymentRequest;

[32] Fix | Delete

use WPForms\Vendor\Square\Models\SearchCatalogObjectsRequest;

[33] Fix | Delete

use WPForms\Vendor\Square\Models\Subscription;

[34] Fix | Delete

use WPForms\Vendor\Square\Models\SubscriptionPhase;

[35] Fix | Delete

use WPForms\Vendor\Square\Models\SubscriptionPricing;

[36] Fix | Delete

use WPForms\Vendor\Square\Models\SubscriptionSource;

[37] Fix | Delete

use WPForms\Vendor\Square\Models\UpdateOrderRequest;

[38] Fix | Delete

use WPForms\Vendor\Square\Models\UpdateSubscriptionRequest;

[39] Fix | Delete

use WPForms\Vendor\Square\Models\UpsertCatalogObjectRequest;

[40] Fix | Delete

use WPForms\Vendor\Square\Models\Customer;

[41] Fix | Delete

use WPForms\Vendor\Square\SquareClient;

[42] Fix | Delete

use WPForms\Integrations\Square\Connection;

[43] Fix | Delete

use WPForms\Integrations\Square\Square;

[44] Fix | Delete

[45] Fix | Delete

/**

[46] Fix | Delete

* WPForms Square API class.

[47] Fix | Delete

*

[48] Fix | Delete

* @since 1.9.5

[49] Fix | Delete

*/

[50] Fix | Delete

class Api {

[51] Fix | Delete

[52] Fix | Delete

/**

[53] Fix | Delete

* Square API client instance.

[54] Fix | Delete

*

[55] Fix | Delete

* @since 1.9.5

[56] Fix | Delete

*

[57] Fix | Delete

* @var SquareClient

[58] Fix | Delete

*/

[59] Fix | Delete

private $client;

[60] Fix | Delete

[61] Fix | Delete

/**

[62] Fix | Delete

* Payment token (card nonce) generated by the Web Payments SDK.

[63] Fix | Delete

*

[64] Fix | Delete

* @since 1.9.5

[65] Fix | Delete

*

[66] Fix | Delete

* @var string

[67] Fix | Delete

*/

[68] Fix | Delete

private $source_id;

[69] Fix | Delete

[70] Fix | Delete

/**

[71] Fix | Delete

* Last API call response.

[72] Fix | Delete

*

[73] Fix | Delete

* @since 1.9.5

[74] Fix | Delete

*

[75] Fix | Delete

* @var ApiResponse

[76] Fix | Delete

*/

[77] Fix | Delete

private $response;

[78] Fix | Delete

[79] Fix | Delete

/**

[80] Fix | Delete

* Last API call exception.

[81] Fix | Delete

*

[82] Fix | Delete

* @since 1.9.5

[83] Fix | Delete

*

[84] Fix | Delete

* @var ApiException

[85] Fix | Delete

*/

[86] Fix | Delete

private $exception;

[87] Fix | Delete

[88] Fix | Delete

/**

[89] Fix | Delete

* API errors.

[90] Fix | Delete

*

[91] Fix | Delete

* @since 1.9.5

[92] Fix | Delete

*

[93] Fix | Delete

* @var array

[94] Fix | Delete

*/

[95] Fix | Delete

private $errors;

[96] Fix | Delete

[97] Fix | Delete

/**

[98] Fix | Delete

* Constructs the main Square API wrapper class.

[99] Fix | Delete

*

[100] Fix | Delete

* @since 1.9.5

[101] Fix | Delete

*

[102] Fix | Delete

* @param Connection $connection Connection object.

[103] Fix | Delete

*/

[104] Fix | Delete

public function __construct( $connection ) {

[105] Fix | Delete

[106] Fix | Delete

$this->client = new SquareClient(

[107] Fix | Delete

[

[108] Fix | Delete

'accessToken' => $connection->get_access_token(),

[109] Fix | Delete

'environment' => $connection->get_mode(),

[110] Fix | Delete

]

[111] Fix | Delete

);

[112] Fix | Delete

}

[113] Fix | Delete

[114] Fix | Delete

/**

[115] Fix | Delete

* Set tokens from a submitted form data.

[116] Fix | Delete

*

[117] Fix | Delete

* @since 1.9.5

[118] Fix | Delete

*

[119] Fix | Delete

* @param array $entry Copy of original $_POST.

[120] Fix | Delete

*/

[121] Fix | Delete

public function set_payment_tokens( array $entry ) {

[122] Fix | Delete

[123] Fix | Delete

if ( ! empty( $entry['square']['source_id'] ) ) {

[124] Fix | Delete

$this->source_id = $entry['square']['source_id'];

[125] Fix | Delete

}

[126] Fix | Delete

}

[127] Fix | Delete

[128] Fix | Delete

/**

[129] Fix | Delete

* Check if OAuth connection is present and ready to use.

[130] Fix | Delete

*

[131] Fix | Delete

* @since 1.9.5

[132] Fix | Delete

*/

[133] Fix | Delete

private function check_connection() {

[134] Fix | Delete

[135] Fix | Delete

$connection = Connection::get();

[136] Fix | Delete

[137] Fix | Delete

if ( ! $connection || ! $connection->is_configured() ) {

[138] Fix | Delete

$this->errors[] = esc_html__( 'Square account connection is missing.', 'wpforms-lite' );

[139] Fix | Delete

[140] Fix | Delete

return;

[141] Fix | Delete

}

[142] Fix | Delete

[143] Fix | Delete

if ( ! $connection->is_valid() ) {

[144] Fix | Delete

$this->errors[] = esc_html__( 'Square account connection is invalid.', 'wpforms-lite' );

[145] Fix | Delete

[146] Fix | Delete

return;

[147] Fix | Delete

}

[148] Fix | Delete

[149] Fix | Delete

if ( ! $connection->is_currency_matched() ) {

[150] Fix | Delete

$this->errors[] = esc_html__( 'The currency associated with the payment is not valid for the provided business location.', 'wpforms-lite' );

[151] Fix | Delete

}

[152] Fix | Delete

}

[153] Fix | Delete

[154] Fix | Delete

/**

[155] Fix | Delete

* Check if single payment tokens are present.

[156] Fix | Delete

*

[157] Fix | Delete

* @since 1.9.5

[158] Fix | Delete

*/

[159] Fix | Delete

private function check_payment_tokens() {

[160] Fix | Delete

[161] Fix | Delete

if ( empty( $this->source_id ) ) {

[162] Fix | Delete

$this->errors[] = esc_html__( 'Square payment stopped, missing card tokens.', 'wpforms-lite' );

[163] Fix | Delete

}

[164] Fix | Delete

}

[165] Fix | Delete

[166] Fix | Delete

/**

[167] Fix | Delete

* Check if all required general arguments are present.

[168] Fix | Delete

*

[169] Fix | Delete

* @since 1.9.5

[170] Fix | Delete

*

[171] Fix | Delete

* @param array $args Arguments to check.

[172] Fix | Delete

*/

[173] Fix | Delete

private function check_required_args_general( array $args ) {

[174] Fix | Delete

[175] Fix | Delete

if ( empty( $args['location_id'] ) ) {

[176] Fix | Delete

$this->errors[] = esc_html__( 'Missing location ID.', 'wpforms-lite' );

[177] Fix | Delete

}

[178] Fix | Delete

[179] Fix | Delete

if ( empty( $args['currency'] ) ) {

[180] Fix | Delete

$this->errors[] = esc_html__( 'Missing currency.', 'wpforms-lite' );

[181] Fix | Delete

}

[182] Fix | Delete

[183] Fix | Delete

if ( empty( $args['amount'] ) && ! is_numeric( $args['amount'] ) ) {

[184] Fix | Delete

$this->errors[] = esc_html__( 'Missing amount.', 'wpforms-lite' );

[185] Fix | Delete

}

[186] Fix | Delete

}

[187] Fix | Delete

[188] Fix | Delete

/**

[189] Fix | Delete

* Check if all required single payment arguments are present.

[190] Fix | Delete

*

[191] Fix | Delete

* @since 1.9.5

[192] Fix | Delete

*

[193] Fix | Delete

* @param array $args Arguments to check.

[194] Fix | Delete

*/

[195] Fix | Delete

private function check_required_args_single( array $args ) {

[196] Fix | Delete

[197] Fix | Delete

if ( empty( $args['order_items'] ) ) {

[198] Fix | Delete

$this->errors[] = esc_html__( 'Missing order/payment items.', 'wpforms-lite' );

[199] Fix | Delete

}

[200] Fix | Delete

}

[201] Fix | Delete

[202] Fix | Delete

/**

[203] Fix | Delete

* Process single transaction.

[204] Fix | Delete

*

[205] Fix | Delete

* @since 1.9.5

[206] Fix | Delete

*

[207] Fix | Delete

* @param array $args Payment arguments.

[208] Fix | Delete

*/

[209] Fix | Delete

public function process_single_transaction( array $args ) {

[210] Fix | Delete

[211] Fix | Delete

$this->check_connection();

[212] Fix | Delete

$this->check_payment_tokens();

[213] Fix | Delete

$this->check_required_args_general( $args );

[214] Fix | Delete

$this->check_required_args_single( $args );

[215] Fix | Delete

[216] Fix | Delete

if ( $this->errors ) {

[217] Fix | Delete

return;

[218] Fix | Delete

}

[219] Fix | Delete

[220] Fix | Delete

$result = $this->perform_single_transaction( $args );

[221] Fix | Delete

[222] Fix | Delete

/**

[223] Fix | Delete

* Fire when a single transaction is performed.

[224] Fix | Delete

*

[225] Fix | Delete

* @since 1.9.5

[226] Fix | Delete

*

[227] Fix | Delete

* @param array $result Single transaction result.

[228] Fix | Delete

* @param array $args Payment arguments.

[229] Fix | Delete

* @param Api $api Api class instance.

[230] Fix | Delete

*/

[231] Fix | Delete

do_action( 'wpforms_square_api_process_single_transaction_after', $result, $args, $this ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName

[232] Fix | Delete

}

[233] Fix | Delete

[234] Fix | Delete

/**

[235] Fix | Delete

* Process subscription transaction.

[236] Fix | Delete

*

[237] Fix | Delete

* @since 1.9.5

[238] Fix | Delete

*

[239] Fix | Delete

* @param array $args Payment arguments.

[240] Fix | Delete

*/

[241] Fix | Delete

public function process_subscription_transaction( array $args ) {

[242] Fix | Delete

[243] Fix | Delete

$this->check_connection();

[244] Fix | Delete

$this->check_payment_tokens();

[245] Fix | Delete

$this->check_required_args_general( $args );

[246] Fix | Delete

$this->check_required_args_subscription( $args );

[247] Fix | Delete

[248] Fix | Delete

if ( $this->errors ) {

[249] Fix | Delete

return;

[250] Fix | Delete

}

[251] Fix | Delete

[252] Fix | Delete

$this->perform_subscription_transaction( $args );

[253] Fix | Delete

}

[254] Fix | Delete

[255] Fix | Delete

/**

[256] Fix | Delete

* Refund payment.

[257] Fix | Delete

*

[258] Fix | Delete

* @since 1.9.5

[259] Fix | Delete

*

[260] Fix | Delete

* @param string $payment_id Payment ID.

[261] Fix | Delete

* @param array $args Payment data.

[262] Fix | Delete

*/

[263] Fix | Delete

public function refund_payment( string $payment_id, array $args ): bool {

[264] Fix | Delete

[265] Fix | Delete

try {

[266] Fix | Delete

$request = new RefundPaymentRequest( $this->get_idempotency_key(), new Money() );

[267] Fix | Delete

[268] Fix | Delete

$request->setPaymentId( $payment_id );

[269] Fix | Delete

$request->setReason( $args['reason'] );

[270] Fix | Delete

$request->getAmountMoney()->setAmount( $args['amount'] );

[271] Fix | Delete

$request->getAmountMoney()->setCurrency( $args['currency'] );

[272] Fix | Delete

[273] Fix | Delete

$this->response = $this->client->getRefundsApi()->refundPayment( $request );

[274] Fix | Delete

[275] Fix | Delete

if ( ! $this->response->isSuccess() ) {

[276] Fix | Delete

return false;

[277] Fix | Delete

}

[278] Fix | Delete

} catch ( ApiException $e ) {

[279] Fix | Delete

$this->exception = $e;

[280] Fix | Delete

[281] Fix | Delete

return false;

[282] Fix | Delete

}

[283] Fix | Delete

[284] Fix | Delete

return true;

[285] Fix | Delete

}

[286] Fix | Delete

[287] Fix | Delete

/**

[288] Fix | Delete

* Update subscription.

[289] Fix | Delete

*

[290] Fix | Delete

* @since 1.9.5

[291] Fix | Delete

*

[292] Fix | Delete

* @param array $args Subscription arguments.

[293] Fix | Delete

*/

[294] Fix | Delete

public function update_subscription( array $args ) {

[295] Fix | Delete

[296] Fix | Delete

$subscription = $this->retrieve_subscription( $args['id'] );

[297] Fix | Delete

[298] Fix | Delete

if ( ! $subscription instanceof Subscription ) {

[299] Fix | Delete

return;

[300] Fix | Delete

}

[301] Fix | Delete

[302] Fix | Delete

$request = $this->get_update_subscription_request_object( $subscription, $args );

[303] Fix | Delete

[304] Fix | Delete

$this->send_update_subscription_request( $args['id'], $request );

[305] Fix | Delete

}

[306] Fix | Delete

[307] Fix | Delete

/**

[308] Fix | Delete

* Cancel subscription.

[309] Fix | Delete

*

[310] Fix | Delete

* @since 1.9.5

[311] Fix | Delete

*

[312] Fix | Delete

* @param string $subscription_id Subscription id.

[313] Fix | Delete

*

[314] Fix | Delete

* @return bool

[315] Fix | Delete

*/

[316] Fix | Delete

public function cancel_subscription( string $subscription_id ): bool {

[317] Fix | Delete

[318] Fix | Delete

try {

[319] Fix | Delete

$this->response = $this->client->getSubscriptionsApi()->cancelSubscription( $subscription_id );

[320] Fix | Delete

[321] Fix | Delete

if ( ! $this->response->isSuccess() ) {

[322] Fix | Delete

return false;

[323] Fix | Delete

}

[324] Fix | Delete

} catch ( ApiException $e ) {

[325] Fix | Delete

$this->exception = $e;

[326] Fix | Delete

[327] Fix | Delete

return false;

[328] Fix | Delete

}

[329] Fix | Delete

[330] Fix | Delete

return true;

[331] Fix | Delete

}

[332] Fix | Delete

[333] Fix | Delete

/**

[334] Fix | Delete

* Retrieve a Card object.

[335] Fix | Delete

*

[336] Fix | Delete

* @since 1.9.5

[337] Fix | Delete

*

[338] Fix | Delete

* @param Subscription $subscription Subscription object.

[339] Fix | Delete

*

[340] Fix | Delete

* @return Card|null

[341] Fix | Delete

*/

[342] Fix | Delete

public function get_subscription_card( $subscription ) {

[343] Fix | Delete

[344] Fix | Delete

if ( ! $subscription instanceof Subscription ) {

[345] Fix | Delete

return null;

[346] Fix | Delete

}

[347] Fix | Delete

[348] Fix | Delete

$card_id = $subscription->getCardId();

[349] Fix | Delete

[350] Fix | Delete

if ( empty( $card_id ) ) {

[351] Fix | Delete

return null;

[352] Fix | Delete

}

[353] Fix | Delete

[354] Fix | Delete

// Get a customer.

[355] Fix | Delete

$card = $this->send_retrieve_card_request( $card_id );

[356] Fix | Delete

[357] Fix | Delete

if ( ! $card instanceof Card ) {

[358] Fix | Delete

return null;

[359] Fix | Delete

}

[360] Fix | Delete

[361] Fix | Delete

return $card;

[362] Fix | Delete

}

[363] Fix | Delete

[364] Fix | Delete

/**

[365] Fix | Delete

* Send a retrieve subscription request to API.

[366] Fix | Delete

*

[367] Fix | Delete

* @since 1.9.5

[368] Fix | Delete

*

[369] Fix | Delete

* @param string $id The ID of the subscription to retrieve.

[370] Fix | Delete

*

[371] Fix | Delete

* @return Subscription|null

[372] Fix | Delete

*/

[373] Fix | Delete

public function retrieve_subscription( string $id ) {

[374] Fix | Delete

[375] Fix | Delete

try {

[376] Fix | Delete

$response = $this->client->getSubscriptionsApi()->retrieveSubscription( $id );

[377] Fix | Delete

[378] Fix | Delete

if ( ! $response->isSuccess() ) {

[379] Fix | Delete

return null;

[380] Fix | Delete

}

[381] Fix | Delete

[382] Fix | Delete

return $response->getResult()->getSubscription();

[383] Fix | Delete

[384] Fix | Delete

} catch ( ApiException $e ) {

[385] Fix | Delete

return null;

[386] Fix | Delete

}

[387] Fix | Delete

}

[388] Fix | Delete

[389] Fix | Delete

/**

[390] Fix | Delete

* Retrieve a Card object.

[391] Fix | Delete

*

[392] Fix | Delete

* @since 1.9.5

[393] Fix | Delete

*

[394] Fix | Delete

* @param Subscription $subscription Subscription object.

[395] Fix | Delete

*

[396] Fix | Delete

* @return Invoice|null

[397] Fix | Delete

*/

[398] Fix | Delete

public function get_latest_subscription_invoice( $subscription ) {

[399] Fix | Delete

[400] Fix | Delete

if ( ! $subscription instanceof Subscription ) {

[401] Fix | Delete

return null;

[402] Fix | Delete

}

[403] Fix | Delete

[404] Fix | Delete

try {

[405] Fix | Delete

$invoices = $subscription->getInvoiceIds();

[406] Fix | Delete

[407] Fix | Delete

if ( empty( $invoices ) ) {

[408] Fix | Delete

return null;

[409] Fix | Delete

}

[410] Fix | Delete

[411] Fix | Delete

// Get a customer.

[412] Fix | Delete

$response = $this->client->getInvoicesApi()->getInvoice( reset( $invoices ) ); // Get the latest invoice by using the first ID in the array as the subscription's invoice IDs are sorted by date in ascending order.

[413] Fix | Delete

[414] Fix | Delete

if ( ! $response->isSuccess() ) {

[415] Fix | Delete

return null;

[416] Fix | Delete

}

[417] Fix | Delete

[418] Fix | Delete

return $response->getResult()->getInvoice();

[419] Fix | Delete

} catch ( ApiException $e ) {

[420] Fix | Delete

return null;

[421] Fix | Delete

}

[422] Fix | Delete

}

[423] Fix | Delete

[424] Fix | Delete

/**

[425] Fix | Delete

* Perform a single transaction.

[426] Fix | Delete

*

[427] Fix | Delete

* @since 1.9.5

[428] Fix | Delete

*

[429] Fix | Delete

* @param array $args Payment arguments.

[430] Fix | Delete

*

[431] Fix | Delete

* @return array

[432] Fix | Delete

*/

[433] Fix | Delete

private function perform_single_transaction( array $args ): array {

[434] Fix | Delete

[435] Fix | Delete

$result = [];

[436] Fix | Delete

[437] Fix | Delete

// Create an order.

[438] Fix | Delete

$order_request = $this->prepare_create_order_request( $args );

[439] Fix | Delete

$order = $this->send_create_order_request( $order_request );

[440] Fix | Delete

[441] Fix | Delete

if ( ! $order instanceof Order ) {

[442] Fix | Delete

return $result;

[443] Fix | Delete

}

[444] Fix | Delete

[445] Fix | Delete

$result['order'] = $order;

[446] Fix | Delete

[447] Fix | Delete

// Create a payment.

[448] Fix | Delete

$payment_request = $this->prepare_create_payment_request( $order, $args );

[449] Fix | Delete

$payment = $this->send_create_payment_request( $payment_request );

[450] Fix | Delete

[451] Fix | Delete

// In this case we should cancel an order.

[452] Fix | Delete

if ( ! $payment instanceof Payment ) {

[453] Fix | Delete

$update_order_request = $this->prepare_update_order_request( $order );

[454] Fix | Delete

$updated_order = $this->send_update_order_request( $order->getId(), $update_order_request );

[455] Fix | Delete

[456] Fix | Delete

return $updated_order instanceof Order ? [ 'order' => $updated_order ] : $result;

[457] Fix | Delete

}

[458] Fix | Delete

[459] Fix | Delete

$result['payment'] = $payment;

[460] Fix | Delete

[461] Fix | Delete

return $result;

[462] Fix | Delete

}

[463] Fix | Delete

[464] Fix | Delete

/**

[465] Fix | Delete

* Prepare a create order request object for sending to API.

[466] Fix | Delete

*

[467] Fix | Delete

* @since 1.9.5

[468] Fix | Delete

*

[469] Fix | Delete

* @param array $args Single payment arguments.

[470] Fix | Delete

*

[471] Fix | Delete

* @return CreateOrderRequest

[472] Fix | Delete

*/

[473] Fix | Delete

private function prepare_create_order_request( array $args ): CreateOrderRequest {

[474] Fix | Delete

[475] Fix | Delete

$request = $this->get_create_order_request_object( $args );

[476] Fix | Delete

$request = $this->create_order_request_set_line_items( $request, $args );

[477] Fix | Delete

$request = $this->create_order_request_set_discounts( $request, $args );

[478] Fix | Delete

[479] Fix | Delete

/**

[480] Fix | Delete

* Filter a create order request object.

[481] Fix | Delete

*

[482] Fix | Delete

* @since 1.9.5

[483] Fix | Delete

*

[484] Fix | Delete

* @param CreateOrderRequest $request Create order request object.

[485] Fix | Delete

* @param array $args Payment arguments.

[486] Fix | Delete

* @param Api $api Api class instance.

[487] Fix | Delete

*/

[488] Fix | Delete

return apply_filters( 'wpforms_square_api_prepare_create_order_request', $request, $args, $this ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName

[489] Fix | Delete

}

[490] Fix | Delete

[491] Fix | Delete

/**

[492] Fix | Delete

* Prepare an update order request object for sending to API.

[493] Fix | Delete

*

[494] Fix | Delete

* @since 1.9.5

[495] Fix | Delete

*

[496] Fix | Delete

* @param Order $order Order object.

[497] Fix | Delete

*

[498] Fix | Delete

* @return UpdateOrderRequest

[499] Fix | Delete