courrier
Eñepyrũ
Tiénda, ñehepyme'ẽha ha e-commerce-pe guarã

Ñemondo oñeñangarekóva nde tiéndape guarã, API rupive.

Esẽ logística-gui: nde reñevende ha errecibi pe mba'e repykue oñemomba'eguasúva, ne sistema rupive. courrier oñangareko ñemondonte — pe cliente oiporavo ko flete checkout-pe, omoneĩ jererú ha ohepyme'ẽ flete oñeñangarekóva. Hepy'ỹre ha tembiaporã'ỹre ne tiéndape jererú rire. _TODO: revisão por falante nativo de Guaraní.

Eñepyrũ ñembojoaju Ehecha mba'éichapa ojejoaju
deliveries.http
POST /v1/store/deliveries HTTP/1.1
Host: api.courrier.app
Content-Type: application/json
Authorization: Courrier-HMAC-SHA256 key_id=tienda_4f3a9c
x-courrier-timestamp: 1718900000
x-courrier-signature: 9f86d081884c7d659a2feaa0c55ad015

{
  "currency": "PYG",
  "items": [
    { "name": "Sapatu okorrekuaáva", "quantity": 1, "unitAmount": 250000 }
  ],
  "buyer": {
    "name": "Mariano López",
    "phone": "+595981234567",
    "country": "PY",
    "state": "Central"
  },
  "pickup": {
    "address": "Palma 555",
    "city": "Asunción",
    "state": "Central"
  }
}

# esigna HMAC-SHA256 nde secret reheve ko'ã ári: _TODO

signature = HMAC_SHA256(secret, `${ts}.${METHOD}.${url}.${rawBody}`)

Mba'érepa embojoaju

Eñehepyme'ẽve, akãrasy'ỹre logística-gui.

courrier ombohape pe ñemondo nde tiéndape guarã, jehepyme'ẽ oñeñangarekóva ha ogueraháva oñemomba'eguasúva sistema omoĩva reheve. _TODO: revisão por falante nativo de Guaraní.

Ñemondo checkout-pe, flota'ỹre

Eme'ẽ ñemondo pya'e ñehepyme'ẽ apópe nerembyatýiva ogueraháva. _TODO

Nde reñevende ha errecibi oñemomba'eguasúvo

Pe ñevende ha pe mba'e repykue ñehepyme'ẽ ndéve, ne sistema rupive — courrier ndopokói upévare. Ko'ápe flete-nte opyta oñeñangarekóva, escrow-pe oñemoneĩ peve. _TODO

Ndéve ningo pe mba'e añoite

Eme'ẽ pe mba'e mombyry; courrier oñangareko flete, ñemoĩ ha ñehapykueho rehe. _TODO

Ogueraháva oñemomba'eguasúva

Sistema omoĩ peteĩ ogueraháva oñehechauka ha oñemomba'eguasúva opa tape-pe. _TODO

Ne tiénda rembiapo

Mba'éichapa omba'apo pe tembiaporã.

Tesakã guasu: ne tiénda nohepyme'ẽi mba'eve ha ne tembiaporã opa jererúpe. Ehecha mamo peve oho ne tembiaporã. _TODO: revisão por falante nativo de Guaraní.

Tembiaporã línea de tiempo

  1. 1

    Pedido

    ñehepyme'ẽ oñembotypyre ne checkout-pe

  2. 2

    Cliente omoneĩ jererú

    cliente omboheja jererú transportista-pe

    Tiénda tembiaporã paha
  3. 3

    Oho hína

    gueru ogueruhára tembiaporãme

  4. 4

    Oñeguahẽma

    cliente omoneĩ ñemog̃uahẽ

Ko'águi tenonde ha'e jehechaukarã añónte: rehapykueho API rupive reipotáramo, remomba'eguasu ogueruhára ha rehupyty feedback — tembiaporã pyahu'ỹre. _TODO: revisão por falante nativo de Guaraní.

1. Ne tiéndape ndojehepyme'ẽi mba'eve

Ndaipóri jejara jasykue ha ndaipóri tasa tiendape g̃uarã. Pe komisiõ osẽ pe flete oñeñe'ẽmeĩvagui jeporureha ha ogueruhára apytépe — ne tiénda nohepyme'ẽi mba'eve. _TODO: revisão por falante nativo de Guaraní.

2. Pe mba'egueru ha'e ogueruhára tembiaporã

Pe omyengoviáva pe mba'egueru rehe ha'e pe ogueruhára (pe transportista). Ndaha'éi ne tiénda ha ndaha'éi courrier — ha'e pe ojapóva pe gueru. _TODO: revisão por falante nativo de Guaraní.

3. Pe oiporavóva ha omoneĩva ha'e ne cliente

Ne tiénda cliente ha'e pe oiporavóva ko flete ha pe omoneĩva pe mba'e ñeme'ẽ ogueruhárape (pe jererú). _TODO: revisão por falante nativo de Guaraní.

4. Ñemoneĩ rire, ne tiénda ndaipórivéima joaju

Jererú ñemoneĩ guive, pe tiénda ojapóma iparte ha ndaipórivéima joaju pe mba'egueru ndive. _TODO: revisão por falante nativo de Guaraní.

5. Hapykueho ha'e jehechaukarã añónte, API rupive

Rehapykueho hag̃ua katu, pe sistema omoĩ API rupive pe mba'egueru estado oñeguahẽ peve. Rehechauka ikatu ne sistema-pe térã nahániri — ha'e jehechaukarã añónte. _TODO: revisão por falante nativo de Guaraní.

6. Reikuaa gueteri remomba'eguasu ha rehupyty feedback

Joaju'ỹre jepe, pe tiénda ikatu omomba'eguasu ogueruhára reko jererúpe (puntaje) ha ohupyty feedback mba'éichapa oĩ pe mba'egueru. _TODO: revisão por falante nativo de Guaraní.

Ñembojoaju

Mba'éichapa embojoaju 3 jepývope.

Peteĩ jehenói server-to-server osignáva HMAC reheve ha webhooks estado-gua. _TODO: revisão por falante nativo de Guaraní.

  1. 1

    Ejapo nde cuenta tiénda ha emoheñói peteĩ API key

    Panel tiénda-pe ejapo cuenta ha emoheñói mokõi llave (key_id + secret). _TODO

  2. 2

    Ejerure ñemondo reñembotývo ñevende

    Nde errecibíma pe mba'e repykue ne sistema rupive. Reñembotývo ñevende, nde servidor ojapo POST osignáva (HMAC-SHA256) /v1/store/deliveries-pe items, jeporureha ha ñembyaty rendarã reheve — ñemondonte oñembosako'i hag̃ua. _TODO

  3. 3

    Errecibi webhooks estado-gua

    courrier omondo webhooks osignáva opa estado ñemoambue-pe. _TODO

deliveries.http
POST /v1/store/deliveries HTTP/1.1
Host: api.courrier.app
Content-Type: application/json
Authorization: Courrier-HMAC-SHA256 key_id=tienda_4f3a9c
x-courrier-timestamp: 1718900000
x-courrier-signature: 9f86d081884c7d659a2feaa0c55ad015

{
  "currency": "PYG",
  "items": [
    { "name": "Sapatu okorrekuaáva", "quantity": 1, "unitAmount": 250000 }
  ],
  "buyer": {
    "name": "Mariano López",
    "phone": "+595981234567",
    "country": "PY",
    "state": "Central"
  },
  "pickup": {
    "address": "Palma 555",
    "city": "Asunción",
    "state": "Central"
  }
}

# esigna HMAC-SHA256 nde secret reheve ko'ã ári: _TODO

signature = HMAC_SHA256(secret, `${ts}.${METHOD}.${url}.${rawBody}`)

Webhooks osignáva, ñemondojevy reheve

Opa estado ñemoambue omondo peteĩ webhook osignáva. Ndoikói? courrier omondojevy automátiko-pe. _TODO

Ñeñangareko oĩva ipype

Flete escrow-pe, osẽ oñemoneĩvo añoite.

Pe ñeñangareko ndaha'éi ñe'ẽ me'ẽ marketing-gua — oĩ protocolo-pe. _TODO: revisão por falante nativo de Guaraní.

  • courrier ndopokói pe mba'e repykue ñehepyme'ẽre (ne mba'éva): flete-nte opyta escrow no-custodial-pe. _TODO
  • Osẽ jeporureha omoneĩvo ñemog̃uahẽ. _TODO
  • Joavy oñongatu pe valor oñeñangarekóvo oñesolusiona peve. _TODO
  • Jehepyme'ẽ ñembojoaju PIX/DePix rupive — osẽ pohýi. _TODO

Ne jehepyme'ẽ opyta ñangarekópe

Pe viru oho peteĩ kotýpe oikotevẽva 2 teratĩ 3-gui (nde, ogueruhára ha courrier) — avave ndoguenohẽi ha'eño. Oñemboheja remoneĩvo pe mba'egueru añónte.

  • Koty noñangarekóiva — courrier noñongatúi ne viru.
  • Jeheja ne moneĩ jehupyty reheve añónte.

Hepykue ne tiéndape

Ne tiéndape g̃uarã, hepy'ỹre.

courrier nohepyme'ẽukái mba'eve ne tiéndagui: ni tasa, ni komisiõ, ni mensalidade. Nde reñevende ha errecibi pe mba'e repykue oñemomba'eguasúvo, ne sistema rupive — ñemondonte rembojupi ambuépe. _TODO: revisão por falante nativo de Guaraní.

$0

hepykue ne tiéndape

tasa'ỹre, komisiõ'ỹre térã mensalidade'ỹre

100%

mba'e ndéve

nde reñevende ha errecibi ne sistema rupive

100%

flete oñeñangarekóva

escrow-pe oñemoneĩ peve

Pe komisiõ (10% flete-gua) oñehepyme'ẽ pe oguerahávagui, pe ñemondo repykue ári — araka'eve ne tiéndagui ni mba'e repykuégui. _TODO

Eñembosako'i reme'ẽ haguã ñemondo oñeñangarekóva?

Ejapo nde cuenta tiénda, emoheñói API key ha ejapo nde checkout peteĩha sapy'aitépe. _TODO: revisão por falante nativo de Guaraní.

Eñepyrũ ñembojoaju Ehecha kuatia ñehekombo'erã

Checkout osignáva HMAC · Webhooks estado-gua · Jehepyme'ẽ PIX/DePix osẽ pohýi