Skip to content
Proxy Developer Docs

/proxy_sessions/{proxy_session_id}/acquisition_attempts/{acquisition_attempt_id}/provider_objects

POST
/proxy_sessions/{proxy_session_id}/acquisition_attempts/{acquisition_attempt_id}/provider_objects
curl --request POST \
  --url https://example.com/proxy_sessions/example/acquisition_attempts/example/provider_objects \
  --header 'Content-Type: application/json' \
  --data '{ "expected_version": 1, "object_id": "example", "role": "root", "object_type": "checkout_session", "provider_confirmation": { "amount_minor": 1, "cart_version": 1, "currency": "example", "evidence_sha256": "example", "merchandise_subtotal_minor": 1 } }'

Attaches one Stripe object to an existing provider acquisition role.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
acquisition_attempt_id
required
string
/^pspacq_/
proxy_session_id
required
string
/^psess_/

Request Bodyrequired

Section titled “ Request Bodyrequired ”
Media typeapplication/json
object
expected_version
required
integer
>= 1 <= 2147483647
object_id
required
string
>= 4 characters <= 255 characters
role
required
string
Allowed values: root setup_intent
object_type
required
string
Allowed values: checkout_session payment_intent setup_intent subscription
provider_confirmation
object
amount_minor
required
integer
<= 2147483647
cart_version
required
integer
<= 2147483647
currency
required
string
/^[a-z]{3}$/
evidence_sha256
required
string
/^[a-f0-9]{64}$/
merchandise_subtotal_minor
integer
<= 2147483647

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Default Response

Media typeapplication/json
object
attempt_number
required
integer
>= 1
checkout_ui_mode
required
null | string
commercial_mode
required
string
Allowed values: one_time subscription
completion_recorded_at
required
null | string
created_at
required
string
direct_fee_basis_source
required
null | string
direct_merchandise_currency
required
null | string
direct_merchandise_subtotal_minor
required
null | integer
id
required
string
/^pspacq_/
integration_path
required
string
Allowed values: checkout_session payment_intent direct_subscription
merchant_psp_config_id
required
string
/^pspcfg_/
pricing_mode
required
string
Allowed values: fixed provider_finalized
provider_confirmed_amount_minor
required
null | integer
provider_confirmed_at
required
null | string
provider_confirmed_cart_version
required
null | integer
provider_confirmed_currency
required
null | string
provider_confirmed_evidence_sha256
required
null | string
provider_confirmed_merchandise_subtotal_minor
required
null | integer
provider_created_at
required
null | string
provider_customer_id
required
null | string
provider_options_fingerprint
required
string
/^[a-f0-9]{64}$/
provider_retry_not_after
required
string
provider_root_object_id
required
null | string
provider_root_object_type
required
null | string
provider_setup_intent_id
required
null | string
proxy_session_id
required
string
/^psess_/
psp
required
string
Allowed values: stripe
status
required
string
status_reason
required
null | string
supersedes_attempt_id
required
null | string
updated_at
required
string
version
required
integer
>= 1
direct_subscription_source
required
Allowed values: setup_intent saved_payment_method
Example
{
  "commercial_mode": "one_time",
  "integration_path": "checkout_session",
  "pricing_mode": "fixed",
  "psp": "stripe",
  "direct_subscription_source": "setup_intent"
}

400

Section titled “ 400 ”

Default Response

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "request_id": "example"
  }
}

401

Section titled “ 401 ”

Default Response

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "request_id": "example"
  }
}

404

Section titled “ 404 ”

Default Response

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "request_id": "example"
  }
}

409

Section titled “ 409 ”

Default Response

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "request_id": "example"
  }
}

500

Section titled “ 500 ”

Default Response

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "request_id": "example"
  }
}