# Fetch payin transaction

Get payin transaction Details for the given ID

Endpoint: GET /public/payin/{payinId}
Version: 2.0.0
Security: bearerAuth

## Path parameters:

  - `payinId` (string, required)
    Payment transaction ID
    Example: "944732c4608c441aa91379478b91f76e"

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for payin transaction
    Example: "944732c4608c441aa91379478b91f76e"

  - `amount` (number, required)
    PayIn transaction amount
    Example: 100

  - `merchantId` (string, required)
    Unique identifier current merchant
    Example: "944732c4608c441aa91379478b91f76e"

  - `customerId` (string, required)
    Unique identifier for create/updated customer
    Example: "944732c4608c441aa91379478b91f76e"

  - `orderId` (string, required)
    Merchant specified order identifier
    Example: "944732c4608c441aa91379478b91f76e"

  - `currency` (string, required)
    PayIn transaction currency. If processor psp doesn't allow this currency but if this currency is enabled it will be automatically converted to PSP currency and final transaction currency will be set respectively.

  - `status` (string, required)
    PayIn transaction status
    Enum: "CREATED", "PENDING", "PENDING_3DS", "SUCCESS", "REFUNDED", "PARTIALLY_REFUNDED", "DECLINED", "FAILED", "TIMEOUT", "REFUND_FAILED", "REFUND_PENDING"

  - `initialAmount` (number, required)
    Transaction initial amount
    Example: 100

  - `initialCurrency` (string, required)
    Transaction initial currency
    Example: "USD"

  - `routerId` (string)
    Router id in which transaction was processed

  - `returnUrls` (object, required)
    Return URLs after transaction is finished.

  - `returnUrls.success` (string, required)
    Url where user will be redirected after successful transaction.
    Example: "https://example.com/success"

  - `returnUrls.failure` (string, required)
    Url where user will be redirected after failed transaction.
    Example: "https://example.com/failure"

  - `cardId` (string)
    Unique identifier for card if card was saved
    Example: "944732c4608c441aa91379478b91f76e"

  - `cardMask` (string)
    Card mask if card was used during transaction
    Example: "1234 56** **** 1234"

  - `cardBrand` (string)
    Card brand if card was used during transaction
    Example: "VISA"

  - `cardHash` (string)
    Card hash if card was used during transaction
    Example: "7094c34678b3a4e29bcb5149266d1c811de2b6fc9370be9d5acdd7a334d8852b"

  - `merchantPspId` (string)
    Merchant specified PSP id
    Example: "944732c4-608c-441a-a913-79478b91f76e"

  - `pspTransactionId` (string)
    Last psp transaction id
    Example: "944732c4-608c-441a-a913-79478b91f76e"

  - `statusReason` (object)
    PayIn transaction status with reason

  - `statusReason.reason` (string)

  - `statusReason.detailedStatus` (string)
    Enum: "GENERAL_DECLINE", "BANK_ISSUES", "PSP_ISSUES", "CUSTOMER_ISSUES", "CVV_INVALID", "CARD_EXPIRED", "CARD_BLOCKED", "CARD_NOT_SUPPORTED", "NO_PROVIDER_AVAILABLE", "OTHER", "PROVIDER_NOT_SUITABLE", "PROVIDER_NOT_IN_ROUTE", "FRAUD_SCORE_ABOVE_THRESHOLD", "BLACKLISTED", "BLOCKED_CARD", "BLOCKED_CUSTOMER", "INVALID_CREDENTIALS", "AUTHENTICATION_FAILED", "ACCESS_DENIED", "CARD_DECLINED", "TRANSACTION_NOT_ALLOWED", "VALIDATION_ERROR", "INVALID_CARD_NUMBER", "INVALID_EXPIRY_DATE", "CVV_MISMATCH", "SYSTEM_ERROR", "DUPLICATE_TRANSACTION", "MARKED_AS_FRAUD", "PSP_UNREACHABLE", "INVALID_REQUEST_FORMAT", "OTHER_FAILURES", "UNMAPPED_ERRORS", "INSUFFICIENT_FUNDS", "THREE_DS_NOT_SUPPORTED", "TRANSACTION_TIMEOUT", "REFUND_ERROR", "REFUND_ALREADY_PROCESSED", "PARTIAL_REFUND_NOT_ALLOWED"

  - `statusReason.status` (string)
    Enum: "CREATED", "PENDING", "PENDING_3DS", "SUCCESS", "REFUNDED", "PARTIALLY_REFUNDED", "DECLINED", "FAILED", "TIMEOUT", "REFUND_FAILED", "REFUND_PENDING"

  - `previousTransactionCount` (integer)
    Number of previous transactions in different payment system.

  - `metadata` (object)
    Transaction metadata

  - `metadata.ipAddress` (string)

  - `metadata.ipInfo` (object)

  - `metadata.ipInfo.country` (string)

  - `metadata.ipInfo.asn` (string)

  - `metadata.ipInfo.vpn` (boolean)

  - `metadata.ipInfo.proxy` (boolean)

  - `metadata.ipInfo.anonymousIp` (boolean)

  - `metadata.deviceType` (string)
    Enum: "MOBILE", "DESKTOP", "TABLET", "UNKNOWN"

  - `metadata.proxyDetection` (object)

  - `metadata.proxyDetection.host` (string)

  - `metadata.proxyDetection.ISP` (string)

  - `metadata.proxyDetection.Organization` (string)

  - `metadata.proxyDetection.ASN` (integer)

  - `metadata.proxyDetection.country_code` (string)

  - `metadata.proxyDetection.city` (string)

  - `metadata.proxyDetection.region` (string)

  - `metadata.proxyDetection.timezone` (string)

  - `metadata.proxyDetection.latitude` (number)

  - `metadata.proxyDetection.longitude` (number)

  - `metadata.proxyDetection.zip_code` (string)

  - `metadata.proxyDetection.is_crawler` (boolean)

  - `metadata.proxyDetection.connection_type` (string)

  - `metadata.proxyDetection.recent_abuse` (boolean)

  - `metadata.proxyDetection.abuse_velocity` (string)

  - `metadata.proxyDetection.bot_status` (boolean)

  - `metadata.proxyDetection.tor` (boolean)

  - `metadata.proxyDetection.active_vpn` (boolean)

  - `metadata.proxyDetection.active_tor` (boolean)

  - `metadata.proxyDetection.mobile` (boolean)

  - `metadata.proxyDetection.fraud_score` (number)

  - `metadata.proxyDetection.frequent_abuser` (boolean)

  - `metadata.proxyDetection.high_risk_attacks` (boolean)

  - `metadata.proxyDetection.shared_connection` (boolean)

  - `metadata.proxyDetection.dynamic_connection` (boolean)

  - `metadata.proxyDetection.security_scanner` (boolean)

  - `metadata.proxyDetection.trusted_network` (boolean)

  - `metadata.proxyDetection.request_id` (string)

  - `metadata.proxyDetection.operating_system` (string)

  - `metadata.proxyDetection.browser` (string)

  - `metadata.proxyDetection.device_brand` (string)

  - `metadata.proxyDetection.device_model` (string)

  - `metadata.proxyDetection.success` (boolean)

  - `metadata.proxyDetection.message` (string)

  - `metadata.proxyDetection.errors` (array)

  - `metadata.emailValidation` (object)

  - `metadata.emailValidation.valid` (boolean)

  - `metadata.emailValidation.disposable` (boolean)

  - `metadata.emailValidation.timed_out` (boolean)

  - `metadata.emailValidation.deliverability` (string)

  - `metadata.emailValidation.catch_all` (boolean)

  - `metadata.emailValidation.leaked` (boolean)

  - `metadata.emailValidation.suspect` (boolean)

  - `metadata.emailValidation.smtp_score` (integer)

  - `metadata.emailValidation.overall_score` (integer)

  - `metadata.emailValidation.first_name` (string)

  - `metadata.emailValidation.common` (boolean)

  - `metadata.emailValidation.generic` (boolean)

  - `metadata.emailValidation.dns_valid` (boolean)

  - `metadata.emailValidation.honeypot` (boolean)

  - `metadata.emailValidation.spam_trap_score` (string)

  - `metadata.emailValidation.frequent_complainer` (boolean)

  - `metadata.emailValidation.suggested_domain` (string)

  - `metadata.emailValidation.domain_velocity` (string)

  - `metadata.emailValidation.domain_trust` (string)

  - `metadata.emailValidation.user_activity` (string)

  - `metadata.emailValidation.mx_records` (array)

  - `metadata.emailValidation.a_records` (array)

  - `metadata.emailValidation.risky_tld` (boolean)

  - `metadata.emailValidation.spf_record` (boolean)

  - `metadata.emailValidation.dmarc_record` (boolean)

  - `metadata.emailValidation.first_seen` (object)

  - `metadata.emailValidation.first_seen.human` (string)

  - `metadata.emailValidation.first_seen.timestamp` (integer)

  - `metadata.emailValidation.first_seen.iso` (string)

  - `metadata.emailValidation.domain_age` (object)

  - `metadata.emailValidation.sanitized_email` (string)

  - `metadata.phoneValidation` (object)

  - `metadata.phoneValidation.active` (boolean)

  - `metadata.phoneValidation.formatted` (string)

  - `metadata.phoneValidation.local_format` (string)

  - `metadata.phoneValidation.VOIP` (boolean)

  - `metadata.phoneValidation.prepaid` (boolean)

  - `metadata.phoneValidation.risky` (boolean)

  - `metadata.phoneValidation.name` (string)

  - `metadata.phoneValidation.carrier` (string)

  - `metadata.phoneValidation.line_type` (string)

  - `metadata.phoneValidation.accurate_country_code` (boolean)

  - `metadata.phoneValidation.dialing_code` (integer)

  - `metadata.phoneValidation.do_not_call` (boolean)

  - `metadata.phoneValidation.spammer` (boolean)

  - `metadata.phoneValidation.active_status` (string)

  - `metadata.phoneValidation.mcc` (string)

  - `metadata.phoneValidation.mnc` (string)

  - `transactionType` (string)
    Transaction type
    Enum: "CARD", "BANK", "WALLET", "CASH", "CRYPTO", "OTHER"

  - `additionalData` (object)
    User provided additional data for Alternative Payment Methods

  - `pspAdditionalData` (object)
    Additional data obtained from Payment Service Provider during transaction processing

  - `createdAt` (string, required)
    Transaction creation time in UTC

  - `updatedAt` (string, required)
    Transaction last update time in UTC

## Response 400 fields (application/json):

  - `errorKey` (string)

  - `errorMessage` (string)

  - `errorCode` (integer)

## Response 401 fields (application/json):

  - `errorKey` (string)

  - `errorMessage` (string)

  - `errorCode` (integer)

## Response 403 fields (application/json):

  - `errorKey` (string)

  - `errorMessage` (string)

  - `errorCode` (integer)

## Response 404 fields (application/json):

  - `errorKey` (string)

  - `errorMessage` (string)

  - `errorCode` (integer)

## Response 409 fields (application/json):

  - `errorKey` (string)

  - `errorMessage` (string)

  - `errorCode` (integer)

## Response 500 fields (application/json):

  - `errorKey` (string)

  - `errorMessage` (string)

  - `errorCode` (integer)