> ## Documentation Index
> Fetch the complete documentation index at: https://developers.paylinedata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create or recover the same durable Application

> UUID v4 identity is environment + tenant + stable caller + requestId. Equivalent normalized original intent recovers regardless of later merchant edits, defaults, allocation or lifecycle; different intent conflicts. Pricing defaults resolve once. Protected receipt comparison is encrypted. No email, processor submission or link renewal is implied.



## OpenAPI

````yaml /openapi/applications-v1.json post /applications
openapi: 3.1.0
info:
  title: Applications API — creation, recovery, retrieval and explicit reissue
  version: 1.0.0
  description: >-
    10N-909/910/911. Current answers and signed evidence are separate; retrieval
    and downloads require a committed sensitive-access audit. Artifact objects
    are bounded to 20 MiB, checksum/size verified before audit commit, then
    streamed without exposing storage URLs. GET status contains no protected
    values or merchant credential URL. Unreadable current authority returns
    protected_data_unavailable; no snapshot fallback. Artifact lookup is 404 if
    inaccessible, 409 artifact_not_ready before completion, or 503
    artifact_unavailable for integrity/storage failure. Clerk organization API
    keys and current local capabilities required. Tenant/environment/stable
    caller come from verified authority. 30 create attempts, 30 separate reissue
    attempts and 120 shared GET attempts per 60-second fixed window per stable
    caller; key replacement does not reset counters. Create body cap 65,536
    UTF-8 bytes; reissue body cap 1,024 UTF-8 bytes with 8-second read deadline,
    strings 2,048 characters, numeric pricing overrides 128 characters. Unknown
    fields rejected. Every implemented response is no-store. Persist requestId
    before the first attempt; after network failure/503 retry the original
    request, never generate a new ID. Schema defaults intentionally absent.
    Existing UI and signing remain unchanged. Protected values must never be
    logged by clients.
servers:
  - url: https://sandbox.paylinedata.com/api/v1
    description: Isolated Sandbox
  - url: https://dashboard.paylinedata.com/api/v1
    description: Production; separate activation required
security:
  - PartnerApiKey: []
paths:
  /applications:
    post:
      summary: Create or recover the same durable Application
      description: >-
        UUID v4 identity is environment + tenant + stable caller + requestId.
        Equivalent normalized original intent recovers regardless of later
        merchant edits, defaults, allocation or lifecycle; different intent
        conflicts. Pricing defaults resolve once. Protected receipt comparison
        is encrypted. No email, processor submission or link renewal is implied.
      operationId: createApplication
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateInput'
            examples:
              minimal:
                value:
                  requestId: 6de50264-993b-4ac3-9232-1b8ca6d784c1
                  merchantData:
                    business_legal_name: Sandbox Cedar Shop LLC
                  pricing:
                    model: ic_plus
              partial:
                value:
                  requestId: 09a18e23-e682-4a86-b450-e2aa23125ee3
                  merchantData:
                    business_legal_name: Sandbox Cedar Shop LLC
                    currently_processing_credit_cards: false
                    owner_date_of_birth: '1990-01-02'
                  pricing:
                    model: surcharge
                    overrides:
                      credit_card_per_transaction_fee: ' .1250 '
                      batch_fee: null
                  ownerUserId: null
      responses:
        '200':
          description: >-
            Same Application recovered; current status and handoff, disposition
            recovered.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateResponse'
        '201':
          description: Durably created; disposition created.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateResponse'
        '400':
          description: Safe 400 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Safe 401 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Safe 403 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Safe 404 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Safe 409 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Safe 413 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '415':
          description: Safe 415 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Safe 422 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Safe 429 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
            Retry-After:
              schema:
                type: integer
                minimum: 1
                maximum: 60
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Safe 503 error. No submitted values or credentials.
          headers:
            Cache-Control:
              schema:
                const: no-store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CreateInput:
      type: object
      additionalProperties: false
      properties:
        requestId:
          type: string
          pattern: >-
            ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
        merchantData:
          $ref: '#/components/schemas/MerchantInput'
        pricing:
          $ref: '#/components/schemas/PricingInput'
        ownerUserId:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
        assigneeUserId:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
      required:
        - requestId
        - merchantData
        - pricing
    CreateResponse:
      type: object
      additionalProperties: false
      properties:
        requestId:
          type: string
          format: uuid
        applicationId:
          type: string
          format: uuid
        disposition:
          enum:
            - created
            - recovered
        status:
          type: string
        handoff:
          $ref: '#/components/schemas/Handoff'
      required:
        - requestId
        - applicationId
        - disposition
        - status
        - handoff
    Error:
      type: object
      additionalProperties: false
      properties:
        error:
          type: object
          additionalProperties: false
          properties:
            code:
              enum:
                - invalid_request
                - unauthenticated
                - capability_denied
                - not_found
                - request_conflict
                - handoff_changed
                - signing_input_locked
                - already_signed
                - reissue_ineligible
                - payload_too_large
                - unsupported_media_type
                - validation_failed
                - rate_limited
                - operation_unconfirmed
                - protected_data_unavailable
                - artifact_not_ready
                - artifact_unavailable
                - service_unavailable
            message:
              type: string
            fields:
              type: array
              items:
                type: object
                additionalProperties: false
                properties:
                  path:
                    type: string
                  code:
                    type: string
                required:
                  - path
                  - code
            retryable:
              type: boolean
          required:
            - code
            - message
            - fields
            - retryable
        supportReference:
          type: string
          format: uuid
      required:
        - error
        - supportReference
    MerchantInput:
      type: object
      additionalProperties: false
      properties:
        business_legal_name:
          type: string
          maxLength: 2048
          pattern: \S
          description: Required legal business name.
        business_dba:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            DBA Name. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        business_tax_id:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Tax ID. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        business_start_date:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Date Business Started. Ordinary answer. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        business_industry:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Select Your Industry. Ordinary answer. Allowed nonblank values:
            0742, 0763, 0780, 1520, 1711, 1731, 1740, 1750, 1761, 1771, 1799,
            2741, 2791, 2842, 3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007,
            3008, 3009, 3010, 3011, 3012, 3013, 3014, 3015, 3016, 3017, 3018,
            3019, 3020, 3021, 3022, 3023, 3024, 3025, 3026, 3027, 3028, 3029,
            3030, 3031, 3032, 3033, 3034, 3035, 3036, 3037, 3038, 3039, 3040,
            3041, 3042, 3043, 3044, 3045, 3046, 3047, 3048, 3049, 3050, 3051,
            3052, 3053, 3054, 3055, 3056, 3057, 3058, 3059, 3060, 3061, 3062,
            3063, 3064, 3065, 3066, 3067, 3068, 3069, 3070, 3071, 3072, 3073,
            3074, 3075, 3076, 3077, 3078, 3079, 3080, 3081, 3082, 3083, 3084,
            3085, 3086, 3087, 3088, 3089, 3090, 3091, 3092, 3093, 3094, 3095,
            3096, 3097, 3098, 3099, 3100, 3101, 3102, 3103, 3104, 3105, 3106,
            3107, 3108, 3109, 3110, 3111, 3112, 3113, 3114, 3115, 3116, 3117,
            3118, 3119, 3120, 3121, 3122, 3123, 3124, 3125, 3126, 3127, 3128,
            3129, 3130, 3131, 3132, 3133, 3134, 3135, 3136, 3137, 3138, 3139,
            3140, 3141, 3142, 3143, 3144, 3145, 3146, 3147, 3148, 3149, 3150,
            3151, 3152, 3153, 3154, 3155, 3156, 3157, 3158, 3159, 3160, 3161,
            3162, 3163, 3164, 3165, 3166, 3167, 3168, 3169, 3170, 3171, 3172,
            3173, 3174, 3175, 3176, 3177, 3178, 3179, 3180, 3181, 3182, 3183,
            3184, 3185, 3186, 3187, 3188, 3189, 3190, 3191, 3192, 3193, 3194,
            3195, 3196, 3197, 3198, 3199, 3200, 3201, 3202, 3203, 3204, 3205,
            3206, 3207, 3208, 3209, 3210, 3211, 3212, 3213, 3214, 3215, 3216,
            3217, 3218, 3219, 3220, 3221, 3222, 3223, 3224, 3225, 3226, 3227,
            3228, 3229, 3230, 3231, 3232, 3233, 3234, 3235, 3236, 3237, 3238,
            3239, 3240, 3241, 3242, 3243, 3244, 3245, 3246, 3247, 3248, 3249,
            3250, 3251, 3252, 3253, 3254, 3255, 3256, 3257, 3258, 3259, 3260,
            3261, 3262, 3263, 3264, 3265, 3266, 3267, 3268, 3269, 3270, 3271,
            3272, 3273, 3274, 3275, 3276, 3277, 3278, 3279, 3280, 3281, 3282,
            3283, 3284, 3285, 3286, 3287, 3288, 3289, 3290, 3291, 3292, 3293,
            3294, 3295, 3296, 3297, 3298, 3299, 3351, 3352, 3353, 3354, 3355,
            3356, 3357, 3358, 3359, 3360, 3361, 3362, 3363, 3364, 3365, 3366,
            3367, 3368, 3369, 3370, 3371, 3372, 3373, 3374, 3375, 3376, 3377,
            3378, 3379, 3380, 3381, 3382, 3383, 3384, 3385, 3386, 3387, 3388,
            3389, 3390, 3391, 3392, 3393, 3394, 3395, 3396, 3397, 3398, 3399,
            3400, 3401, 3402, 3403, 3404, 3405, 3406, 3407, 3408, 3409, 3410,
            3411, 3412, 3413, 3414, 3415, 3416, 3417, 3418, 3419, 3420, 3421,
            3422, 3423, 3424, 3425, 3426, 3427, 3428, 3429, 3430, 3431, 3432,
            3433, 3434, 3435, 3436, 3437, 3438, 3439, 3440, 3441, 3501, 3502,
            3503, 3504, 3505, 3506, 3507, 3508, 3509, 3510, 3511, 3512, 3513,
            3514, 3515, 3516, 3517, 3518, 3519, 3520, 3521, 3522, 3523, 3524,
            3525, 3526, 3527, 3528, 3529, 3530, 3531, 3532, 3533, 3534, 3535,
            3536, 3537, 3538, 3539, 3540, 3541, 3542, 3543, 3544, 3545, 3546,
            3547, 3548, 3549, 3550, 3551, 3552, 3553, 3554, 3555, 3556, 3557,
            3558, 3559, 3560, 3561, 3562, 3563, 3564, 3565, 3566, 3567, 3568,
            3569, 3570, 3571, 3572, 3573, 3574, 3575, 3576, 3577, 3578, 3579,
            3580, 3581, 3582, 3583, 3584, 3585, 3586, 3587, 3588, 3589, 3590,
            3591, 3592, 3593, 3594, 3595, 3596, 3597, 3598, 3599, 3600, 3601,
            3602, 3603, 3604, 3605, 3606, 3607, 3608, 3609, 3610, 3611, 3612,
            3613, 3614, 3615, 3616, 3617, 3618, 3619, 3620, 3621, 3622, 3623,
            3624, 3625, 3626, 3627, 3628, 3629, 3630, 3631, 3632, 3633, 3634,
            3635, 3636, 3637, 3638, 3639, 3640, 3641, 3642, 3643, 3644, 3645,
            3646, 3647, 3648, 3649, 3650, 3651, 3652, 3653, 3654, 3655, 3656,
            3657, 3658, 3659, 3660, 3661, 3662, 3663, 3664, 3665, 3666, 3667,
            3668, 3669, 3670, 3671, 3672, 3673, 3674, 3675, 3676, 3677, 3678,
            3679, 3680, 3681, 3682, 3683, 3684, 3685, 3686, 3687, 3688, 3689,
            3690, 3691, 3692, 3693, 3694, 3695, 3696, 3697, 3698, 3699, 3700,
            3701, 3702, 3703, 3704, 3705, 3706, 3707, 3708, 3709, 3710, 3711,
            3712, 3713, 3714, 3715, 3716, 3717, 3718, 3719, 3720, 3721, 3722,
            3723, 3724, 3725, 3726, 3727, 3728, 3729, 3730, 3731, 3732, 3733,
            3734, 3735, 3736, 3737, 3738, 3739, 3740, 3741, 3742, 3743, 3744,
            3745, 3746, 3747, 3748, 3749, 3750, 3751, 3752, 3753, 3754, 3755,
            3756, 3757, 3758, 3759, 3760, 3761, 3762, 3763, 3764, 3765, 3766,
            3767, 3768, 3769, 3770, 3771, 3772, 3773, 3774, 3775, 3776, 3777,
            3778, 3779, 3780, 3781, 3782, 3783, 3784, 3785, 3786, 3787, 3788,
            3789, 3790, 3816, 3835, 4011, 4111, 4112, 4119, 4121, 4131, 4214,
            4215, 4225, 4411, 4457, 4468, 4511, 4582, 4722, 4723, 4784, 4789,
            4812, 4814, 4815, 4816, 4821, 4829, 4899, 4900, 5013, 5021, 5039,
            5044, 5045, 5046, 5047, 5051, 5065, 5072, 5074, 5085, 5094, 5099,
            5111, 5122, 5131, 5137, 5139, 5169, 5172, 5192, 5193, 5198, 5199,
            5200, 5211, 5231, 5251, 5261, 5271, 5300, 5309, 5310, 5311, 5331,
            5399, 5411, 5422, 5441, 5451, 5462, 5499, 5511, 5521, 5531, 5532,
            5533, 5541, 5542, 5551, 5561, 5571, 5592, 5598, 5599, 5611, 5621,
            5631, 5641, 5651, 5655, 5661, 5681, 5691, 5697, 5698, 5699, 5712,
            5713, 5714, 5718, 5719, 5722, 5732, 5733, 5734, 5735, 5811, 5812,
            5813, 5814, 5815, 5816, 5817, 5818, 5832, 5912, 5921, 5931, 5932,
            5933, 5935, 5937, 5940, 5941, 5942, 5943, 5944, 5945, 5946, 5947,
            5948, 5949, 5950, 5960, 5961, 5962, 5963, 5964, 5965, 5966, 5967,
            5968, 5969, 5970, 5971, 5972, 5973, 5975, 5976, 5977, 5978, 5983,
            5992, 5993, 5994, 5995, 5996, 5997, 5998, 5999, 6010, 6011, 6012,
            6051, 6211, 6300, 6381, 6399, 6513, 7011, 7012, 7032, 7033, 7210,
            7211, 7216, 7217, 7221, 7230, 7251, 7261, 7273, 7276, 7277, 7278,
            7296, 7297, 7298, 7299, 7311, 7321, 7332, 7333, 7338, 7339, 7342,
            7349, 7361, 7372, 7375, 7379, 7392, 7393, 7394, 7395, 7399, 7511,
            7512, 7513, 7519, 7523, 7531, 7534, 7535, 7538, 7542, 7549, 7622,
            7623, 7629, 7631, 7641, 7692, 7699, 7800, 7801, 7802, 7829, 7832,
            7841, 7911, 7922, 7929, 7932, 7933, 7941, 7991, 7992, 7993, 7994,
            7995, 7996, 7997, 7998, 7999, 8011, 8021, 8031, 8041, 8042, 8043,
            8044, 8049, 8050, 8062, 8071, 8099, 8111, 8211, 8220, 8241, 8244,
            8249, 8299, 8351, 8398, 8641, 8651, 8661, 8675, 8699, 8734, 8911,
            8931, 8999, 9211, 9222, 9223, 9311, 9399, 9402, 9405, 9700, 9701,
            9702, 9950. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        business_email:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Business email address. Ordinary answer. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        business_phone:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Business phone. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        business_website:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Website. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        company_structure:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Company Structure. Ordinary answer. Allowed nonblank values: Sole
            Proprietor, LLC, Private Corporation, Public Corporation,
            Partnership, Non-profit, Association / Estate, Medical / Legal
            Corporation. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        state_filed:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            State Filed. Ordinary answer. Allowed nonblank values: AL, AK, AZ,
            AR, CA, CO, CT, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD,
            MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR,
            PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, DC. Existing
            canonical validation and conditional dependencies apply; ordinary
            null/blank is absent.
        products_services_sold:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Explanation of Type of Merchandise, Products or Services Sold.
            Ordinary answer. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        has_additional_owners_25_pct:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Do you have additional owners with 25% or more ownership?. Ordinary
            answer. Allowed nonblank values: Yes, No. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        business_address:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Business Address. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        business_city:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            City. Ordinary answer. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        business_state:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            State. Ordinary answer. Allowed nonblank values: AL, AK, AZ, AR, CA,
            CO, CT, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI,
            MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI,
            SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, DC. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        business_zip:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Zip. Ordinary answer. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        legal_address_same_as_business:
          type:
            - boolean
            - 'null'
          description: >-
            Legal address is the same as business address. Ordinary answer.
            Existing canonical validation and conditional dependencies apply;
            ordinary null/blank is absent.
        legal_address:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Legal Address. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        legal_city:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            City. Ordinary answer. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        legal_state:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            State. Ordinary answer. Allowed nonblank values: AL, AK, AZ, AR, CA,
            CO, CT, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI,
            MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI,
            SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, DC. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        legal_zip:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Zip. Ordinary answer. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        billing_address_source:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Billing address. Ordinary answer. Allowed nonblank values: business,
            legal. Existing canonical validation and conditional dependencies
            apply; ordinary null/blank is absent.
        owner_first_name:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            First Name. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        owner_last_name:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Last Name. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        owner_email:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Email. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        owner_phone:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Phone Number. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        owner_home_address:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Home Address. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        owner_home_city:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            City. Ordinary answer. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        owner_home_state:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            State. Ordinary answer. Allowed nonblank values: AL, AK, AZ, AR, CA,
            CO, CT, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI,
            MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI,
            SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, DC. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        owner_home_zip:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Zip Code. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        owner_title:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Title. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        owner_ownership_pct:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Ownership Pct. Ordinary answer. Existing canonical validation and
            conditional dependencies apply; ordinary null/blank is absent.
        owner_date_of_birth:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Date of Birth. Protected input; encrypted storage and comparison
            only. Existing canonical validation and conditional dependencies
            apply; ordinary null/blank is absent.
        owner_ssn:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            SSN. Protected input; encrypted storage and comparison only.
            Existing canonical validation and conditional dependencies apply;
            ordinary null/blank is absent.
        card_acceptance_method:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            How do you accept card payments?. Ordinary answer. Allowed nonblank
            values: in_person_only, phone_or_manually_keyed_only,
            online_ecommerce_only, in_person_and_phone_or_manually_keyed.
            Existing canonical validation and conditional dependencies apply;
            ordinary null/blank is absent.
        processing_average_ticket:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Average ticket amount. Ordinary answer. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        currently_processing_credit_cards:
          type:
            - boolean
            - 'null'
          description: >-
            Do you currently process credit card payments?. Ordinary answer.
            Existing canonical validation and conditional dependencies apply;
            ordinary null/blank is absent.
        current_processor:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Who is your current processor?. Ordinary answer. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        gross_monthly_sales_volume:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Gross Monthly Sales Volume. Ordinary answer. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        highest_ticket_amount:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            Highest Ticket Amount. Ordinary answer. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
        transaction_to_delivery_timeframe:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            What is the time frame from transaction to delivery?. Ordinary
            answer. Allowed nonblank values: 0-7 days, 8-14 days, 15-30 days,
            31+ days. Existing canonical validation and conditional dependencies
            apply; ordinary null/blank is absent.
        refund_policy_type:
          type:
            - string
            - 'null'
          maxLength: 2048
          description: >-
            What type of refund policy?. Ordinary answer. Allowed nonblank
            values: No refunds, Exchange only, Store credit, Refund within 30
            days, Other. Existing canonical validation and conditional
            dependencies apply; ordinary null/blank is absent.
        bank_name:
          type: string
          maxLength: 2048
          description: >-
            Name of your bank. Protected input; encrypted storage and comparison
            only. Existing canonical validation and conditional dependencies
            apply; ordinary null/blank is absent.
          pattern: \S
        bank_account_type:
          type: string
          maxLength: 2048
          description: >-
            Account Type. Protected input; encrypted storage and comparison
            only. Allowed nonblank values: checking, savings. Existing canonical
            validation and conditional dependencies apply; ordinary null/blank
            is absent.
          pattern: \S
        bank_routing_number:
          type: string
          maxLength: 2048
          description: >-
            Routing Number. Protected input; encrypted storage and comparison
            only. Existing canonical validation and conditional dependencies
            apply; ordinary null/blank is absent.
          pattern: \S
        bank_account_number:
          type: string
          maxLength: 2048
          description: >-
            Account Number. Protected input; encrypted storage and comparison
            only. Existing canonical validation and conditional dependencies
            apply; ordinary null/blank is absent.
          pattern: \S
      required:
        - business_legal_name
      dependentRequired:
        bank_name:
          - bank_account_type
          - bank_routing_number
          - bank_account_number
        bank_account_type:
          - bank_name
          - bank_routing_number
          - bank_account_number
        bank_routing_number:
          - bank_name
          - bank_account_type
          - bank_account_number
        bank_account_number:
          - bank_name
          - bank_account_type
          - bank_routing_number
      description: >-
        46 canonical input fields only. If any Bank key is present, all four
        must be present and valid nonblank strings. DOB and SSN are independent.
        Currently processing true requires current_processor. All supplied
        nonblank data is validated before any graph write.
    PricingInput:
      oneOf:
        - type: object
          additionalProperties: false
          properties:
            model:
              const: ic_plus
            overrides:
              type: object
              additionalProperties: false
              properties:
                authorization_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                transaction_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                visa_qualified:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                mastercard_qualified:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                discover_qualified:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                amex_qualified:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                batch_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                avs:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                voice_auth:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                application_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                statement_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                minimum_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                pci_program_cost:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                etf:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                chargeback_retrieval_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_setup:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_monthly:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_transaction:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                wireless_activation_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                wireless_fee_monthly:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                discount_method:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(monthly|daily)\s*$
                pin_debit:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(yes|no)\s*$
                accept_ebt:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(yes|no)\s*$
                dns_number:
                  type:
                    - string
                    - 'null'
                  maxLength: 2048
                  description: >-
                    Trimmed text; preserves leading zeros. Null/blank remains
                    null.
              required: []
          required:
            - model
        - type: object
          additionalProperties: false
          properties:
            model:
              const: flat_rate
            overrides:
              type: object
              additionalProperties: false
              properties:
                authorization_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                transaction_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                visa_qualified:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                mastercard_qualified:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                discover_qualified:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                amex_qualified:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                batch_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                avs:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                voice_auth:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                application_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                statement_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                minimum_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                pci_program_cost:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                etf:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                chargeback_retrieval_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_setup:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_monthly:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_transaction:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                wireless_activation_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                wireless_fee_monthly:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                discount_method:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(monthly|daily)\s*$
                pin_debit:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(yes|no)\s*$
                accept_ebt:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(yes|no)\s*$
                dns_number:
                  type:
                    - string
                    - 'null'
                  maxLength: 2048
                  description: >-
                    Trimmed text; preserves leading zeros. Null/blank remains
                    null.
              required: []
          required:
            - model
        - type: object
          additionalProperties: false
          properties:
            model:
              const: surcharge
            overrides:
              type: object
              additionalProperties: false
              properties:
                credit_card_surcharge:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                credit_card_discount_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                credit_card_per_transaction_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                debit_card_discount_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                debit_card_transaction_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                batch_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                avs:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                voice_auth:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                application_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                statement_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                minimum_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                pci_program_cost:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                etf:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                chargeback_retrieval_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_setup:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_monthly:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_transaction:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                wireless_activation_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                wireless_fee_monthly:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                discount_method:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(monthly|daily)\s*$
                pin_debit:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(yes|no)\s*$
                accept_ebt:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(yes|no)\s*$
                dns_number:
                  type:
                    - string
                    - 'null'
                  maxLength: 2048
                  description: >-
                    Trimmed text; preserves leading zeros. Null/blank remains
                    null.
              required: []
          required:
            - model
        - type: object
          additionalProperties: false
          properties:
            model:
              const: cash_discount
            overrides:
              type: object
              additionalProperties: false
              properties:
                credit_card_surcharge:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                credit_card_discount_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                credit_card_per_transaction_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                debit_card_discount_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                debit_card_transaction_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                batch_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                avs:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                voice_auth:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                application_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                statement_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                minimum_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                pci_program_cost:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                etf:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                chargeback_retrieval_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_setup:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_monthly:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                gateway_transaction:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                wireless_activation_fee:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                wireless_fee_monthly:
                  type:
                    - string
                    - 'null'
                  maxLength: 128
                  pattern: ^\s*(?:(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+))?\s*$
                  description: >-
                    Omitted retains the selected default; null/blank is explicit
                    zero. Decimal strings only; preserved precision. No binary
                    float conversion.
                discount_method:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(monthly|daily)\s*$
                pin_debit:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(yes|no)\s*$
                accept_ebt:
                  type: string
                  maxLength: 2048
                  pattern: ^\s*(yes|no)\s*$
                dns_number:
                  type:
                    - string
                    - 'null'
                  maxLength: 2048
                  description: >-
                    Trimmed text; preserves leading zeros. Null/blank remains
                    null.
              required: []
          required:
            - model
    Handoff:
      type: object
      additionalProperties: false
      properties:
        id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
        state:
          enum:
            - active
            - expired
            - revoked
            - pending
            - unavailable
        url:
          anyOf:
            - type: string
              format: uri
            - type: 'null'
          description: >-
            Sensitive merchant credential URL; never log. Null when access
            unavailable. Recovery never renews expiry.
        issuedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        expiresAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        purpose:
          enum:
            - completion_or_signing
            - confirmation
      required:
        - id
        - state
        - url
        - issuedAt
        - expiresAt
        - purpose
  securitySchemes:
    PartnerApiKey:
      type: http
      scheme: bearer
      bearerFormat: Clerk organization API key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.