--- title: "Resolve a payment attempt" method: POST path: "/payment-attempts/{id}/resolve" tags: ["Payment Attempts API"] --- # Resolve a payment attempt `POST /payment-attempts/{id}/resolve` ## Request - Base URL: `https://api.sandbox.primer.io` - URL: `https://api.sandbox.primer.io/payment-attempts/{id}/resolve` - Auth: API key in header `X-API-KEY` Resolve a payment attempt that succeeded or failed outside of Primer. No payment is created, and the tokenised payment instrument associated with the attempt is invalidated so it cannot be reused. Call this endpoint when you have processed the payment yourself (e.g. via a different PSP) and want to record the outcome against the attempt. Set \`vaultPaymentMethod\` to vault the card used for the attempt instead of invalidating it. This requires \`outcome\` to be \`SUCCEEDED\`. ## Path parameters - `id` string, uuid, required ## Headers - `X-API-VERSION` string, required ## Request body - ResolvePaymentAttemptRequest - `outcome` 'SUCCEEDED' | 'FAILED', required: The outcome of the payment attempt, as processed outside of Primer. - `vaultPaymentMethod` boolean: Vault the card used for the attempt instead of invalidating it. Requires `outcome` to be `SUCCEEDED` to be set. ## Response `200` Successful Response - ResolvePaymentAttemptResponse - `paymentAttemptId` string, uuid, required: ID of the payment attempt the outcome was reported for. - `vaultedPaymentMethod` MerchantPaymentMethodTokenAPIResponse - `createdAt` string, date-time, required: Creation date & time of the object (UTC) - `deletedAt` string, date-time: Date & time when this object was revoked. (UTC) - `deleted` boolean: Whether or not this object has been revoked. - `token` string, required: The vaulted payment method token. - `tokenType` string, required: * `MULTI_USE` a vaulted token that can be re-used with subsequent payments - `analyticsId` string, required: Unique analytics identifier corresponding to a payment method - `paymentMethodType` 'PAYMENT_CARD' | 'GOOGLE_PAY' | 'APPLE_PAY' | 'PAYPAL' | 'BANK_ACCOUNT' | 'KLARNA' | 'APAYA' | 'OPENNODE' | 'HOOLAH' | 'ATOME' | 'COINBASE' | 'NETS' | 'TWOC2P' | 'CLEARPAY' | 'SHOPEEPAY' | 'TRIPLE_A' | 'AFTERPAY' | 'NOL_PAY' | 'FINTECTURE_IMMEDIATE_TRANSFER' | 'FINTECTURE_SMART_TRANSFER' | 'ALMA' | 'CETELEM_BNPP_FINANCING' | 'PAY_NL_IDEAL' | 'PAY_NL_BANCONTACT' | 'PAY_NL_DIRECT_DEBIT' | 'PAY_NL_SOFORT_BANKING' | 'PAY_NL_PAYPAL' | 'PAY_NL_PAYCONIQ' | 'PAY_NL_GIROPAY' | 'PAY_NL_P24' | 'PAY_NL_EPS' | 'PAY_NL_KAARTDIRECT' | 'PAY_NL_RIVERTY' | 'ADYEN_SOFORT' | 'ADYEN_TWINT' | 'ADYEN_GIROPAY' | 'ADYEN_TRUSTLY' | 'ADYEN_ALIPAY' | 'ADYEN_MOBILEPAY' | 'ADYEN_MULTIBANCO' | 'ADYEN_VIPPS' | 'ADYEN_DOTPAY' | 'ADYEN_IDEAL' | 'ADYEN_BLIK' | 'ADYEN_PAYTRAIL' | 'ADYEN_INTERAC' | 'ADYEN_PAYSHOP' | 'ADYEN_MBWAY' | 'ADYEN_AFFIRM' | 'ADYEN_KLARNA' | 'ADYEN_BANCONTACT_PAYCONIQ' | 'ADYEN_EPS' | 'ADYEN_BANCONTACT_CARD' | 'ADYEN_SWISH' | 'ADYEN_CASHAPP' | 'ADYEN_ALIPAY_PLUS' | 'ADYEN_KAKAOPAY' | 'ADYEN_PAYPAY' | 'MOLLIE_IDEAL' | 'MOLLIE_BANCONTACT' | 'MOLLIE_P24' | 'MOLLIE_GIROPAY' | 'MOLLIE_EPS' | 'MOLLIE_GIFTCARD' | 'MOLLIE_SOFORT' | 'NETAXEPT_PAYTRAIL' | 'BUCKAROO_IDEAL' | 'BUCKAROO_BANCONTACT' | 'BUCKAROO_SOFORT' | 'BUCKAROO_GIROPAY' | 'BUCKAROO_EPS' | 'RAPYD_GCASH' | 'RAPYD_PROMPTPAY' | 'RAPYD_GRABPAY' | 'RAPYD_POLI' | 'RAPYD_FAST' | 'XFERS_PAYNOW' | 'STRIPE_ACH' | 'STRIPE_GIROPAY' | 'STRIPE_IDEAL' | 'STRIPE_ALIPAY' | 'STRIPE_KLARNA' | 'STRIPE_WECHAT' | 'STRIPE_KAKAOPAY' | 'STRIPE_GRABPAY' | 'STRIPE_CASHAPP' | 'STRIPE_SEPA' | 'STRIPE_PIX' | 'ALIPAY_CN' | 'CHAI_KAKAOPAY' | 'CHAI_NAVER' | 'CHAI_TOSS' | 'XENDIT_DANA' | 'XENDIT_OVO' | 'XENDIT_SHOPEEPAY' | 'XENDIT_RETAIL_OUTLETS' | 'OMISE_PROMPTPAY' | 'OMISE_TRUEMONEY' | 'DLOCAL_PIX' | 'DLOCAL_PIX_AUTOMATICO' | 'EBANX_PAGOFACIL' | 'PACYPAY_WECHAT' | 'PACYPAY_ALIPAY' | 'PACYPAY_ALIPAY_PLUS' | 'WORLDPAY_IDEAL' | 'IPAY88_CARD' | 'INGENICO_PAYPAL' | 'VOLT_PIX' | 'VOLT_BANK_TRANSFER' | 'BRAINTREE_VENMO' | 'THUNES_SPIRIT_OF_CADEAU' | 'THUNES_ILLICADO' | 'THUNES_CARTE_CADEAU_CONFORAMA' | 'THUNES_CHEQUE_FIDELITE_CONFORAMA' | 'SIPS_CPAY' | 'SIPS_CPAYCONFORAMA' | 'MONEXT_CETELEM' | 'MONEXT_CPAY' | 'DLOCAL_BANK_TRANSFER' | 'DLOCAL_OXXO' | 'DLOCAL_NUPAY' | 'DLOCAL_WECHAT' | 'DLOCAL_BOLETO' | 'DLOCAL_MERCADO_PAGO' | 'DLOCAL_PICPAY' | 'DLOCAL_TAMARA' | 'DLOCAL_MOBICRED' | 'DLOCAL_SPEI' | 'DLOCAL_KUESKI' | 'CHECKOUT_ALMA' | 'CHECKOUT_IDEAL' | 'CHECKOUT_TWINT' | 'CHECKOUT_WECHAT' | 'CHECKOUT_SWISH' | 'CHECKOUT_KNET' | 'CHECKOUT_OCTOPUS' | 'CHECKOUT_EPS' | 'CHECKOUT_P24' | 'CHECKOUT_KAKAOPAY' | 'CHECKOUT_BANCONTACT' | 'CHECKOUT_BENEFIT' | 'CHECKOUT_MULTIBANCO' | 'CHECKOUT_PAYNOW' | 'CHECKOUT_VIPPS' | 'CHECKOUT_OMANNET' | 'CHECKOUT_MBWAY' | 'CHECKOUT_MOBILEPAY' | 'CHECKOUT_PINLESS_DEBIT' | 'CHECKOUT_ACH' | 'CHECKOUT_SEPA' | 'CHECKOUT_VENMO' | 'CHECKOUT_STC_PAY' | 'CHECKOUT_QPAY' | 'CHECKOUT_BIZUM' | 'CHECKOUT_PAYPAL' | 'CHECKOUT_KLARNA' | 'CHECKOUT_ALIPAY_CN' | 'CHECKOUT_ALIPAY_HK' | 'CHECKOUT_TAMARA' | 'CHECKOUT_TNG' | 'CHECKOUT_TRUEMONEY' | 'CHECKOUT_DANA' | 'CHECKOUT_GCASH' | 'CHECKOUT_SEQURA' | 'CHECKOUT_TABBY' | 'AIRWALLEX_CASHAPP' | 'AIRWALLEX_WERO' | 'AIRWALLEX_IDEAL' | 'AIRWALLEX_WECHAT' | 'AIRWALLEX_BANK_TRANSFER' | 'AIRWALLEX_BLIK' | 'AIRWALLEX_DANA' | 'AIRWALLEX_GRABPAY' | 'AIRWALLEX_GCASH' | 'AIRWALLEX_KAKAOPAY' | 'AIRWALLEX_KLARNA' | 'AIRWALLEX_OCTOPUS' | 'AIRWALLEX_PAYSAFECARD' | 'AIRWALLEX_PAYSAFECASH' | 'AIRWALLEX_P24' | 'AIRWALLEX_PROMPTPAY' | 'AIRWALLEX_SEPA' | 'AIRWALLEX_SKRILL' | 'AIRWALLEX_TABBY' | 'AIRWALLEX_TWINT' | 'NUVEI_ALIPAY' | 'NUVEI_BANCOMAT' | 'NUVEI_BANK_TRANSFER' | 'NUVEI_BIZUM' | 'NUVEI_BLIK' | 'NUVEI_CASHAPP' | 'NUVEI_DANA' | 'NUVEI_EPS' | 'NUVEI_GCASH' | 'NUVEI_GRABPAY' | 'NUVEI_IDEAL' | 'NUVEI_KAKAOPAY' | 'NUVEI_KLARNA' | 'NUVEI_MBWAY' | 'NUVEI_MERCADO_PAGO' | 'NUVEI_MOBILEPAY' | 'NUVEI_MULTIBANCO' | 'NUVEI_MYBANK' | 'NUVEI_NPP' | 'NUVEI_OXXO' | 'NUVEI_P24' | 'NUVEI_PAYNOW' | 'NUVEI_PAYSAFECARD' | 'NUVEI_PICPAY' | 'NUVEI_PROMPTPAY' | 'NUVEI_RIVERTY' | 'NUVEI_SHOPEEPAY' | 'NUVEI_SKRILL' | 'NUVEI_SWISH' | 'NUVEI_TRUSTLY' | 'NUVEI_TWINT' | 'NUVEI_VENMO' | 'NUVEI_WECHAT' | 'SCALAPAY' | 'HITPAY' | 'HITPAY_SHOPEEPAY' | 'HITPAY_WECHAT' | 'HITPAY_GRABPAY' | 'HITPAY_ATOME' | 'PAYSAFE_PAYSAFECARD' | 'PAYSAFE_PAYSAFECASH' | 'PAYSAFE_NETELLER' | 'PAYSAFE_SKRILL' | 'PAYSAFE_VENMO' | 'PAYSAFE_BANK_TRANSFER' | 'FLOA_PAY' | 'ONEPOINT6_BANCONTACT' | 'ONEPOINT6_IDEAL' | 'ONEPOINT6_ANCV' | 'ONEPOINT6_FLOA_PAY' | 'ONEPOINT6_AMEX' | 'ONEPOINT6_WERO' | 'ONEPOINT6_PAYPAL' | 'ONEPOINT6_WECHAT' | 'ONEPOINT6_MULTIBANCO' | 'ONEPOINT6_BANCOMAT' | 'ONEPOINT6_KLARNA' | 'ONEPOINT6_SWISH' | 'ONEPOINT6_SDD' | 'ONEPOINT6_SCT' | 'ONEPOINT6_JCB' | 'ONEPOINT6_CUP' | 'NOMUPAY_GCASH' | 'NOMUPAY_GRABPAY' | 'NOMUPAY_BLIK' | 'NOMUPAY_P24' | 'NOMUPAY_SWISH' | 'NOMUPAY_SHOPEEPAY' | 'NOMUPAY_TRUSTLY' | 'NOMUPAY_TWINT' | 'NOMUPAY_WECHAT' | 'NOMUPAY_WERO' | 'NOMUPAY_ALIPAY' | 'NOMUPAY_ALIPAY_PLUS' | 'PAYABL_BANCONTACT' | 'PAYABL_BLIK' | 'PAYABL_BOLETO' | 'PAYABL_IDEAL' | 'PAYABL_MULTIBANCO' | 'PAYABL_OXXO' | 'PAYABL_P24' | 'PAYABL_PAYSAFECARD' | 'PAYABL_PIX' | 'PAYABL_SEPA' | 'PAYABL_SPEI' | 'PAYABL_TRUSTLY' | 'PAYABL_TWINT' | 'PAYABL_WERO' | 'REVOLUT_PAY_BY_BANK' | 'REVOLUT_PAY' | 'PRIMER_TEST_APPLE_PAY' | 'PRIMER_TEST_GOOGLE_PAY' | 'PRIMER_TEST_SOFORT' | 'PRIMER_TEST_KLARNA' | 'PRIMER_TEST_PAYPAL', required: The type of payment method used for the payment, for example `PAYMENT_CARD`, `PAYPAL` or `KLARNA`. This list reflects the values returned by the API and may differ from the [available payment methods](https://primer.io/docs/connections/payment-methods/available-payment-methods) page. For the type of payment instrument, such as `OFF_SESSION_PAYMENT` or `CARD_OFF_SESSION_PAYMENT`, see `PaymentInstrumentTypeEnum`. - `paymentMethodData` union, required: Payment method data - PaymentCardTokenAPISchema - `first6Digits` string - `firstDigits` string: The first 6 or 8 digits of the card number, depending on the card number length. - `last4Digits` string, required - `expirationMonth` string, required - `expirationYear` string, required - `cardholderName` string - `network` string - `isNetworkTokenized` boolean - `binData` BinDataAPISchema - `network` 'AMEX' | 'DANKORT' | 'DINERS_CLUB' | 'DISCOVER' | 'EFTPOS' | 'ENROUTE' | 'ELO' | 'HIPER' | 'INTERAC' | 'JCB' | 'MAESTRO' | 'MASTERCARD' | 'MIR' | 'PRIVATE_LABEL' | 'UNIONPAY' | 'VISA' | 'CARTES_BANCAIRES' | 'OTHER', required: The list of available card networks. - `issuerCountryCode` 'AW' | 'AF' | 'AO' | 'AI' | 'AX' | 'AL' | 'AD' | 'AE' | 'AR' | 'AM' | 'AS' | 'AQ' | 'TF' | 'AG' | 'AU' | 'AT' | 'AZ' | 'BI' | 'BE' | 'BJ' | 'BQ' | 'BF' | 'BD' | 'BG' | 'BH' | 'BS' | 'BA' | 'BL' | 'BY' | 'BZ' | 'BM' | 'BO' | 'BR' | 'BB' | 'BN' | 'BT' | 'BV' | 'BW' | 'CF' | 'CA' | 'CC' | 'CH' | 'CL' | 'CN' | 'CI' | 'CM' | 'CD' | 'CG' | 'CK' | 'CO' | 'KM' | 'CV' | 'CR' | 'CU' | 'CW' | 'CX' | 'KY' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DM' | 'DK' | 'DO' | 'DZ' | 'EC' | 'EG' | 'ER' | 'EH' | 'ES' | 'EE' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FR' | 'FO' | 'FM' | 'GA' | 'GB' | 'GE' | 'GG' | 'GH' | 'GI' | 'GN' | 'GP' | 'GM' | 'GW' | 'GQ' | 'GR' | 'GD' | 'GL' | 'GT' | 'GF' | 'GU' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IM' | 'IN' | 'IO' | 'IE' | 'IR' | 'IQ' | 'IS' | 'IL' | 'IT' | 'JM' | 'JE' | 'JO' | 'JP' | 'KZ' | 'KE' | 'KG' | 'KH' | 'KI' | 'KN' | 'KR' | 'KW' | 'LA' | 'LB' | 'LR' | 'LY' | 'LC' | 'LI' | 'LK' | 'LS' | 'LT' | 'LU' | 'LV' | 'MO' | 'MF' | 'MA' | 'MC' | 'MD' | 'MG' | 'MV' | 'MX' | 'MH' | 'MK' | 'ML' | 'MT' | 'MM' | 'ME' | 'MN' | 'MP' | 'MZ' | 'MR' | 'MS' | 'MQ' | 'MU' | 'MW' | 'MY' | 'YT' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NU' | 'NL' | 'NO' | 'NP' | 'NR' | 'NZ' | 'OM' | 'PK' | 'PA' | 'PN' | 'PE' | 'PH' | 'PW' | 'PG' | 'PL' | 'PR' | 'KP' | 'PT' | 'PY' | 'PS' | 'PF' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SA' | 'SD' | 'SN' | 'SG' | 'GS' | 'SH' | 'SJ' | 'SB' | 'SL' | 'SV' | 'SM' | 'SO' | 'PM' | 'RS' | 'SS' | 'ST' | 'SR' | 'SK' | 'SI' | 'SE' | 'SZ' | 'SX' | 'SC' | 'SY' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TM' | 'TL' | 'TO' | 'TT' | 'TN' | 'TR' | 'TV' | 'TW' | 'TZ' | 'UG' | 'UA' | 'UM' | 'UY' | 'US' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'ZA' | 'ZM' | 'ZW': 2-letter country code in ISO 3166-1 alpha format, e.g. FR for France and GB for the United Kingdom. - `issuerName` string - `issuerCurrencyCode` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BOV' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYR' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CHW' | 'CLP' | 'CNY' | 'COP' | 'COU' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VED' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XCG' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWG' | 'ZWL': 3-letter currency code in ISO 4217 format, e.g. USD for US dollars. The following currencies have been retired and will return a deprecation error on new payment or session creation requests: BGN, ZWL, ANG - `regionalRestriction` 'DOMESTIC_USE_ONLY' | 'NONE' | 'UNKNOWN', required: An enumeration. - `accountNumberType` 'PRIMARY_ACCOUNT_NUMBER' | 'NETWORK_TOKEN' | 'DIGITAL_PAN' | 'UNKNOWN', required: An enumeration. - `accountFundingType` 'CREDIT' | 'DEBIT' | 'PREPAID' | 'CHARGE' | 'DEFERRED_DEBIT' | 'UNKNOWN', required: An enumeration. - `prepaidReloadableIndicator` 'RELOADABLE' | 'NON_RELOADABLE' | 'NOT_APPLICABLE' | 'UNKNOWN', required: An enumeration. - `productUsageType` 'CONSUMER' | 'BUSINESS' | 'GOVERNMENT' | 'UNKNOWN', required: An enumeration. - `productCode` string, required - `productName` string, required - PayPalBillingAgreementAPISchema - `paypalBillingAgreementId` string, required - `externalPayerInfo` PayPalExternalPayerInfoAPISchema - `externalPayerId` string - `email` string - `firstName` string - `lastName` string - `shippingAddress` AddressAPISchema - `firstName` string - `lastName` string - `addressLine1` string, required: Street name, Company name or PO Box - `addressLine2` string: Apartment, Unit or Building number - `city` string, required: Name of the city, district, town or village - `state` string: State, County or Province - `countryCode` 'AW' | 'AF' | 'AO' | 'AI' | 'AX' | 'AL' | 'AD' | 'AE' | 'AR' | 'AM' | 'AS' | 'AQ' | 'TF' | 'AG' | 'AU' | 'AT' | 'AZ' | 'BI' | 'BE' | 'BJ' | 'BQ' | 'BF' | 'BD' | 'BG' | 'BH' | 'BS' | 'BA' | 'BL' | 'BY' | 'BZ' | 'BM' | 'BO' | 'BR' | 'BB' | 'BN' | 'BT' | 'BV' | 'BW' | 'CF' | 'CA' | 'CC' | 'CH' | 'CL' | 'CN' | 'CI' | 'CM' | 'CD' | 'CG' | 'CK' | 'CO' | 'KM' | 'CV' | 'CR' | 'CU' | 'CW' | 'CX' | 'KY' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DM' | 'DK' | 'DO' | 'DZ' | 'EC' | 'EG' | 'ER' | 'EH' | 'ES' | 'EE' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FR' | 'FO' | 'FM' | 'GA' | 'GB' | 'GE' | 'GG' | 'GH' | 'GI' | 'GN' | 'GP' | 'GM' | 'GW' | 'GQ' | 'GR' | 'GD' | 'GL' | 'GT' | 'GF' | 'GU' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IM' | 'IN' | 'IO' | 'IE' | 'IR' | 'IQ' | 'IS' | 'IL' | 'IT' | 'JM' | 'JE' | 'JO' | 'JP' | 'KZ' | 'KE' | 'KG' | 'KH' | 'KI' | 'KN' | 'KR' | 'KW' | 'LA' | 'LB' | 'LR' | 'LY' | 'LC' | 'LI' | 'LK' | 'LS' | 'LT' | 'LU' | 'LV' | 'MO' | 'MF' | 'MA' | 'MC' | 'MD' | 'MG' | 'MV' | 'MX' | 'MH' | 'MK' | 'ML' | 'MT' | 'MM' | 'ME' | 'MN' | 'MP' | 'MZ' | 'MR' | 'MS' | 'MQ' | 'MU' | 'MW' | 'MY' | 'YT' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NU' | 'NL' | 'NO' | 'NP' | 'NR' | 'NZ' | 'OM' | 'PK' | 'PA' | 'PN' | 'PE' | 'PH' | 'PW' | 'PG' | 'PL' | 'PR' | 'KP' | 'PT' | 'PY' | 'PS' | 'PF' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SA' | 'SD' | 'SN' | 'SG' | 'GS' | 'SH' | 'SJ' | 'SB' | 'SL' | 'SV' | 'SM' | 'SO' | 'PM' | 'RS' | 'SS' | 'ST' | 'SR' | 'SK' | 'SI' | 'SE' | 'SZ' | 'SX' | 'SC' | 'SY' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TM' | 'TL' | 'TO' | 'TT' | 'TN' | 'TR' | 'TV' | 'TW' | 'TZ' | 'UG' | 'UA' | 'UM' | 'UY' | 'US' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'ZA' | 'ZM' | 'ZW', required: 2-letter country code in ISO 3166-1 alpha format, e.g. FR for France and GB for the United Kingdom. - `postalCode` string: Postal or ZIP code - `paypalStatus` string - GoCardlessMandateAPISchema - `gocardlessMandateId` string, required: Unique identifier of a GoCardless mandate agreement - KlarnaCustomerTokenAPISchema - `klarnaCustomerToken` string, required - `sessionData` KlarnaSessionDetailsAPISchema, required - `recurringDescription` string - `billingAddress` KlarnaAddressAPISchema, required - `title` string - `firstName` string - `lastName` string - `email` string - `phoneNumber` string - `addressLine1` string - `addressLine2` string - `addressLine3` string - `city` string - `state` string - `countryCode` 'AW' | 'AF' | 'AO' | 'AI' | 'AX' | 'AL' | 'AD' | 'AE' | 'AR' | 'AM' | 'AS' | 'AQ' | 'TF' | 'AG' | 'AU' | 'AT' | 'AZ' | 'BI' | 'BE' | 'BJ' | 'BQ' | 'BF' | 'BD' | 'BG' | 'BH' | 'BS' | 'BA' | 'BL' | 'BY' | 'BZ' | 'BM' | 'BO' | 'BR' | 'BB' | 'BN' | 'BT' | 'BV' | 'BW' | 'CF' | 'CA' | 'CC' | 'CH' | 'CL' | 'CN' | 'CI' | 'CM' | 'CD' | 'CG' | 'CK' | 'CO' | 'KM' | 'CV' | 'CR' | 'CU' | 'CW' | 'CX' | 'KY' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DM' | 'DK' | 'DO' | 'DZ' | 'EC' | 'EG' | 'ER' | 'EH' | 'ES' | 'EE' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FR' | 'FO' | 'FM' | 'GA' | 'GB' | 'GE' | 'GG' | 'GH' | 'GI' | 'GN' | 'GP' | 'GM' | 'GW' | 'GQ' | 'GR' | 'GD' | 'GL' | 'GT' | 'GF' | 'GU' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IM' | 'IN' | 'IO' | 'IE' | 'IR' | 'IQ' | 'IS' | 'IL' | 'IT' | 'JM' | 'JE' | 'JO' | 'JP' | 'KZ' | 'KE' | 'KG' | 'KH' | 'KI' | 'KN' | 'KR' | 'KW' | 'LA' | 'LB' | 'LR' | 'LY' | 'LC' | 'LI' | 'LK' | 'LS' | 'LT' | 'LU' | 'LV' | 'MO' | 'MF' | 'MA' | 'MC' | 'MD' | 'MG' | 'MV' | 'MX' | 'MH' | 'MK' | 'ML' | 'MT' | 'MM' | 'ME' | 'MN' | 'MP' | 'MZ' | 'MR' | 'MS' | 'MQ' | 'MU' | 'MW' | 'MY' | 'YT' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NU' | 'NL' | 'NO' | 'NP' | 'NR' | 'NZ' | 'OM' | 'PK' | 'PA' | 'PN' | 'PE' | 'PH' | 'PW' | 'PG' | 'PL' | 'PR' | 'KP' | 'PT' | 'PY' | 'PS' | 'PF' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SA' | 'SD' | 'SN' | 'SG' | 'GS' | 'SH' | 'SJ' | 'SB' | 'SL' | 'SV' | 'SM' | 'SO' | 'PM' | 'RS' | 'SS' | 'ST' | 'SR' | 'SK' | 'SI' | 'SE' | 'SZ' | 'SX' | 'SC' | 'SY' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TM' | 'TL' | 'TO' | 'TT' | 'TN' | 'TR' | 'TV' | 'TW' | 'TZ' | 'UG' | 'UA' | 'UM' | 'UY' | 'US' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'ZA' | 'ZM' | 'ZW': 2-letter country code in ISO 3166-1 alpha format, e.g. FR for France and GB for the United Kingdom. - `postalCode` string - `shippingAddress` KlarnaAddressAPISchema - `title` string - `firstName` string - `lastName` string - `email` string - `phoneNumber` string - `addressLine1` string - `addressLine2` string - `addressLine3` string - `city` string - `state` string - `countryCode` 'AW' | 'AF' | 'AO' | 'AI' | 'AX' | 'AL' | 'AD' | 'AE' | 'AR' | 'AM' | 'AS' | 'AQ' | 'TF' | 'AG' | 'AU' | 'AT' | 'AZ' | 'BI' | 'BE' | 'BJ' | 'BQ' | 'BF' | 'BD' | 'BG' | 'BH' | 'BS' | 'BA' | 'BL' | 'BY' | 'BZ' | 'BM' | 'BO' | 'BR' | 'BB' | 'BN' | 'BT' | 'BV' | 'BW' | 'CF' | 'CA' | 'CC' | 'CH' | 'CL' | 'CN' | 'CI' | 'CM' | 'CD' | 'CG' | 'CK' | 'CO' | 'KM' | 'CV' | 'CR' | 'CU' | 'CW' | 'CX' | 'KY' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DM' | 'DK' | 'DO' | 'DZ' | 'EC' | 'EG' | 'ER' | 'EH' | 'ES' | 'EE' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FR' | 'FO' | 'FM' | 'GA' | 'GB' | 'GE' | 'GG' | 'GH' | 'GI' | 'GN' | 'GP' | 'GM' | 'GW' | 'GQ' | 'GR' | 'GD' | 'GL' | 'GT' | 'GF' | 'GU' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IM' | 'IN' | 'IO' | 'IE' | 'IR' | 'IQ' | 'IS' | 'IL' | 'IT' | 'JM' | 'JE' | 'JO' | 'JP' | 'KZ' | 'KE' | 'KG' | 'KH' | 'KI' | 'KN' | 'KR' | 'KW' | 'LA' | 'LB' | 'LR' | 'LY' | 'LC' | 'LI' | 'LK' | 'LS' | 'LT' | 'LU' | 'LV' | 'MO' | 'MF' | 'MA' | 'MC' | 'MD' | 'MG' | 'MV' | 'MX' | 'MH' | 'MK' | 'ML' | 'MT' | 'MM' | 'ME' | 'MN' | 'MP' | 'MZ' | 'MR' | 'MS' | 'MQ' | 'MU' | 'MW' | 'MY' | 'YT' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NU' | 'NL' | 'NO' | 'NP' | 'NR' | 'NZ' | 'OM' | 'PK' | 'PA' | 'PN' | 'PE' | 'PH' | 'PW' | 'PG' | 'PL' | 'PR' | 'KP' | 'PT' | 'PY' | 'PS' | 'PF' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SA' | 'SD' | 'SN' | 'SG' | 'GS' | 'SH' | 'SJ' | 'SB' | 'SL' | 'SV' | 'SM' | 'SO' | 'PM' | 'RS' | 'SS' | 'ST' | 'SR' | 'SK' | 'SI' | 'SE' | 'SZ' | 'SX' | 'SC' | 'SY' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TM' | 'TL' | 'TO' | 'TT' | 'TN' | 'TR' | 'TV' | 'TW' | 'TZ' | 'UG' | 'UA' | 'UM' | 'UY' | 'US' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'ZA' | 'ZM' | 'ZW': 2-letter country code in ISO 3166-1 alpha format, e.g. FR for France and GB for the United Kingdom. - `postalCode` string - `purchaseCountry` string, required - `purchaseCurrency` string, required - `locale` string, required - `orderLines` unknown[], required - unknown - `tokenDetails` KlarnaTokenDetails - `type` string, required - `brand` string - `masked_number` string - `expiry_date` string - ApayaCustomerTokenAPISchema - `mx` string, required - `mnc` integer - `mcc` integer - `customerId` string, required: The ID representing the customer - `description` string: A friendly description given by the user - `default` boolean, required: Whether or not this payment method is the default ## Other responses - `400`: Bad request - `404`: Payment attempt not found, or its client session belongs to another tenant - `409`: Payment attempt's outcome cannot be reported in its current state, or `vaultPaymentMethod` was true but the attempt cannot be vaulted - `410`: Payment attempt has expired - `422`: Request failed validation ## Changes - **2026-11-03** `75317247bfff`: 2 info - added the new optional request property `vaultPaymentMethod` - added the optional property `vaultedPaymentMethod` to the response with the `200` status - **2026-11-03** `a2f0e375036d`: 1 info - endpoint added [Operation history](https://skmtc.dev/primer/apis/primer-api/changes/payment-attempts/:id/resolve/post.md) --- [API](https://skmtc.dev/primer/apis/primer-api.md) - [All operations](https://skmtc.dev/primer/apis/primer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/primer/apis/primer-api/revisions/75317247bfff?raw)