DOCS

Update order number

/

Sipariş numarasını güncelle

Sipariş numarasını güncelleme uç noktasının nasıl çalıştığını öğrenin.

updateMerchantOrderId uç noktası, daha iyi uzlaştırma, iletişim ve denetim için mağazanızın sipariş kimliği ile Zonos sisteminde bir siparişi güncellemek için kullanılır.

Uç Nokta 

POST | https://api.iglobalstores.com/v1/updateMerchantOrderId

HTTPS isteği

AlanNotlar
HTTP yöntemiPOST
Uç nokta URL'sihttps://api.iglobalstores.com/v1/updateMerchantOrderId
ProtokolHTTPS
Mesaj formatıJSON
Accept HTTP başlığıAccept: application/json
Content-Type HTTP başlığıContent-Type: application/json

İstek gövdesindeki JSON anahtar/değer çiftleri

Örnek

1
2
3
4
5
6
{
  "store": "999",
  "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
  "orderId": "999-9999",
  "merchantOrderId": "12-34567"
}

İstek JSON tanımları

AlanNotlar
merchantOrderId GEREKENBu parametre, mağazanızın dahili sipariş kimliğini Zonos sistemindeki siparişle iletmek için kullanılır. Daha iyi uzlaştırma, iletişim ve denetim için önerilir.string
orderId GEREKENZonos sipariş kimliği - mağaza kimliğiniz ve tire ile veya olmadan iletilebilir (Örnek: 123-45678 veya 45678). Not: Sipariş tamamlandıktan ve ödeme yapıldıktan sonra, müşteri alan adınızda barındırılan Sipariş Tamamlandı / Sipariş Teşekkür Sayfasına yönlendirilecektir. URL, bu değeri içerecek “orderId” sorgu dizesi parametresini içerecektir.integer / string
secret GEREKENZonos tarafından sağlanan API gizli GUID'si.string
store GEREKENZonos tarafından sağlanan Mağaza Kimliğiinteger

HTTPS yanıtı

Örnek başarılı yanıt

1
2
3
{
  "success": "Updated Order: 99999 with new merchantOrderId: 12-34567"
}

Örnek hata yanıtı

1
2
3
{
  "error": "Could not retrieve order to updateMerchantOrderId for orderId: 99999"
}

Hata HTTP yanıtları

Hata koduTanım
406 - Kabul EdilemezHTML Varlığı. HTTP “Accept” başlığı geçersiz.
415 - Desteklenmeyen medya türüHTML Varlığı. HTTP “Content-Type” başlığı geçersiz.
200“error”:”girdi ayrıştırılamadı”
200“error”:”Parameter orderId is required to processUpdateMerchantOrderId”
200“error”:”Parameter merchantOrderId is required to updateMerchantOrderId.”
200“error”:”orderId: 999-99999 geçerli bir orderId değil”
200“error”:”orderId: 999-99999 için updateMerchantOrderId'yi almak mümkün olmadı”
200“error”:”satıcı sipariş kimliğini güncelleme işlemi gerçekleştirilemedi.”
200“error”:”Geçersiz güvenlik kimlik bilgileri”

Yanıt JSON tanımları

MesajTanım
errorBu parametre yalnızca bir hata meydana geldiğinde yanıt içinde bulunacak ve nedeninin bir tanımını içerecektir.string
successBu parametre güncellemenin bir özetini içerecektir.string

Bu sayfa yardımcı oldu mu?