Creating an Order in different currency to shop currency

Rich44
Shopify Partner
7 0 0

I can see the Admin Orders API accepts `currency` as an option, allowing us to create orders in a currency different to the shop currency.

e.g. in a UK (GBP) Store we can create an order via the Admin API with the currency set to USD. This results in both the shop_money and presentment_money set to USD:

```

"total_price_set": {
    "shop_money": {
        "amount": "99.99",
        "currency_code": "USD"
    },
    "presentment_money": {
        "amount": "99.99",
        "currency_code": "USD"
    }
}

```

My understanding is this is actually different behaviour when compared to native Shopify Payments multi-currency support where the shop_money would remain in GBP and just the presentment_money would be set to USD?

Is there any documentation around this as we're reluctant to start creating orders where the shop currency is different to the merchants default shop currency in case there are any downstream implications, e.g. reporting, analytics or other third party apps etc.

Thanks,

Richard

0 Likes
Rich44
Shopify Partner
7 0 0

These are the requests I've tested on a GBP development store:

 

```

POST https://{{store}}.myshopify.com/admin/orders.json

{
  "order": {
    "line_items": [{
        "variant_id": 20962533146742,
        "quantity": 1,
        "price": "99.99"
        }
    ],
    "currency": "USD", 
    "financial_status": "paid"
    }
}

```

And

```

POST https://{{store}}.myshopify.com/admin/orders.json

{
  "order": {
    "line_items": [{
        "variant_id": 20962533146742,
        "quantity": 1,
        "price": "75.60"
        }
    ],
    "currency": "GBP", 
    "financial_status": "paid"
    }
}

```

Which gives us two orders with different shop and presentment currencies from one another:

Screenshot 2020-11-19 at 16.04.43.png

This is exactly the behaviour we want, however as mentioned previously we're nervous because a) I can't find any documentation about this functionality and b) we don't want to cause any downstream issues for our users.

0 Likes
Rich44
Shopify Partner
7 0 0

I can actually see already it causes issues with the built-in Shopify reports: 

Screenshot 2020-11-19 at 16.56.37.png

You can see it's just treating the 99.99 USD as GBP here.

0 Likes
Rich44
Shopify Partner
7 0 0

I can confirm the native Shopify Payments multi currency support creates orders with presentment_currency and shop_currency set to different values, e.g.

```

"total_price_set": {
    "shop_money": {
        "amount": "76.59",
        "currency_code": "GBP"
    },
    "presentment_money": {
        "amount": "102.00",
        "currency_code": "USD"
    }
},

 

```

Is it possible for third party apps to do this via the Admin API?

0 Likes
sjswoboda
Shopify Staff
Shopify Staff
1 0 0

You are, unfortunately, correct. There is currently no way to create a true multi-currency order via REST API. If this was supported, the parameter `presentment_currency` would accept the foreign currency, however, at this time, `currency` is not allowed to be different from `presentment_currency` on the order create API. Generally, since the only way to create a multi-currency order today is through Online Store, this just hasn't been prioritized.

The ability to accept any currency in the `currency` parameter is legacy behaviour (pre-dating multi-currency) as apps would often use that to import orders. At that time `presentment_currency`, which is what is used for multi-currency didn't exist. The `currency` field continues to accept any currency and yes, that does break reporting in sad ways. This behaviour may change as better multi-currency support is added to the API.

Can you help me understand how you would expect to use this API? For reporting to not break, an amount in shop currency would also need to exist. Is this a value that you'd expect to provide or to be auto generated with fx rates at the time of order creation in Shopify?

 

0 Likes
Rich44
Shopify Partner
7 0 0

Thanks for the insight.

I think, for our use case, either API approach would work; we could either explicitly pass in both the shop and presentment currencies ourselves as we do already have them or alternatively we'd be happy to just supply the presentment currency and have Shopify perform the currency conversion itself on the way in.

Ultimately we're just keen to avoid creating orders with a different shop currency for fear of breaking functionality which assumes there's only one shop currency; i.e. native reporting and potentially other third party apps.

0 Likes