v1

latestOpenAPI 3.0.32026-07-2618073.2 KB

Purchases

Refund purchase

Refunds a purchase if verification code was not received within 20 minutes.

Requirements:

Status PENDING, code not received
At least 20 minutes since purchase creation

post/v1/purchases/{purchase_id}/refund

Path parameters

purchase_idinteger required

Unique purchase identifier.

Example:12345

Response

Response for status 200

Example response

{
  "purchase": {
    "id": 12345,
    "country_code": "US",
    "display_name": {
      "ru": "США",
      "en": "United States"
    },
    "phone_number": "+12025550123",
    "price": {
      "amount": "1.50",
      "currency_code": "USD"
    },
    "status": "SUCCESS",
    "purchase_type": "SINGLE",
    "verification": {
      "code": "12345",
      "password": "secret123",
      "received_at": "2024-11-19T07:52:00.000Z"
    },
    "created_at": "2024-11-19T07:50:00.000Z"
  },
  "refund": {
    "amount": {
      "amount": "1.50",
      "currency_code": "USD"
    },
    "reason": "Auto-refund: code not received within 20 minutes",
    "refunded_at": "2024-11-19T08:15:00.000Z"
  }
}