Retrieve refund

GET 
/refunds/:refund_id

Retrieves one refund by ID

Request

Path Parameters

refund_id uuidrequired

Possible values: <= 36 characters, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Refund's ID

Responses

200

Refund retrieved

application/json

Schema

Schema

status string

Possible values: [success]

data

object

id uuid

Possible values: <= 36 characters, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

UUID v4

charge_id uuid

Possible values: <= 36 characters, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

UUID v4

merchant_id uuid

Possible values: <= 36 characters, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

UUID v4

customer_id uuid

Possible values: <= 36 characters, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

UUID v4

reason string

Possible values: [duplicate, fraudulent, requested_by_customer, expired_uncaptured_charge, chargeback_alert_automatic_resolution]

Reason code

description stringnullable

Possible values: <= 255 characters

Description for this refund

status RefundStatus (string)

Possible values: [pending, succeeded, failed]

created_on Unix timestamp

Unix timestamp representing the date

initial_amount

object

Money representation

value MoneyAmount (integer)required

Possible values: <= 9999999999

Amount expressed in cents. 1 USD should be submitted as 100 cents

currency /[A-Z]{3}/required

ISO 4217 representation of the currency

ending_amount

object

Money representation

value MoneyAmount (integer)required

Possible values: <= 9999999999

Amount expressed in cents. 1 USD should be submitted as 100 cents

currency /[A-Z]{3}/required

ISO 4217 representation of the currency

refund_amount

object

Money representation

value MoneyAmount (integer)required

Possible values: <= 9999999999

Amount expressed in cents. 1 USD should be submitted as 100 cents

currency /[A-Z]{3}/required

ISO 4217 representation of the currency

code integer

Possible values: [200]

message string

Possible values: [Successful request]

Example (from schema)

{
  "status": "success",
  "data": {
    "id": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
    "charge_id": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
    "merchant_id": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
    "customer_id": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
    "reason": "duplicate",
    "description": "Broken goods, returned by customer",
    "status": "pending",
    "created_on": 1656656767,
    "initial_amount": {
      "value": 99,
      "currency": "USD"
    },
    "ending_amount": {
      "value": 99,
      "currency": "USD"
    },
    "refund_amount": {
      "value": 99,
      "currency": "USD"
    }
  },
  "code": 200,
  "message": "Successful request"
}

401

Access token is missing or invalid

403

Access denied

409

Request failed due to a conflict in the provided entity

application/json

Schema

Schema

status string

Possible values: [fail]

code integer

Possible values: [409]

message string

Failure reason

Example (from schema)

{
  "status": "fail",
  "code": 409,
  "message": "Entity with Id already exists"
}

422

Query failed due to query parameters validation failure

application/json

Schema

Schema

status string

Possible values: [error]

data object
code integer

Possible values: [422]

message string

Example (from schema)

{
  "status": "error",
  "data": {
    "dob": {
      "day": "Value expected to be 'integer', 'string' given."
    }
  },
  "code": 422,
  "message": "cannot process the provided entity"
}

500

Server error

Loading...