Migrating REST API Transactions to GraphQL

GraphQL Admin API Troubleshooting
1

We’re in the process of migrating from the REST API to GraphQL and have encountered a challenge with a specific use case.

Currently, we use the REST API endpoint POST /orders/{order_id}/transactions to create transactions for orders, setting the source parameter to external. This approach allows us to apply manual payments for net terms orders received through an external system.

In our GraphQL migration efforts, we explored the orderMarkAsPaid mutation but found it unsuitable, as it marks orders as fully paid, whereas our orders often involve partial payments.

Is there a GraphQL mutation or recommended approach to record partial payments on orders, similar to the functionality provided by the REST API’s transaction creation with an external source?

Any guidance or suggestions would be greatly appreciated.

2

Hi Colby,

Have you tried using the orderCapture mutation? This allows you to capture a partial payment by specifying an amount less than the total order amount.

3

Hi Liam,

Thanks for the reply. We were looking at that, but didn’t see a method to do so without a reference to an authorization. Perhaps we overlooked this.

How would you perform a partial capture, let’s say $10, for a cash or other manual payment method?

Thanks!

4

Hi Colby,

I do see what you mean - it doesn’t seem like the GraphQL Admin API currently supports creating a partial payment when there is no authorized transaction to capture. I’ve reached out to the product team to get their input on this, will update here when I lean more.

5

Hi again Colby - our product team have confirmed that the GraphQL Admin API currently does not support creating partial payments with cash/manual payment methods. I’ll connect with you via DM to collect additional details from you to help us explore how best to approach this.

6

We are also hitting this limitation with transitioning to GraphQL API. We also create new transactions on orders to sync up with other systems but for now it seems we are stuck with the rest API.

7

Hi Tommy,

There’s unfortunately nothing to share on this right now, but I’ve added your feedback/ usecase on this so our product teams understand why this is a blocker to your migration to GraphQL.

8

@Tommy_Gaudreau , @Liam-Shopify - I saw this posted on the developer changelog recently. It seems very relevant, although I’ve yet to try it for our needs:

Record partial payments on Orders
As of 2025-04 partial payments can be recorded on orders using the new orderCreateManualPayment mutation. This allows the recording of multiple separate payments, up to the total amount owing on the order.

1 Like