Codex · III

Statusar och återbetalningar

Transaktionsstatusar

Varje transaktionsrad i instrumentpanelen har en av dessa statusar. Statusen speglar den senaste händelsen för den transaktionen; återbetalningar och tvister uppdaterar den befintliga raden istället för att infoga en syskonrad.

StatusBetydelse
succeededBetalning slutförd. Pengarna finns på ditt konto (netto efter leverantörsavgifter).
pendingBetalningen är på väg. Vanligt med asynkrona betalningsmetoder (ACH, vissa kryptovägar) där bekräftelse tar minuter till timmar.
failedBetalningen slutfördes inte: kort nekat, utgången auktorisering, hård avvisning. Inga pengar rörde sig.
partialKöparen betalade mindre än fakturerat (vanligt när en kryptoköpare skickar ett belopp reducerat med nätverksavgift). Radens amount speglar vad som faktiskt togs emot; kontrollera metadata.invoicedAmount för vad som begärdes.
refundedPengar har återförts till köparen, helt eller delvis. Radens amount är det återbetalda beloppet; återbetalningar kan ske dagar eller veckor efter den ursprungliga betalningen.
disputedKöparen (eller deras bank) öppnade en tvist eller återkrav. Kontrollera leverantörens gränssnitt för svarsfönstret. Radens metadata.reason bär leverantörens klassificering ordagrant.
pending_manualEn transaktion för betala via post väntar på din fysiska bekräftelse. Se nästa avsnitt.
manual_canceledDu klickade på Avbryt på en väntande rad för betala via post innan köparens betalning anlände.
manual_expiredEn väntande rad för betala via post låg i 30 dagar utan bekräftelse och gick automatiskt ut.
manual_revokedDu bekräftade mottagandet av en betalning via post men ångrade senare bekräftelsen (t.ex. betalningen visade sig vara ogiltig). Raden flyttas från succeeded tillbaka till detta slutgiltiga tillstånd.

Återbetalningar, tvister, delbetalningar

Coin Moebius lyssnar efter dessa leverantörshändelser och uppdaterar den ursprungliga transaktionsraden i instrumentpanelen. Specifikt:

  • Återbetalningar: Stripes händelse charge.refunded (hela eller delvisa återbetalningar, inklusive amount_refunded så att delvisa återbetalningar visar den del som återfördes). NOWPayments IPN refunded. Radens status växlar till refunded, amount speglar det återbetalda beloppet, och metadata.originalChargeId / metadata.originalAmount bär kontexten för den ursprungliga betalningen.
  • Tvister (återkrav): Stripes händelse charge.dispute.created. Radens status växlar till disputed. Leverantörens angivna skäl skickas ordagrant vidare till metadata.reason, du kan rendera det i ditt eget gränssnitt hur du vill.
  • Delbetalningar: NOWPayments IPN partially_paid. Radens status växlar till partial. amount speglar vad som faktiskt togs emot (actually_paid); metadata.invoicedAmount är vad som begärdes.

I v1 ytas dessa händelser i instrumentpanelen och via /status-endpointen. En framtida version kommer att lägga till e-postaviseringar och en utgående webhook-vidarebefordrare så att din egen backend kan reagera automatiskt. Tills vidare, sätt upp ett litet avfrågningsjobb (se nästa avsnitt) eller kontrollera instrumentpanelen.

Redo att koppla in det?

Gratisnivån täcker de flesta webbplatser och ber aldrig om ett kort.