{
  "opencollection": "1.0.0",
  "info": {
    "name": "HEVN 2FA Cards API",
    "version": "0.1.2"
  },
  "items": [
    {
      "info": {
        "name": "Cards",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Pre-approve card issuance",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards/pre-approve",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Check Wirex KYC prerequisites and return a verification URL if all required user fields are present."
        },
        {
          "info": {
            "name": "Register user for card services",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards/register",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Register user with card provider. Required before issuing cards."
        },
        {
          "info": {
            "name": "Set phone number",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.hevn.finance/api/v1/cards/phone",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Set user's phone number for verification."
        },
        {
          "info": {
            "name": "Send phone OTP",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards/phone/otp",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Send SMS OTP to verify phone number."
        },
        {
          "info": {
            "name": "Verify phone OTP",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards/phone/otp/verify",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Verify SMS OTP code and finalize phone number on the provider side."
        },
        {
          "info": {
            "name": "Get KYC verification link",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards/kyc/link",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Get link for user to complete KYC verification in browser."
        },
        {
          "info": {
            "name": "Get user's cards",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.hevn.finance/api/v1/cards",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Sync cards from Wirex and return the list."
        },
        {
          "info": {
            "name": "Issue new card",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Issue a new virtual or physical card. User must complete KYC first."
        },
        {
          "info": {
            "name": "Get card by ID",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.hevn.finance/api/v1/cards/:card_id",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Get single card details."
        },
        {
          "info": {
            "name": "Delete card",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.hevn.finance/api/v1/cards/:card_id",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Permanently delete (close) a card. This cannot be undone."
        },
        {
          "info": {
            "name": "Reveal full card details",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards/:card_id/details",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Get full card number (PAN), CVV and expiry. Requires wallet signature for confirmation."
        },
        {
          "info": {
            "name": "Freeze card",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards/:card_id/freeze",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Temporarily freeze a card. Can be unfrozen later."
        },
        {
          "info": {
            "name": "Unfreeze card",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/cards/:card_id/unfreeze",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Unfreeze a previously frozen card."
        },
        {
          "info": {
            "name": "Set card limit",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.hevn.finance/api/v1/cards/:card_id/limit",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Set daily spending limit for a card."
        },
        {
          "info": {
            "name": "Set card label",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.hevn.finance/api/v1/cards/:card_id/label",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Set or clear a user-defined label (nickname) for a card. Local-only, not sent to provider."
        },
        {
          "info": {
            "name": "List pending card withdrawals",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.hevn.finance/api/v1/cards/withdrawals/pending",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Proxy to Wirex `GET /api/v1/withdrawal/requests` — returns pending withdrawal requests for the authenticated user's card wallet. See https://docs.wirexapp.com/docs/withdrawals#querying-pending-withdrawals"
        },
        {
          "info": {
            "name": "Pre-approve card issuance",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/pre-approve",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Check Wirex KYC prerequisites and return a verification URL if all required user fields are present."
        },
        {
          "info": {
            "name": "Register user for card services",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/register",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Register user with card provider. Required before issuing cards."
        },
        {
          "info": {
            "name": "Set phone number",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/phone",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Set user's phone number for verification."
        },
        {
          "info": {
            "name": "Send phone OTP",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/phone/otp",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Send SMS OTP to verify phone number."
        },
        {
          "info": {
            "name": "Verify phone OTP",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/phone/otp/verify",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Verify SMS OTP code and finalize phone number on the provider side."
        },
        {
          "info": {
            "name": "Get KYC verification link",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/kyc/link",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Get link for user to complete KYC verification in browser."
        },
        {
          "info": {
            "name": "Get user's cards",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.hevn.finance/api/v1/accounts/cards",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Sync cards from Wirex and return the list."
        },
        {
          "info": {
            "name": "Issue new card",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Issue a new virtual or physical card. User must complete KYC first."
        },
        {
          "info": {
            "name": "Get card by ID",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/:card_id",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Get single card details."
        },
        {
          "info": {
            "name": "Delete card",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/:card_id",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Permanently delete (close) a card. This cannot be undone."
        },
        {
          "info": {
            "name": "Reveal full card details",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/:card_id/details",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Get full card number (PAN), CVV and expiry. Requires wallet signature for confirmation."
        },
        {
          "info": {
            "name": "Freeze card",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/:card_id/freeze",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Temporarily freeze a card. Can be unfrozen later."
        },
        {
          "info": {
            "name": "Unfreeze card",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/:card_id/unfreeze",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Unfreeze a previously frozen card."
        },
        {
          "info": {
            "name": "Set card limit",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/:card_id/limit",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Set daily spending limit for a card."
        },
        {
          "info": {
            "name": "Set card label",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/:card_id/label",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "card_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Set or clear a user-defined label (nickname) for a card. Local-only, not sent to provider."
        },
        {
          "info": {
            "name": "List pending card withdrawals",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.hevn.finance/api/v1/accounts/cards/withdrawals/pending",
            "headers": [
              {
                "name": "x-api-key",
                "value": ""
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Proxy to Wirex `GET /api/v1/withdrawal/requests` — returns pending withdrawal requests for the authenticated user's card wallet. See https://docs.wirexapp.com/docs/withdrawals#querying-pending-withdrawals"
        }
      ]
    }
  ],
  "bundled": true
}