KeelsonDocs
    Judge Mode

    API reference Purchases

    Charge back a card purchase

    POST/v1/purchases/{id}/chargeback

    Files a chargeback through the card issuer over a card purchase's settled transaction, with the purchase's Alibi as the cardholder's evidence: Visa 13.1 or Mastercard 4853 for an item not received, Visa 13.3 or 4853 for one not as described, Visa 10.4 or Mastercard 4837 for a charge the user did not authorize. What the chargeback returns is subtracted from any bond claim over the purchase, and no bond claim is paid while it is open. Only the mandate's owner files it, one at a time.

    Path parameters

    idstringRequired

    Headers

    Content-Typeapplication/jsonRequired
    Idempotency-KeystringRequired
    1 to 255 characters. A retry with the same key returns the first answer.

    Request body

    application/json

    reasonstringRequired
    One of not_receivednot_as_describedunauthorized
    notestring
    amountMinorstring
    Defaults to the settled amount, and cannot exceed it.

    Responses

    • 201Filed
    • 404No such card purchase of this user
    • 409The card is not settled yet, or a chargeback is already open
    • 422The amount is above what was settled
    • 503The card issuer is not configured or unavailable

    201 response

    idstringRequired
    purchaseIdstringRequired
    reasonstringRequired
    One of not_receivednot_as_describedunauthorized
    networkCodesobjectRequired
    amountMinorstringRequired
    statusstringRequired
    resolutionstringRequired
    recoveredMinorstringRequired
    evidenceUploadedbooleanRequired