Skip to main content

​
Get Pay-in

Retrieve the full details of a pay-in by its ID, including current status and payment instructions.

​
Endpoint

GET /v1/payins/:id

​
Request

curl https://api.thiqwave.com/v1/payins/payin_1234567890 \
  -H "X-API-Key: your_api_key"

​
Response

{
  "payin_id": "payin_1234567890",
  "quote_id": "quote_1234567890",
  "status": "processing",
  "source_currency": "AED",
  "destination_currency": "USDT",
  "destination_network": "ethereum",
  "destination_address": "0x742d35Cc6634C0532925a3b844Bc123e5fA42f9c",
  "source_amount": 50000,
  "estimated_stablecoin_amount": "479.50",
  "actual_stablecoin_amount": null,
  "payment_instructions": {
    "beneficiary_account": "1234567890",
    "beneficiary_name": "Thiqwave Limited",
    "bank_code": "ABUAAE3D",
    "country": "AE",
    "reference": "payin_1234567890"
  },
  "expires_at": "2026-04-09T14:45:00Z",
  "created_at": "2026-04-09T14:30:00Z",
  "completed_at": null
}

​
Response Fields

FieldTypeDescription
payin_idstringUnique pay-in identifier.
quote_idstringAssociated quote ID.
statusstringCurrent status: awaiting_deposit, processing, completed, failed.
source_currencystringSource fiat currency.
destination_currencystringDestination stablecoin.
destination_networkstringDestination blockchain.
destination_addressstringRecipient wallet address.
source_amountintegerAmount in smallest fiat unit.
estimated_stablecoin_amountstringExpected stablecoin in human-readable format.
actual_stablecoin_amountstring | nullActual amount if completed.
payment_instructionsobjectBank transfer details.
expires_atstringISO 8601 timestamp when pay-in window closes.
created_atstringISO 8601 timestamp of creation.
completed_atstring | nullISO 8601 timestamp of completion.

​
Notes

  • Check the status field to determine the current state of the pay-in.
  • If status is awaiting_deposit, use the payment_instructions to complete the bank transfer.
  • Once status becomes completed, the stablecoins have been delivered to the destination address.