Checkout mutation updates

[kidunot89]

Your checklist for this pull request

Thanks for sending a pull request! Please make sure you click the link above to view the contribution guidelines, then fill out the blanks below.

🚨Please review the guidelines for contributing to this repository.

• Make sure you are making a pull request against the develop branch (left side). Also you should start your branch off our develop.
• Make sure you are requesting to pull request from a topic/feature/bugfix branch (right side). Don't pull request from your master!

What does this implement/fix? Explain your changes.

• Adds isPaid and transactionId fields added to CheckoutInput.
• paymentMethodTitle field removed from CheckoutInput.
• A transactionId is required for the prepaid order to be set to completed status.
  • This behavior can be alter by using the graphql_checkout_prepaid_order_validation filter.

/**
* Use this to do some last minute transaction ID validation.
*
* @param bool        $is_valid        Is transaction ID valid.
* @param WC_Order    $order           Order being processed.
* @param String|null $transaction_id  Order payment transaction ID.
* @param array       $data            Order data.
* @param array       $input           Order raw input data.
* @param AppContext  $context         Request's AppContext instance.
* @param ResolveInfo $info            Request's ResolveInfo instance.
*/
$valid = apply_filters(
   'graphql_checkout_prepaid_order_validation',
   ! empty( $input['transactionId'] ),
   $order,
   $transaction_id,
   $data,
   $input,
   $context,
   $info
);

Example checkout mutation

mutation checkout( $input: CheckoutInput! ) {
    checkout( input: $input ) {
        clientMutationId
        order {
           ...orderFields
        }
        customer {
           ...customerFields
        }
    }
}

new CheckoutInput definition

'clientMutationId' => array(
	'type'        => array( 'non_null' => 'String' ),
	'description' => __( 'Unique ID for mutation', 'wp-graphql-woocommerce' ),
),
'paymentMethod'          => array(
	'type'        => 'String',
	'description' => __( 'Payment method ID.', 'wp-graphql-woocommerce' ),
),
'shippingMethod'         => array(
	'type'        => 'String',
	'description' => __( 'Order shipping method', 'wp-graphql-woocommerce' ),
),
'shipToDifferentAddress' => array(
	'type'        => 'Boolean',
	'description' => __( 'Ship to a separate address', 'wp-graphql-woocommerce' ),
),
'billing'                => array(
	'type'        => 'CustomerAddressInput',
	'description' => __( 'Order billing address', 'wp-graphql-woocommerce' ),
),
'shipping'               => array(
	'type'        => 'CustomerAddressInput',
	'description' => __( 'Order shipping address', 'wp-graphql-woocommerce' ),
),
'account'                => array(
	'type'        => 'CreateAccountInput',
	'description' => __( 'Create new customer account', 'wp-graphql-woocommerce' ),
),
'transactionId'          => array(
	'type'        => 'String',
	'description' => __( 'Order transaction ID', 'wp-graphql-woocommerce' ),
),
'isPaid'                 => array(
	'type'        => 'Boolean',
	'description' => __( 'Define if the order is paid. It will set the status to processing and reduce stock items.', 'wp-graphql-woocommerce' ),
),
'metaData'               => array(
	'type'        => array( 'list_of' => 'MetaDataInput' ),
	'description' => __( 'Order meta data', 'wp-graphql-woocommerce' ),
),

Does this close any currently open issues?

#226

Any relevant logs, error output, GraphiQL screenshots, etc?

(If it’s long, please paste to https://ghostbin.com/ and insert the link here.)

Any other comments?

…

Where has this been tested?

Operating System: Linux Mint 19.2

WordPress Version: 5.3.2