Cost+Docs

Aisíocaíochtaí

Próiseáil aisíocaíochtaí iomlána agus páirteacha

Tacaíonn Cost+ le haisíocaíochtaí iomlána agus páirteacha ar orduithe críochnaithe. Próiseáiltear aisíocaíochtaí tríd an modh íocaíochta bunaidh a úsáideadh don idirbheart.

Aisíocaíocht a Chruthú

Seol iarratas POST chuig /v1/orders/\{id\}/refunds/ chun aisíocaíocht a thionscnamh ar ordú críochnaithe.

Iarratas

{
  "amount": 100,
  "description": "Refund for item",
  "merchant_order_id": "refund-001"
}

Úsáideann an réimse amount mionaonad ISO 4217 an airgeadra. Le haghaidh EUR, ciallaíonn aisíocaíocht 1.00 EUR amount a shocrú go 100. Chun aisíocaíocht iomlán a eisiúint, bain úsáid as méid iomlán an ordaithe.

Réimsí Iarratais

RéimseRiachtanachCur Síos
amountTáMéid na haisíocaíochta i mionaonad ISO 4217 an airgeadra
descriptionNílCúis na haisíocaíochta
merchant_order_idNílD'aitheantas tagartha féin don aisíocaíocht
extraNílMeiteashonraí breise mar réad eochair-luacha

Freagra

Seolann an API an réad aisíocaíochta ar ais lena stádas reatha:

{
  "id": "ref_abc123...",
  "created": "2024-01-02T10:00:00.000000+00:00",
  "modified": "2024-01-02T10:00:00.000000+00:00",
  "amount": 100,
  "currency": "EUR",
  "status": "pending",
  "description": "Refund for item",
  "merchant_order_id": "refund-001",
  "extra": null
}

Réimsí Freagra

RéimseCur Síos
idAitheantóir uathúil na haisíocaíochta
createdStampa ama nuair a cruthaíodh an aisíocaíocht
modifiedStampa ama nuair a nuashonraíodh an aisíocaíocht go deireanach
amountMéid na haisíocaíochta i mionaonad ISO 4217 an airgeadra
currencyAirgeadra na haisíocaíochta (comhoiriúnach le hairgeadra an ordaithe)
statusStádas reatha na haisíocaíochta (pending, completed, failed)
descriptionCúis na haisíocaíochta
merchant_order_idD'aitheantas tagartha
extraMeiteashonraí breise

Aisíocaíochtaí Iomlána vs. Páirteacha

  • Aisíocaíocht iomlán: Socraigh an amount go méid iomlán an ordaithe. Seoltar an íocaíocht iomlán ar ais chuig an gcustaiméir.
  • Aisíocaíocht pháirteach: Socraigh an amount go níos lú ná méid iomlán an ordaithe. Ní sheoltar ar ais ach an méid sonraithe.

Is féidir leat aisíocaíochtaí páirteacha iolracha a eisiúint ar an ordú céanna, chomh fada is nach sáraíonn an méid iomlán aisíoctha méid bunaidh an ordaithe.

{
  "amount": 500,
  "description": "Partial refund - damaged item"
}

Ní féidir aisíocaíochtaí a eisiúint ach ar orduithe le stádas completed. Má dhéantar iarracht ordú nach bhfuil críochnaithe fós a aisíoc, beidh earráid mar thoradh air.

Úsáid an réimse merchant_order_id chun aisíocaíochtaí a nascadh ar ais le do chórais inmheánacha. Tá sé seo úsáideach go háirithe agus aisíocaíochtaí páirteacha iolracha á n-eisiúint ar an ordú céanna.

Stádais Aisíocaíochta

StádasCur Síos
pendingTionscnaíodh an aisíocaíocht agus tá sí á próiseáil.
completedPróiseáladh an aisíocaíocht go rathúil. Seolfar cistí ar ais chuig an gcustaiméir.
failedNíorbh fhéidir an aisíocaíocht a phróiseáil. Déan teagmháil le tacaíocht Cost+ le haghaidh cúnaimh.

Braitheann an t-am a thógann sé go dtí go bhfeiceann an custaiméir an méid aisíoctha ina gcuntas ar an modh íocaíochta agus ar bhanc an chustaiméara. De ghnáth tógann aisíocaíochtaí cárta creidmheasa 5-10 lá oibre.

Méid Inaisíoctha a Sheiceáil

Sula n-eisíonn tú aisíocaíocht pháirteach, is féidir leat seiceáil cé mhéid atá ar fáil:

curl -u YOUR_API_KEY: \
  "https://api.costplus.online/v1/orders/{order_id}/?fields[]=amount_details"

Taispeánann an réimse refundable san fhreagra an uasmhéid is féidir leat a aisíoc.

Críochphointí Gaolmhara

On this page