Create Processor Attempt | PaymentKit

curl -X POST https://app.paymentkit.com/api/account_id/payments/processor_attempts/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "payment_intent_id": "pi_3JH4x2L8v9X7YzQ1aB2cD3Ef",
  "amount_atom": 250000,
  "currency": "usd"
}'

{
  "id": "pa_5KJ9v3N7b8X2YzQ4cD5eF6Gh",
  "account_id": "acc_9LmN8OpQrStUvWxYz1234567",
  "payment_intent_id": "pi_3JH4x2L8v9X7YzQ1aB2cD3Ef",
  "payment_method_id": "pm_7GhJkLmN8OpQrStUvWxYz123",
  "processor_id": "proc_4FgHjKlMnOpQrStUvWxYz789",
  "processor_name": "Stripe",
  "customer_id": "cus_1AbCdEfGhIjKlMnOpQrStUvWx",
  "amount_atom": 250000,
  "provider_type_fee_amount_atom": 7500,
  "currency": "usd",
  "status": "succeeded",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "failure_code": "",
  "failure_message": "",
  "is_soft_decline": false,
  "processor_metadata": {},
  "captured_at": "2024-01-15T09:30:00Z",
  "metadata": {},
  "refunded_amount_atom": 0,
  "refunded": false
}

Create a processor attempt. Works for both User and API Key authentication. Account access is automatically validated via endpoint dependency.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

account_idstringRequired

Request

This endpoint expects an object.

payment_intent_idstringRequired

amount_atomintegerRequired

currencyenumRequired

ISO 4217 currency codes.

metadatamap from strings to any or nullOptional

Response

Successful Response

idstring

account_idstring

payment_intent_idstring

payment_method_idstring

processor_idstring

processor_namestring

customer_idstring

amount_atominteger

provider_type_fee_amount_atominteger

currencyenum

ISO 4217 currency codes.

statusstring

created_atdatetime

updated_atdatetime

failure_codestring or null

failure_messagestring or null

is_soft_declineboolean or null

processor_metadatamap from strings to any or null

captured_atdatetime or null

metadatamap from strings to any or null

refunded_amount_atominteger or nullDefaults to 0

refundedboolean or nullDefaults to false

Authentication

Path parameters

Request

Response

Errors