--- title: "List all PaymentAttempts" method: GET path: "/v2/payment/payment_attempts" tags: ["Payment Attempts"] --- # List all PaymentAttempts `GET /v2/payment/payment_attempts` Retrieve a list of payment attempts with optional filtering ## Query parameters - `page_size` integer, required - `page_number` integer, required - `payment_intent_id` string - `attempt_status` 'INITIATED' | 'AUTHENTICATION_REDIRECTED' | 'PENDING_AUTHORIZATION' | 'AUTHORIZED' | 'CAPTURE_REQUESTED' | 'SETTLED' | 'SUCCEEDED' | 'CANCELLED' | 'EXPIRED' | 'FAILED' ## Headers - `x-client-id` string, required ## Response `200` List of payment attempts retrieved successfully - object - `total_pages` integer — The total pages of available items. - `total_items` integer — The total counts of available items. - `data` PaymentAttemptResponse[] - `attempt_id` string, required — Unique identifier for the attempt. - `amount` string, required - `currency` string, required — Three-letter currency code - `captured_amount` string - `refunded_amount` string - `create_time` string, date/time - `update_time` string, date/time - `complete_time` string, date/time - `cancellation_reason` string — Reason for canceling this PaymentIntent. - `auth_code` string — Authorization code returned by the issuer upon successful authorization. - `arn` string — Acquirer Reference Number (ARN). A 23-digit identifier used for cross-institution reconciliation and chargeback tracking. - `rrn` string — Retrieval Reference Number (RRN). A 12-digit identifier used for transaction lookup and customer service queries. - `advice_code` '01' | '02' | '03' | '21' | '85' — Issuer advice code indicating the recommended action after a decline. Helps merchants implement intelligent retry strategies. - `01`: New attempt may succeed. Retry recommended. - `02`: Do not retry. Try a different payment method. - `03`: Do not retry. Cardholder should contact their issuer. - `21`: Cancel all pending authorizations. Card may be compromised. - `85`: Do not retry. Issuer will not approve this transaction type. - `authentication_data` object — Authentication and verification data for this payment attempt. - `cvv_result` 'M' | 'N' | 'P' | 'U' — CVV/CVC verification result returned by the issuer. - `M`: Match. - `N`: No match. - `P`: Not processed. - `U`: Unsupported. - `avs_result` string — Address Verification System (AVS) result. Indicates whether the billing address provided matches the issuer's records. - `three_ds` CardThreeDSResponse - `three_ds_version` string — The 3D Secure protocol version used for authentication. - `eci` string — Electronic Commerce Indicator. A two-digit code indicating the security level of the transaction and the liability shift outcome. - `cavv` string — Cardholder Authentication Verification Value. A cryptographic value generated by the issuer's Access Control Server confirming successful authentication. - `three_ds_authentication_status` 'Y' | 'A' | 'N' | 'U' | 'R' | 'C' — The result of the 3DS authentication. - `Y`: Authentication successful. - `A`: Authentication attempted. Liability shift is granted but full authentication was not completed. - `N`: Authentication failed or denied. - `U`: Authentication could not be performed due to technical or other issues. - `R`: Authentication rejected by the issuer. - `C`: Challenge required. Additional verification steps are needed. - `three_ds_cancellation_reason` string — The reason the 3DS authentication flow was cancelled, if applicable. - `payment_method` union — The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set. - object - `type` 'card', required - `card` object, required - `card_name` string, required — Card holder name. Maximum length is 128. - `card_number` string, required — Masked card number. First 6 digits (BIN) and last 4 digits are visible. - `network` 'visa' | 'mastercard' | 'unionpay', required — The card network. Examples include `visa`, `mastercard`, `unionpay`. - `brand` string — The card brand. - `bin` string — Bank Identification Number. The first 6–8 digits of the card number identifying the issuing institution. - `last4` string — The last four digits of the card number. - `card_type` 'credit' | 'debit' | 'prepaid' — The card funding type. - `expiry_month` string — Two-digit expiry month of the card. - `expiry_year` string — Four-digit expiry year of the card. - `billing` CardBilling — Billing information of the customer. - `first_name` string, required — First name of the customer. Maximum length is 128. - `last_name` string, required — Last name of the customer. Maximum length is 128. - `email` string, email, required — Email address of the customer. - `phone_number` string — Phone number of the customer. - `address` Address, required - … - `auto_capture` boolean — Specifies whether the funds should be requested automatically after the payment is authorized. Default to `true`. Set it to `false` if you want to capture the funds sometimes later. - `authorization_type` 'authorization' | 'pre_authorization', required — The authorization type for the card payment. Options are `authorization` (default) and `pre_authorization`. Use `pre_authorization` to hold funds for more than 7 days, available only for Visa and Mastercard. `auto_capture` must be `false` for pre-authorization. - object - `type` 'applepay', required - `applepay` object, required — Apple Pay payment information returned in the response. - `flow` 'redirect' | 'mobile_web' | 'mobile_app' | 'contactless' — The checkout flow used for this payment. - `os_type` 'ios' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - `network` 'visa' | 'mastercard' | 'amex' | 'discover' | 'jcb' - `card_type` 'debit' | 'credit' — The type of card used (e.g., credit, debit). - `token_type` 'decrypted' | 'encrypted' - `auth_method` 'cryptogram_3ds' | 'pan_only' - object - `type` 'googlepay', required - `googlepay` object, required — Google Pay payment information returned in the response. - `flow` 'redirect' | 'mobile_web' | 'mobile_app' | 'contactless' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - `network` 'visa' | 'mastercard' | 'amex' | 'discover' | 'jcb' - `card_type` 'debit' | 'credit' — The type of card used (e.g., credit, debit). - `token_type` 'decrypted' | 'encrypted' - `auth_method` 'cryptogram_3ds' | 'pan_only' - object - `type` 'alipaycn', required - `alipaycn` object, required — AlipayCN payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'alipayhk', required - `alipayhk` object, required — AlipayHK payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'unionpay', required - `unionpay` object, required — UnionPay payment information returned in the response. - `flow` 'qrcode' | 'securepay' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'wechatpay', required - `wechatpay` object, required — WeChat Pay payment information returned in the response. - `flow` 'qrcode' | 'mini_program' | 'mobile_app' | 'mobile_web' | 'official_account' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'grabpay', required - `grabpay` object, required — GrabPay payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - `shopper_name` string — The name of the shopper. - object - `type` 'crypto', required - `crypto` object, required — Cryptocurrency payment information returned in the response. - `flow` 'redirect' | 'qrcode' — The checkout flow used for this payment. - `network` 'ETH' | 'TRON' - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'paynow', required - `paynow` object, required — PayNow payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'truemoney', required - `truemoney` object, required — Truemoney payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'tng', required - `tng` object, required — Touch'n Go payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'gcash', required - `gcash` object, required — GCash payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'dana', required - `dana` object, required — Dana payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'kakaopay', required - `kakaopay` object, required — KakaoPay payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'toss', required - `toss` object, required — Toss Pay payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - object - `type` 'naverpay', required - `naverpay` object, required — Naver Pay payment information returned in the response. - `flow` 'qrcode' — The checkout flow used for this payment. - `os_type` 'ios' | 'android' — The operating system type of the customer device. - `is_present` boolean — Whether this is an in-person (offline) payment. - `failure_code` string — PaymentAttempt failure code. Possible values are defined in [Error Code Reference.payment_error](/global-acquiring/v1.6/guide/error-codes) section. - `attempt_status` 'INITIATED' | 'AUTHENTICATION_REDIRECTED' | 'PENDING_AUTHORIZATION' | 'AUTHORIZED' | 'CAPTURE_REQUESTED' | 'SETTLED' | 'SUCCEEDED' | 'CANCELLED' | 'EXPIRED' | 'FAILED' — The status of the attempt. - `INITIATED`: The payment attempt has been created based on the initial request. - `AUTHENTICATION_REDIRECTED`: Waiting for the customer to complete identity verification, such as 3D Secure or QR code scanning. - `PENDING_AUTHORIZATION`: The authorization request has been received and is pending a final decision from the payment provider. - `AUTHORIZED`: The authorization has been successfully completed. Payment will be captured automatically or manually depending on configuration. - `CAPTURE_REQUESTED`: The capture request has been submitted successfully, and the payment is considered complete. - `SETTLED`: Funds have been settled from the payment provider and received by UQPAY. - `SUCCEEDED`: UQPAY has settled funds to your wallet. - `CANCELLED`: The payment attempt has been cancelled. Any authorized funds, if applicable, will be returned to the customer. - `EXPIRED`: The payment attempt was not completed within the allowed time window and has expired. - `FAILED`: The payment attempt has failed. Please create a new PaymentAttempt to retry. --- [API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)