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éimse | Riachtanach | Cur Síos |
|---|---|---|
amount | Tá | Méid na haisíocaíochta i mionaonad ISO 4217 an airgeadra |
description | Níl | Cúis na haisíocaíochta |
merchant_order_id | Níl | D'aitheantas tagartha féin don aisíocaíocht |
extra | Níl | Meiteashonraí 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éimse | Cur Síos |
|---|---|
id | Aitheantóir uathúil na haisíocaíochta |
created | Stampa ama nuair a cruthaíodh an aisíocaíocht |
modified | Stampa ama nuair a nuashonraíodh an aisíocaíocht go deireanach |
amount | Méid na haisíocaíochta i mionaonad ISO 4217 an airgeadra |
currency | Airgeadra na haisíocaíochta (comhoiriúnach le hairgeadra an ordaithe) |
status | Stádas reatha na haisíocaíochta (pending, completed, failed) |
description | Cúis na haisíocaíochta |
merchant_order_id | D'aitheantas tagartha |
extra | Meiteashonraí breise |
Aisíocaíochtaí Iomlána vs. Páirteacha
- Aisíocaíocht iomlán: Socraigh an
amountgo 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
amountgo 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ádas | Cur Síos |
|---|---|
pending | Tionscnaíodh an aisíocaíocht agus tá sí á próiseáil. |
completed | Próiseáladh an aisíocaíocht go rathúil. Seolfar cistí ar ais chuig an gcustaiméir. |
failed | Ní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
- Aisíocaíocht a Chruthú — aisíocaíocht iomlán nó pháirteach a eisiúint ar ordú críochnaithe
- Aisíocaíochtaí a Liostú — gach aisíocaíocht d'ordú a fháil