Approve an authorization

Deprecated

POST /v1/issuing/authorizations/{authorization}/approve

Copy endpoint

https://api.stripe.com/

Parameters

path Path Parameters

Name	Type
`authorization` required	string

Request Body

application/x-www-form-urlencoded

{ amount?: number;expand?: string[];metadata?: { } | ""; }

Responses

200 application/json

Successful response.

interface IssuingAuthorization {
amount: number;
amount_details?:

IssuingAuthorizationAmountDetails

interface IssuingAuthorizationAmountDetails {
atm_fee?: number | null;
cashback_amount?: number | null;
}

BalanceTransaction

Balance transactions represent funds moving through your Stripe account. Stripe creates them for every type of transaction that enters or leaves your Stripe account balance.

Related guide: Balance transaction types

interface BalanceTransaction {
amount: number;
available_on: number;
balance_type?: "issuing" | "payments" | "refund_and_dispute_prefunding";
created: number;
currency: string;
description?: string | null;
exchange_rate?: number | null;
fee: number;
fee_details: Fee[];
id: string;
net: number;
object: "balance_transaction";
reporting_category: string;
source?: ApplicationFee | Charge | ConnectCollectionTransfer | CustomerCashBalanceTransaction | Dispute | FeeRefund | IssuingAuthorization | IssuingDispute | IssuingTransaction | Payout | Refund | ReserveTransaction | TaxDeductedAtSource | Topup | Transfer | TransferReversal | string | null;
status: string;
type: "adjustment" | "advance" | "advance_funding" | "anticipation_repayment" | "application_fee" | "application_fee_refund" | "charge" | "climate_order_purchase" | "climate_order_refund" | "connect_collection_transfer" | "contribution" | "issuing_authorization_hold" | "issuing_authorization_release" | "issuing_dispute" | "issuing_transaction" | "obligation_outbound" | "obligation_reversal_inbound" | "payment" | "payment_failure_refund" | "payment_network_reserve_hold" | "payment_network_reserve_release" | "payment_refund" | "payment_reversal" | "payment_unreconciled" | "payout" | "payout_cancel" | "payout_failure" | "payout_minimum_balance_hold" | "payout_minimum_balance_release" | "refund" | "refund_failure" | "reserve_transaction" | "reserved_funds" | "stripe_balance_payment_debit" | "stripe_balance_payment_debit_reversal" | "stripe_fee" | "stripe_fx_fee" | "tax_fee" | "topup" | "topup_reversal" | "transfer" | "transfer_cancel" | "transfer_failure" | "transfer_refund";
}

[];
card:

IssuingCard

You can create physical or virtual cards that are issued to cardholders.

interface IssuingCard {
brand: string;
cancellation_reason?: "design_rejected" | "lost" | "stolen" | null;
cardholder: IssuingCardholder;
created: number;
currency: string;
cvc?: string;
exp_month: number;
exp_year: number;
financial_account?: string | null;
id: string;
last4: string;
latest_fraud_warning?: IssuingCardFraudWarning | null;
livemode: boolean;
metadata: { };
number?: string;
object: "issuing.card";
personalization_design?: IssuingPersonalizationDesign | string | null;
replaced_by?: IssuingCard | string | null;
replacement_for?: IssuingCard | string | null;
replacement_reason?: "damaged" | "expired" | "lost" | "stolen" | null;
second_line?: string | null;
shipping?: IssuingCardShipping | null;
spending_controls: IssuingCardAuthorizationControls;
status: "active" | "canceled" | "inactive";
type: "physical" | "virtual";
wallets?: IssuingCardWallets | null;
}

;
cardholder?:

IssuingCardholder

An Issuing Cardholder object represents an individual or business entity who is issued cards.

Related guide: How to create a cardholder

interface IssuingCardholder {
billing: IssuingCardholderAddress;
company?: IssuingCardholderCompany | null;
created: number;
email?: string | null;
id: string;
individual?: IssuingCardholderIndividual | null;
livemode: boolean;
metadata: { };
name: string;
object: "issuing.cardholder";
phone_number?: string | null;
preferred_locales?: ("de" | "en" | "es" | "fr" | "it")[] | null;
requirements: IssuingCardholderRequirements;
spending_controls?: IssuingCardholderAuthorizationControls | null;
status: "active" | "blocked" | "inactive";
type: "company" | "individual";
}

| string | null;
created: number;
currency: string;
fleet?:

IssuingAuthorizationFleetData

interface IssuingAuthorizationFleetData {
cardholder_prompt_data?: IssuingAuthorizationFleetCardholderPromptData | null;
purchase_type?: "fuel_and_non_fuel_purchase" | "fuel_purchase" | "non_fuel_purchase" | null;
reported_breakdown?: IssuingAuthorizationFleetReportedBreakdown | null;
service_type?: "full_service" | "non_fuel_transaction" | "self_service" | null;
}

| null;
fraud_challenges?:

IssuingAuthorizationFraudChallenge

interface IssuingAuthorizationFraudChallenge {
channel: "sms";
status: "expired" | "pending" | "rejected" | "undeliverable" | "verified";
undeliverable_reason?: "no_phone_number" | "unsupported_phone_number" | null;
}

[] | null;
fuel?:

IssuingAuthorizationFuelData

interface IssuingAuthorizationFuelData {
industry_product_code?: string | null;
quantity_decimal?: string | null;
type?: "diesel" | "other" | "unleaded_plus" | "unleaded_regular" | "unleaded_super" | null;
unit?: "charging_minute" | "imperial_gallon" | "kilogram" | "kilowatt_hour" | "liter" | "other" | "pound" | "us_gallon" | null;
unit_cost_decimal?: string | null;
}

| null;
id: string;
livemode: boolean;
merchant_amount: number;
merchant_currency: string;
merchant_data:

IssuingAuthorizationMerchantData

interface IssuingAuthorizationMerchantData {
category: string;
category_code: string;
city?: string | null;
country?: string | null;
name?: string | null;
network_id: string;
postal_code?: string | null;
state?: string | null;
tax_id?: string | null;
terminal_id?: string | null;
url?: string | null;
}

;
metadata: { };
network_data?:

IssuingAuthorizationNetworkData

interface IssuingAuthorizationNetworkData {
acquiring_institution_id?: string | null;
system_trace_audit_number?: string | null;
transaction_id?: string | null;
}

| null;
object: "issuing.authorization";
pending_request?:

IssuingAuthorizationPendingRequest

interface IssuingAuthorizationPendingRequest {
amount: number;
amount_details?: IssuingAuthorizationAmountDetails | null;
currency: string;
is_amount_controllable: boolean;
merchant_amount: number;
merchant_currency: string;
network_risk_score?: number | null;
}

| null;
request_history:

IssuingAuthorizationRequest

interface IssuingAuthorizationRequest {
amount: number;
amount_details?: IssuingAuthorizationAmountDetails | null;
approved: boolean;
authorization_code?: string | null;
created: number;
currency: string;
merchant_amount: number;
merchant_currency: string;
network_risk_score?: number | null;
reason: "account_disabled" | "card_active" | "card_canceled" | "card_expired" | "card_inactive" | "cardholder_blocked" | "cardholder_inactive" | "cardholder_verification_required" | "insecure_authorization_method" | "insufficient_funds" | "network_fallback" | "not_allowed" | "pin_blocked" | "spending_controls" | "suspected_fraud" | "verification_failed" | "webhook_approved" | "webhook_declined" | "webhook_error" | "webhook_timeout";
reason_message?: string | null;
requested_at?: number | null;
}

[];
status: "closed" | "expired" | "pending" | "reversed";
token?:

IssuingToken

An issuing token object is created when an issued card is added to a digital wallet. As a card issuer, you can view and manage these tokens through Stripe.

interface IssuingToken {
card: IssuingCard | string;
created: number;
device_fingerprint?: string | null;
id: string;
last4?: string;
livemode: boolean;
network: "mastercard" | "visa";
network_data?: IssuingNetworkTokenNetworkData;
network_updated_at: number;
object: "issuing.token";
status: "active" | "deleted" | "requested" | "suspended";
wallet_provider?: "apple_pay" | "google_pay" | "samsung_pay";
}

| string | null;
transactions:

IssuingTransaction

Any use of an issued card that results in funds entering or leaving your Stripe account, such as a completed purchase or refund, is represented by an Issuing Transaction object.

Related guide: Issued card transactions

interface IssuingTransaction {
amount: number;
amount_details?: IssuingTransactionAmountDetails | null;
authorization?: IssuingAuthorization | string | null;
balance_transaction?: BalanceTransaction | string | null;
card: IssuingCard | string;
cardholder?: IssuingCardholder | string | null;
created: number;
currency: string;
dispute?: IssuingDispute | string | null;
id: string;
livemode: boolean;
merchant_amount: number;
merchant_currency: string;
merchant_data: IssuingAuthorizationMerchantData;
metadata: { };
network_data?: IssuingTransactionNetworkData | null;
object: "issuing.transaction";
purchase_details?: IssuingTransactionPurchaseDetails | null;
token?: IssuingToken | string | null;
treasury?: IssuingTransactionTreasury | null;
type: "capture" | "refund";
wallet?: "apple_pay" | "google_pay" | "samsung_pay" | null;
}

[];
treasury?:

IssuingAuthorizationTreasury

interface IssuingAuthorizationTreasury {
received_credits: string[];
received_debits: string[];
transaction?: string | null;
}

| null;
verification_data:

IssuingAuthorizationVerificationData

interface IssuingAuthorizationVerificationData {
address_line1_check: "match" | "mismatch" | "not_provided";
address_postal_code_check: "match" | "mismatch" | "not_provided";
authentication_exemption?: IssuingAuthorizationAuthenticationExemption | null;
cvc_check: "match" | "mismatch" | "not_provided";
expiry_check: "match" | "mismatch" | "not_provided";
postal_code?: string | null;
three_d_secure?: IssuingAuthorizationThreeDSecure | null;
}

;
verified_by_fraud_challenge?: boolean | null;
wallet?: string | null;
}

default application/json

Error response.

interface Error {
error:

ApiErrors

interface ApiErrors {
advice_code?: string;
charge?: string;
code?: string;
decline_code?: string;
doc_url?: string;
message?: string;
network_advice_code?: string;
network_decline_code?: string;
param?: string;
payment_intent?: PaymentIntent;
payment_method?: PaymentMethod;
payment_method_type?: string;
request_log_url?: string;
setup_intent?: SetupIntent;
source?: BankAccount | Card | Source;
type: "api_error" | "card_error" | "idempotency_error" | "invalid_request_error";
}

;
}