Shop Cash -tilaustiedot ja kolmannen osapuolen integraatiot

Kun asiakas käyttää Shop Cashia tilauksessa, Shop Cashia käsitellään maksutapana. Se ei ole alennus, lahjakortti tai kauppakrediitti. Tilauksen mahdollinen loppusaldo maksetaan Shop Paylla tai Shop Pay -maksuerillä.

Jos asiakas esimerkiksi käyttää 25 USD Shop Cashia 100 USD:n tilaukseen, tilaus sisältää 25 USD:n Shop Cash -maksun ja 75 USD:n Shop Pay -maksun. Tilaustietosi voivat sisältää useamman kuin yhden maksutavan samalle tilaukselle.

Shop Cash näkyy tilauksen maksutapahtumana, jonka maksuyhdyskäytävän arvo on shop_cash (jos maksuyhdyskäytävän arvoja on saatavilla). Shop Cash -maksutapahtuma noudattaa maksutapahtuman normaalia elinkaarta, johon kuuluvat valtuutus, veloitus, mitätöinti ja maksun palautus. Shop Cash ei käytä yhdistettyä myynnin maksutapahtumatyyppiä.

Jos asiakas käyttää myös Shop Campaigns -kampanjasta peräisin olevaa Shop-tarjousta, kampanjan rahoittama arvo sisältyy samaan shop_cash-maksutapahtuman summaan. Ostajan saldosta peräisin olevaa osuutta ja kampanjan rahoittamaa osuutta ei esitetä erillisinä tilauksen maksutapahtumina. Tammikuusta 2026 alkaen kampanjakulut veloitetaan Shopify-laskultasi sen sijaan, että ne vähennettäisiin tilityksistäsi. Siksi tilitystapahtumien kampanjalaskutustapahtumat koskevat vain kyseistä päivämäärää ennen toteutettuja kampanjoita. Lisätietoja on kohdassa Maksut, Shop Campaigns ja Shop Cash.

Kolmannen osapuolen järjestelmien, jotka tuovat tilauksia, maksutapahtumia, maksuja, tilauksen täyttämisiä, maksun palautuksia tai palautuksia, on tunnistettava Shop Cash maksutapana. Jos järjestelmä ei tunnista Shop Cashia, Shop Cashia sisältävien tilausten tuonti saattaa epäonnistua, tilausten maksutiedot saattavat olla puutteellisia tai ne saattavat vaatia manuaalista yhdistämistä.

Tarkista seuraavat vaatimukset kolmannen osapuolen järjestelmän palveluntarjoajan kanssa:

• Järjestelmä voi tukea useampaa kuin yhtä maksutapaa yhdessä tilauksessa.
• Järjestelmä pystyy yhdistämään shop_cash-arvon maksutapana.
• Järjestelmä ei käsittele Shop Cashia alennuksena, lahjakorttina tai kauppakrediittinä.
• Järjestelmä tallentaa tilauksen maksutapahtuman tunnuksen jokaista Shop Cashin valtuutusta, veloitusta, mitätöintiä ja maksun palautusta varten.
• Järjestelmä tallentaa Shop Cashin koko valtuutusarvon katkaisematta sitä, jos arvo sisältyy järjestelmän tuomiin tietoihin.
• Järjestelmä käsittelee valtuutusarvoja läpinäkymättöminä merkkijonoina eikä jäsennä, pura koodausta, normalisoi tai tiivistä niitä tai päättele niistä merkityksiä.
• Järjestelmä pystyy käsittelemään maksun palautuksia, jotka palauttavat varoja sekä Shop Payhin että Shop Cashiin.
• Järjestelmä pystyy täsmäyttämään Shop Cash -tilitystapahtumat erillään korttimaksutapahtumista.
• Järjestelmä ei oleta, että maksutapahtumat palautetaan tietyssä järjestyksessä.

Jos kolmannen osapuolen järjestelmäsi olettaa, että jokaisella tilauksella on vain yksi maksutapa, ota yhteyttä palveluntarjoajaan ennen kuin käsittelet Shop Cash -tilauksia kyseisen järjestelmän kautta.

Shop Cash -maksutapahtuman valtuutusarvo on läpinäkymätön ja pituudeltaan vaihteleva merkkijono. Se ei ole lyhyt kortin valtuutuskoodi, eikä se ole ihmisen luettavissa.

Jos ERP-, OMS- tai muu kolmannen osapuolen järjestelmäsi tuo Shop Cash -valtuutusarvoja, tallenna koko arvo täsmälleen sellaisena kuin se on annettu. Käytä mahdollisuuksien mukaan pituudeltaan vaihtelevaa tai rajoittamatonta tekstikenttää.

Kun järjestelmäsi tallentaa Shop Cash -valtuutusarvoja, noudata näitä ohjeita:

• Älä katkaise arvoa lyhyeen kiinteään pituuteen, kuten 50 tai 100 merkkiin.
• Älä jäsennä arvoa tai päättele merkitystä mistään arvon osasta.
• Älä käytä valtuutusarvoa maksutapahtumien tunnistamiseen veloitus-, mitätöinti- tai maksun palautuksen API-toimintoja varten.

Katkaistut valtuutusarvot voivat aiheuttaa kolmannen osapuolen tuontien tai myöhemmän ERP- ja OMS-käsittelyn epäonnistumisen.

Jotta voit tukea veloituksia, mitätöintejä ja maksun palautuksia Admin API -rajapinnan kautta, tallenna tilauksen maksutapahtumien tunnukset ja ylätason maksutapahtumien suhteet. Admin APIn veloitus- ja mitätöintitoiminnot tunnistavat valtuutuksen maksutapahtuman arvolla parentTransactionId. Maksun palautustoiminnot tunnistavat korvauskelpoisen veloituksen maksutapahtuman arvolla parentId.

Kun sovellus tai integraatio tekee Shop Cash -maksun palautuksen APIn kautta, maksun palautus on kohdistettava Shop Cash -veloitusmaksutapahtumaan, ei Shop Cash -valtuutusmaksutapahtumaan. Valtuutusmaksutapahtumaan kohdistuvat maksun palautukset hylätään.

Maksun palautussovellusten ja webhook-käsittelijöiden tulisi tunnistaa korvauskelpoinen Shop Cash -veloitusmaksutapahtuma, laskea kyseisen veloituksen jäljellä oleva korvauskelpoinen summa ja luoda maksun palautus veloitusmaksutapahtuman tunnukselle.

Kun käytät Admin APIa, tilausvientejä, tilitysvientejä tai kolmannen osapuolen sovellusten vientejä, käsittele Shop Cashia maksutietona. Käyttämästäsi viennistä tai API-resurssista riippuen Shop Cash -tiedot voivat sisältyä maksutavan, yhdyskäytävän, tilauksen maksutapahtuman, tilityksen maksutapahtuman ja maksun palautuksen tietoihin.

Kun rakennat tai päivität integraation, tallenna seuraavat tiedot tilauksista, jotka sisältävät Shop Cashia:

• Tilaustunnus ja tilauksen nimi.
• Maksutavan tai yhdyskäytävän arvo, kuten shop_cash, jos saatavilla.
• Tilauksen maksutapahtuman tunnukset jokaiselle maksutapahtumalle.
• Maksutapahtuman tyyppi ja tila, kuten katevaraus, veloitus, maksun palautus tai mitätöinti.
• Maksutapahtuman summa ja valuutta.
• Ylätason maksutapahtuman suhteet, jos saatavilla.
• Maksutunnukset, jos saatavilla.
• Täydet katevarausarvot, jos järjestelmäsi tuo ne.
• Tilitystunnukset ja saldotapahtumien tunnukset, kun täsmäytät tilityksiä.
• Maksun palautusten maksutapahtumatunnukset, kun täsmäytät palautuksia.

Lisätietoja saatavilla olevista Admin API -kentistä on Admin API order transaction -kehittäjän oppaissa. Vältä luottamasta vanhentuneisiin kenttiin, kuten OrderTransaction.authorizationCode, uusissa integraatioissa.

Seuraavassa yksinkertaistetussa esimerkissä on 100 USD:n tilaus, josta 75 USD maksetaan Shopify Paymentsin kautta ja 25 USD Shop Cashilla. Arvot ovat vain suuntaa-antavia.

{
  "transactions": [
    {
      "kind": "authorization",
      "gateway": "shopify_payments",
      "status": "success",
      "amount": "75.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "ch_3OabcXYZ..."
    },
    {
      "kind": "authorization",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "<long-opaque-variable-length-string>"
    },
    {
      "kind": "capture",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": "<shop-cash-authorization-transaction-id>",
      "authorization": null
    }
  ]
}

Shop Cash voi näyttää samalta kuin muut maksu- tai tarjousarvot, mutta järjestelmien tulisi käsitellä kutakin arvoa erikseen:

Ennen kuin luotat kolmannen osapuolen järjestelmään tilauksissa, jotka sisältävät Shop Cashia, vahvista seuraavat vaatimukset:

• Shop Cash on määritetty maksutavaksi.
• Tilaukset, joissa on Shop Cash ja Shop Pay, tuodaan molemmilla maksutavoilla.
• Maksutapalogiikka ei oleta, että yhtä tilausta kohden on vain yksi maksutapa.
• Katevarausarvot tallennetaan pitkinä läpinäkymättöminä merkkijonoina, eikä niitä katkaista.
• Palautuslogiikka voi palauttaa maksun oikealle veloituksen maksutapahtumalle.
• Palautuslogiikka voi palauttaa varat oikeille maksutavoille.
• Tilitysten täsmäytyksessä voidaan huomioida Shop Cash -hyvitykset, maksun palautukset ja kampanjoiden maksutapahtumatyypit.
• Tilauksen täyttämisen, kirjanpidon ja palautusten työnkulut eivät käsittele Shop Cashia alennuksena.

Jos käytät useita järjestelmiä, tee tämä tarkistus jokaiselle järjestelmälle, joka vastaanottaa tilaus-, maksutapahtuma-, tilitys-, tilauksen täyttämis-, maksunpalautus- tai palautustietoja.