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.

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:

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 ne cliente oiporavóva reheve.

Ñemondo checkout-pe, flota'ỹre

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

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.

Ndéve ningo pe mba'e añoite

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

Ogueraháva oñemomba'eguasúva

Ne cliente oiporavo peteĩ ogueraháva oñehechauka ha oñemomba'eguasúva opa tape-pe — ha nde ikatu errekomenda peteĩ ojeroviaha (opcional): cliente odecidi.

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ã.

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.

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.

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.

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ú).

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.

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.

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.

Ñembojoaju

Mba'éichapa embojoaju 3 jepývope.

Peteĩ jehenói server-to-server osignáva HMAC reheve ha webhooks estado-gua.

  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).

  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.

  3. 3

    Errecibi webhooks estado-gua

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

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:

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.

Ñ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.

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

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.

$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.

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.

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

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