Add direct payment method

components/schemas/billing/invoices/PaymentResult.yml

@@ -10,6 +10,7 @@ properties:
     description: The status of a payment.
     enum:
       - success
+      - awaiting-direct-payment
       - processing
       - cancelled
       - error

components/schemas/billing/methods/sources/DirectPayment.yml

@@ -0,0 +1,27 @@
+title: DirectPayment
+description: A payment method that must be enabled by Cycle staff, solely for telling us they're going to send us checks, wires, ach, outside of Cycle.
+type: object
+required:
+  - type
+  - details
+properties:
+  type:
+    type: string
+    enum:
+      - direct-payment
+  details:
+    type: object
+    required:
+      - preference
+      - instructions
+    properties:
+      preference:
+        type: string
+        description: The preference for how the payment will be sent.
+        enum:
+          - check
+          - wire
+          - ach
+      instructions:
+        type: string
+        description: Any additional instructions for an organization's billing dept., etc. that should be known about this payment method.

components/schemas/billing/methods/sources/MethodSource.yml

@@ -5,6 +5,8 @@ discriminator:
   mapping:
     stripe-credit-card: ./StripeCreditCard.yml
     stripe-us-bank-acct: ./StripeUsBankAcct.yml
+    direct-payment: ./DirectPayment.yml
 oneOf:
   - $ref: ./StripeCreditCard.yml
   - $ref: ./StripeUsBankAcct.yml
+  - $ref: DirectPayment.yml

components/schemas/hubs/HubBillingProfile.yml

@@ -12,6 +12,9 @@ properties:
   allow_prepaid:
     type: boolean
     description: A boolean where true represents this account being approved to use a prepaid card for billing transactions.
+  allow_direct_payments:
+    type: boolean
+    description: When true, this hub is allowed to create 'direct' payment methods.
   pause_invoices:
     type: boolean
     description: A boolean where true represents invoices have been paused on this hub for one reason or another.

platform/paths/billing/methods/methods.yml

@@ -104,6 +104,25 @@ post:
                       type: string
                       description: The number of the bank account.
                 - type: "null"
+            direct_payment:
+              oneOf:
+                - type: object
+                  description: Only available for hubs that have direct billing enabled. Contact Cycle staff at support@cycle.io for any questions.
+                  required:
+                    - preference
+                    - instructions
+                  properties:
+                    preference:
+                      type: string
+                      description: The preference for how the payment will be sent.
+                      enum:
+                        - check
+                        - wire
+                        - ach
+                    instructions:
+                      type: string
+                      description: Any additional instructions for an organization's billing dept., etc. that should be known about this payment method.
+                - type: "null"
   responses:
     201:
       description: Returns a billing method.