From 98da0bf4c6339058c26cd011f92c8989c629a406 Mon Sep 17 00:00:00 2001 From: Peng Ying Date: Sat, 24 Jan 2026 14:32:59 -0800 Subject: [PATCH 1/2] feat: add isPlatformAccount to PaymentInstructions and remove PaymentAccountOrWalletInfo refs --- mintlify/openapi.yaml | 181 +++++------------- openapi.yaml | 181 +++++------------- .../common/PaymentAccountOrWalletInfo.yaml | 21 -- .../schemas/common/PaymentBaseWalletInfo.yaml | 4 +- .../common/PaymentClabeAccountInfo.yaml | 1 - .../schemas/common/PaymentFboAccountInfo.yaml | 19 -- .../common/PaymentIbanAccountInfo.yaml | 1 - .../schemas/common/PaymentInstructions.yaml | 7 +- .../common/PaymentLightningInvoiceInfo.yaml | 6 +- .../schemas/common/PaymentNgnAccountInfo.yaml | 1 - .../schemas/common/PaymentPixAccountInfo.yaml | 1 - .../common/PaymentPolygonWalletInfo.yaml | 4 +- .../common/PaymentSolanaWalletInfo.yaml | 1 - .../common/PaymentSparkWalletInfo.yaml | 1 - .../schemas/common/PaymentTronWalletInfo.yaml | 4 +- .../schemas/common/PaymentUpiAccountInfo.yaml | 1 - .../schemas/common/PaymentUsAccountInfo.yaml | 1 - 17 files changed, 105 insertions(+), 330 deletions(-) delete mode 100644 openapi/components/schemas/common/PaymentAccountOrWalletInfo.yaml delete mode 100644 openapi/components/schemas/common/PaymentFboAccountInfo.yaml diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index b0634a6..c47fdb6 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -4570,9 +4570,25 @@ components: example: 12550 currency: $ref: '#/components/schemas/Currency' + ClabeAccountInfo: + type: object + required: + - accountType + - clabeNumber + properties: + accountType: + type: string + const: CLABE + example: CLABE + clabeNumber: + type: string + description: 18-digit CLABE number (Mexican banking standard) + example: '123456789012345678' + minLength: 18 + maxLength: 18 + pattern: ^[0-9]{18}$ PaymentClabeAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/ClabeAccountInfo' required: - reference @@ -4581,28 +4597,6 @@ components: type: string description: Unique reference code that must be included with the payment to properly credit it example: UMA-Q12345-REF - PaymentAccountOrWalletInfo: - type: object - required: - - accountType - properties: - accountType: - $ref: '#/components/schemas/BankAccountOrWalletType' - discriminator: - propertyName: accountType - mapping: - CLABE: '#/components/schemas/PaymentClabeAccountInfo' - US_ACCOUNT: '#/components/schemas/PaymentUsAccountInfo' - PIX: '#/components/schemas/PaymentPixAccountInfo' - IBAN: '#/components/schemas/PaymentIbanAccountInfo' - FBO: '#/components/schemas/PaymentFboAccountInfo' - UPI: '#/components/schemas/PaymentUpiAccountInfo' - NGN_ACCOUNT: '#/components/schemas/PaymentNgnAccountInfo' - SPARK_WALLET: '#/components/schemas/PaymentSparkWalletInfo' - LIGHTNING: '#/components/schemas/PaymentLightningInvoiceInfo' - SOLANA_WALLET: '#/components/schemas/PaymentSolanaWalletInfo' - TRON_WALLET: '#/components/schemas/PaymentTronWalletInfo' - POLYGON_WALLET: '#/components/schemas/PaymentPolygonWalletInfo' UsAccountInfo: type: object required: @@ -4639,7 +4633,6 @@ components: example: Chase Bank PaymentUsAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/UsAccountInfo' required: - reference @@ -4680,7 +4673,6 @@ components: example: '1234567890' PaymentPixAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/PixAccountInfo' IbanAccountInfo: type: object @@ -4707,7 +4699,6 @@ components: maxLength: 11 PaymentIbanAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/IbanAccountInfo' required: - reference @@ -4716,26 +4707,6 @@ components: type: string description: Unique reference code that must be included with the payment to properly credit it example: UMA-Q12345-REF - PaymentFboAccountInfo: - allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - - type: object - required: - - paymentUrl - - paymentMethod - properties: - paymentUrl: - type: string - format: uri - description: The URL to make a request to in order to confirm payment - example: https://api.lightspark.com/grid/2025-10-13/confirm - paymentMethod: - type: string - enum: - - POST - - GET - description: The HTTP method to use for confirming the payment - example: POST UpiAccountInfo: type: object required: @@ -4752,41 +4723,7 @@ components: example: somecustomers@okbank PaymentUpiAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/UpiAccountInfo' - NgnAccountInfo: - type: object - required: - - accountType - - accountNumber - - bankName - properties: - accountType: - type: string - const: NGN_ACCOUNT - example: NGN_ACCOUNT - accountNumber: - type: string - description: Nigerian bank account number - example: '0123456789' - minLength: 10 - maxLength: 10 - pattern: ^[0-9]{10}$ - bankName: - type: string - description: Name of the bank - example: First Bank of Nigeria - PaymentNgnAccountInfo: - allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - - $ref: '#/components/schemas/NgnAccountInfo' - required: - - reference - properties: - reference: - type: string - description: Unique reference code that must be included with the payment to properly credit it - example: UMA-Q12345-REF SparkWalletInfo: type: object required: @@ -4803,7 +4740,6 @@ components: example: spark1pgssyuuuhnrrdjswal5c3s3rafw9w3y5dd4cjy3duxlf7hjzkp0rqx6dj6mrhu PaymentSparkWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/SparkWalletInfo' required: - assetType @@ -4819,16 +4755,13 @@ components: description: Invoice for the payment example: sparkrt1pgss8ter0fhc4c220f3zftmpz49h8wqte8eg3m5zkrraplgc048jucgszg3ssqgjzqqekv73mmh842yj7drsjwh7t7tz5zt8wf5kghm5v4ehggszppjp5s80cg3qjdzc55g2567tn3lj705hdsr577tg8ah795mlnt6807y657qhkmgfkf9w75p4wz3l8vhua85zdn6ryj32zuj0p00pv2l5z4u47mw6h4s PaymentLightningInvoiceInfo: - allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' + type: object required: - accountType - invoice properties: accountType: - type: string - enum: - - LIGHTNING + const: LIGHTNING example: LIGHTNING invoice: type: string @@ -4850,7 +4783,6 @@ components: example: 4Nd1m6Qkq7RfKuE5vQ9qP9Tn6H94Ueqb4xXHzsAbd8Wg PaymentSolanaWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/SolanaWalletInfo' properties: assetType: @@ -4875,14 +4807,12 @@ components: example: TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL PaymentTronWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/TronWalletInfo' properties: assetType: type: string description: Type of asset - enum: - - USDT + const: USDT PolygonWalletInfo: type: object required: @@ -4899,48 +4829,12 @@ components: example: '0xAbCDEF1234567890aBCdEf1234567890ABcDef12' PaymentPolygonWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/PolygonWalletInfo' properties: assetType: type: string description: Type of asset - enum: - - USDC - BankAccountOrWalletType: - type: string - enum: - - CLABE - - US_ACCOUNT - - PIX - - IBAN - - FBO - - UPI - - NGN_ACCOUNT - - SPARK_WALLET - - LIGHTNING - - SOLANA_WALLET - - TRON_WALLET - - POLYGON_WALLET - - BASE_WALLET - description: Type of account or wallet information - ClabeAccountInfo: - type: object - required: - - accountType - - clabeNumber - properties: - accountType: - type: string - const: CLABE - example: CLABE - clabeNumber: - type: string - description: 18-digit CLABE number (Mexican banking standard) - example: '123456789012345678' - minLength: 18 - maxLength: 18 - pattern: ^[0-9]{18}$ + const: USDC BaseWalletInfo: type: object required: @@ -4957,14 +4851,12 @@ components: example: '0xAbCDEF1234567890aBCdEf1234567890ABcDef12' PaymentBaseWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/BaseWalletInfo' properties: assetType: type: string description: Type of asset - enum: - - USDC + const: USDC PaymentInstructions: type: object required: @@ -4974,6 +4866,10 @@ components: type: string description: Additional human-readable instructions for making the payment example: Please ensure the reference code is included in the payment memo/description field + isPlatformAccount: + type: boolean + description: Indicates whether the account is a platform account or a customer account. + example: true accountOrWalletInfo: oneOf: - title: CLABE Account @@ -4984,8 +4880,6 @@ components: $ref: '#/components/schemas/PaymentPixAccountInfo' - title: IBAN Account $ref: '#/components/schemas/PaymentIbanAccountInfo' - - title: FBO Account - $ref: '#/components/schemas/PaymentFboAccountInfo' - title: UPI Account $ref: '#/components/schemas/PaymentUpiAccountInfo' - title: Spark Wallet @@ -5007,7 +4901,6 @@ components: US_ACCOUNT: '#/components/schemas/PaymentUsAccountInfo' PIX: '#/components/schemas/PaymentPixAccountInfo' IBAN: '#/components/schemas/PaymentIbanAccountInfo' - FBO: '#/components/schemas/PaymentFboAccountInfo' UPI: '#/components/schemas/PaymentUpiAccountInfo' SPARK_WALLET: '#/components/schemas/PaymentSparkWalletInfo' LIGHTNING: '#/components/schemas/PaymentLightningInvoiceInfo' @@ -5209,6 +5102,28 @@ components: mapping: INDIVIDUAL: '#/components/schemas/IndividualBeneficiary' BUSINESS: '#/components/schemas/BusinessBeneficiary' + NgnAccountInfo: + type: object + required: + - accountType + - accountNumber + - bankName + properties: + accountType: + type: string + const: NGN_ACCOUNT + example: NGN_ACCOUNT + accountNumber: + type: string + description: Nigerian bank account number + example: '0123456789' + minLength: 10 + maxLength: 10 + pattern: ^[0-9]{10}$ + bankName: + type: string + description: Name of the bank + example: First Bank of Nigeria NgnAccountExternalAccountInfo: allOf: - $ref: '#/components/schemas/NgnAccountInfo' diff --git a/openapi.yaml b/openapi.yaml index b0634a6..c47fdb6 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -4570,9 +4570,25 @@ components: example: 12550 currency: $ref: '#/components/schemas/Currency' + ClabeAccountInfo: + type: object + required: + - accountType + - clabeNumber + properties: + accountType: + type: string + const: CLABE + example: CLABE + clabeNumber: + type: string + description: 18-digit CLABE number (Mexican banking standard) + example: '123456789012345678' + minLength: 18 + maxLength: 18 + pattern: ^[0-9]{18}$ PaymentClabeAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/ClabeAccountInfo' required: - reference @@ -4581,28 +4597,6 @@ components: type: string description: Unique reference code that must be included with the payment to properly credit it example: UMA-Q12345-REF - PaymentAccountOrWalletInfo: - type: object - required: - - accountType - properties: - accountType: - $ref: '#/components/schemas/BankAccountOrWalletType' - discriminator: - propertyName: accountType - mapping: - CLABE: '#/components/schemas/PaymentClabeAccountInfo' - US_ACCOUNT: '#/components/schemas/PaymentUsAccountInfo' - PIX: '#/components/schemas/PaymentPixAccountInfo' - IBAN: '#/components/schemas/PaymentIbanAccountInfo' - FBO: '#/components/schemas/PaymentFboAccountInfo' - UPI: '#/components/schemas/PaymentUpiAccountInfo' - NGN_ACCOUNT: '#/components/schemas/PaymentNgnAccountInfo' - SPARK_WALLET: '#/components/schemas/PaymentSparkWalletInfo' - LIGHTNING: '#/components/schemas/PaymentLightningInvoiceInfo' - SOLANA_WALLET: '#/components/schemas/PaymentSolanaWalletInfo' - TRON_WALLET: '#/components/schemas/PaymentTronWalletInfo' - POLYGON_WALLET: '#/components/schemas/PaymentPolygonWalletInfo' UsAccountInfo: type: object required: @@ -4639,7 +4633,6 @@ components: example: Chase Bank PaymentUsAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/UsAccountInfo' required: - reference @@ -4680,7 +4673,6 @@ components: example: '1234567890' PaymentPixAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/PixAccountInfo' IbanAccountInfo: type: object @@ -4707,7 +4699,6 @@ components: maxLength: 11 PaymentIbanAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/IbanAccountInfo' required: - reference @@ -4716,26 +4707,6 @@ components: type: string description: Unique reference code that must be included with the payment to properly credit it example: UMA-Q12345-REF - PaymentFboAccountInfo: - allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - - type: object - required: - - paymentUrl - - paymentMethod - properties: - paymentUrl: - type: string - format: uri - description: The URL to make a request to in order to confirm payment - example: https://api.lightspark.com/grid/2025-10-13/confirm - paymentMethod: - type: string - enum: - - POST - - GET - description: The HTTP method to use for confirming the payment - example: POST UpiAccountInfo: type: object required: @@ -4752,41 +4723,7 @@ components: example: somecustomers@okbank PaymentUpiAccountInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/UpiAccountInfo' - NgnAccountInfo: - type: object - required: - - accountType - - accountNumber - - bankName - properties: - accountType: - type: string - const: NGN_ACCOUNT - example: NGN_ACCOUNT - accountNumber: - type: string - description: Nigerian bank account number - example: '0123456789' - minLength: 10 - maxLength: 10 - pattern: ^[0-9]{10}$ - bankName: - type: string - description: Name of the bank - example: First Bank of Nigeria - PaymentNgnAccountInfo: - allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - - $ref: '#/components/schemas/NgnAccountInfo' - required: - - reference - properties: - reference: - type: string - description: Unique reference code that must be included with the payment to properly credit it - example: UMA-Q12345-REF SparkWalletInfo: type: object required: @@ -4803,7 +4740,6 @@ components: example: spark1pgssyuuuhnrrdjswal5c3s3rafw9w3y5dd4cjy3duxlf7hjzkp0rqx6dj6mrhu PaymentSparkWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/SparkWalletInfo' required: - assetType @@ -4819,16 +4755,13 @@ components: description: Invoice for the payment example: sparkrt1pgss8ter0fhc4c220f3zftmpz49h8wqte8eg3m5zkrraplgc048jucgszg3ssqgjzqqekv73mmh842yj7drsjwh7t7tz5zt8wf5kghm5v4ehggszppjp5s80cg3qjdzc55g2567tn3lj705hdsr577tg8ah795mlnt6807y657qhkmgfkf9w75p4wz3l8vhua85zdn6ryj32zuj0p00pv2l5z4u47mw6h4s PaymentLightningInvoiceInfo: - allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' + type: object required: - accountType - invoice properties: accountType: - type: string - enum: - - LIGHTNING + const: LIGHTNING example: LIGHTNING invoice: type: string @@ -4850,7 +4783,6 @@ components: example: 4Nd1m6Qkq7RfKuE5vQ9qP9Tn6H94Ueqb4xXHzsAbd8Wg PaymentSolanaWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/SolanaWalletInfo' properties: assetType: @@ -4875,14 +4807,12 @@ components: example: TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL PaymentTronWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/TronWalletInfo' properties: assetType: type: string description: Type of asset - enum: - - USDT + const: USDT PolygonWalletInfo: type: object required: @@ -4899,48 +4829,12 @@ components: example: '0xAbCDEF1234567890aBCdEf1234567890ABcDef12' PaymentPolygonWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/PolygonWalletInfo' properties: assetType: type: string description: Type of asset - enum: - - USDC - BankAccountOrWalletType: - type: string - enum: - - CLABE - - US_ACCOUNT - - PIX - - IBAN - - FBO - - UPI - - NGN_ACCOUNT - - SPARK_WALLET - - LIGHTNING - - SOLANA_WALLET - - TRON_WALLET - - POLYGON_WALLET - - BASE_WALLET - description: Type of account or wallet information - ClabeAccountInfo: - type: object - required: - - accountType - - clabeNumber - properties: - accountType: - type: string - const: CLABE - example: CLABE - clabeNumber: - type: string - description: 18-digit CLABE number (Mexican banking standard) - example: '123456789012345678' - minLength: 18 - maxLength: 18 - pattern: ^[0-9]{18}$ + const: USDC BaseWalletInfo: type: object required: @@ -4957,14 +4851,12 @@ components: example: '0xAbCDEF1234567890aBCdEf1234567890ABcDef12' PaymentBaseWalletInfo: allOf: - - $ref: '#/components/schemas/PaymentAccountOrWalletInfo' - $ref: '#/components/schemas/BaseWalletInfo' properties: assetType: type: string description: Type of asset - enum: - - USDC + const: USDC PaymentInstructions: type: object required: @@ -4974,6 +4866,10 @@ components: type: string description: Additional human-readable instructions for making the payment example: Please ensure the reference code is included in the payment memo/description field + isPlatformAccount: + type: boolean + description: Indicates whether the account is a platform account or a customer account. + example: true accountOrWalletInfo: oneOf: - title: CLABE Account @@ -4984,8 +4880,6 @@ components: $ref: '#/components/schemas/PaymentPixAccountInfo' - title: IBAN Account $ref: '#/components/schemas/PaymentIbanAccountInfo' - - title: FBO Account - $ref: '#/components/schemas/PaymentFboAccountInfo' - title: UPI Account $ref: '#/components/schemas/PaymentUpiAccountInfo' - title: Spark Wallet @@ -5007,7 +4901,6 @@ components: US_ACCOUNT: '#/components/schemas/PaymentUsAccountInfo' PIX: '#/components/schemas/PaymentPixAccountInfo' IBAN: '#/components/schemas/PaymentIbanAccountInfo' - FBO: '#/components/schemas/PaymentFboAccountInfo' UPI: '#/components/schemas/PaymentUpiAccountInfo' SPARK_WALLET: '#/components/schemas/PaymentSparkWalletInfo' LIGHTNING: '#/components/schemas/PaymentLightningInvoiceInfo' @@ -5209,6 +5102,28 @@ components: mapping: INDIVIDUAL: '#/components/schemas/IndividualBeneficiary' BUSINESS: '#/components/schemas/BusinessBeneficiary' + NgnAccountInfo: + type: object + required: + - accountType + - accountNumber + - bankName + properties: + accountType: + type: string + const: NGN_ACCOUNT + example: NGN_ACCOUNT + accountNumber: + type: string + description: Nigerian bank account number + example: '0123456789' + minLength: 10 + maxLength: 10 + pattern: ^[0-9]{10}$ + bankName: + type: string + description: Name of the bank + example: First Bank of Nigeria NgnAccountExternalAccountInfo: allOf: - $ref: '#/components/schemas/NgnAccountInfo' diff --git a/openapi/components/schemas/common/PaymentAccountOrWalletInfo.yaml b/openapi/components/schemas/common/PaymentAccountOrWalletInfo.yaml deleted file mode 100644 index fe63f85..0000000 --- a/openapi/components/schemas/common/PaymentAccountOrWalletInfo.yaml +++ /dev/null @@ -1,21 +0,0 @@ -type: object -required: - - accountType -properties: - accountType: - $ref: ./BankAccountOrWalletType.yaml -discriminator: - propertyName: accountType - mapping: - CLABE: ./PaymentClabeAccountInfo.yaml - US_ACCOUNT: ./PaymentUsAccountInfo.yaml - PIX: ./PaymentPixAccountInfo.yaml - IBAN: ./PaymentIbanAccountInfo.yaml - FBO: ./PaymentFboAccountInfo.yaml - UPI: ./PaymentUpiAccountInfo.yaml - NGN_ACCOUNT: ./PaymentNgnAccountInfo.yaml - SPARK_WALLET: ./PaymentSparkWalletInfo.yaml - LIGHTNING: ./PaymentLightningInvoiceInfo.yaml - SOLANA_WALLET: ./PaymentSolanaWalletInfo.yaml - TRON_WALLET: ./PaymentTronWalletInfo.yaml - POLYGON_WALLET: ./PaymentPolygonWalletInfo.yaml \ No newline at end of file diff --git a/openapi/components/schemas/common/PaymentBaseWalletInfo.yaml b/openapi/components/schemas/common/PaymentBaseWalletInfo.yaml index e422dbb..422cddb 100644 --- a/openapi/components/schemas/common/PaymentBaseWalletInfo.yaml +++ b/openapi/components/schemas/common/PaymentBaseWalletInfo.yaml @@ -1,9 +1,7 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./BaseWalletInfo.yaml properties: assetType: type: string description: Type of asset - enum: - - USDC \ No newline at end of file + const: USDC \ No newline at end of file diff --git a/openapi/components/schemas/common/PaymentClabeAccountInfo.yaml b/openapi/components/schemas/common/PaymentClabeAccountInfo.yaml index f43faba..0b19558 100644 --- a/openapi/components/schemas/common/PaymentClabeAccountInfo.yaml +++ b/openapi/components/schemas/common/PaymentClabeAccountInfo.yaml @@ -1,5 +1,4 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./ClabeAccountInfo.yaml required: - reference diff --git a/openapi/components/schemas/common/PaymentFboAccountInfo.yaml b/openapi/components/schemas/common/PaymentFboAccountInfo.yaml deleted file mode 100644 index 4aa9a2a..0000000 --- a/openapi/components/schemas/common/PaymentFboAccountInfo.yaml +++ /dev/null @@ -1,19 +0,0 @@ -allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - - type: object - required: - - paymentUrl - - paymentMethod - properties: - paymentUrl: - type: string - format: uri - description: The URL to make a request to in order to confirm payment - example: https://api.lightspark.com/grid/2025-10-13/confirm - paymentMethod: - type: string - enum: - - POST - - GET - description: The HTTP method to use for confirming the payment - example: POST diff --git a/openapi/components/schemas/common/PaymentIbanAccountInfo.yaml b/openapi/components/schemas/common/PaymentIbanAccountInfo.yaml index 81c8fe7..76315f5 100644 --- a/openapi/components/schemas/common/PaymentIbanAccountInfo.yaml +++ b/openapi/components/schemas/common/PaymentIbanAccountInfo.yaml @@ -1,5 +1,4 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./IbanAccountInfo.yaml required: - reference diff --git a/openapi/components/schemas/common/PaymentInstructions.yaml b/openapi/components/schemas/common/PaymentInstructions.yaml index 33d2181..7c0ae2b 100644 --- a/openapi/components/schemas/common/PaymentInstructions.yaml +++ b/openapi/components/schemas/common/PaymentInstructions.yaml @@ -8,6 +8,10 @@ properties: example: >- Please ensure the reference code is included in the payment memo/description field + isPlatformAccount: + type: boolean + description: Indicates whether the account is a platform account or a customer account. + example: true accountOrWalletInfo: oneOf: - title: CLABE Account @@ -18,8 +22,6 @@ properties: $ref: ../common/PaymentPixAccountInfo.yaml - title: IBAN Account $ref: ../common/PaymentIbanAccountInfo.yaml - - title: FBO Account - $ref: ../common/PaymentFboAccountInfo.yaml - title: UPI Account $ref: ../common/PaymentUpiAccountInfo.yaml - title: Spark Wallet @@ -41,7 +43,6 @@ properties: US_ACCOUNT: ../common/PaymentUsAccountInfo.yaml PIX: ../common/PaymentPixAccountInfo.yaml IBAN: ../common/PaymentIbanAccountInfo.yaml - FBO: ../common/PaymentFboAccountInfo.yaml UPI: ../common/PaymentUpiAccountInfo.yaml SPARK_WALLET: ../common/PaymentSparkWalletInfo.yaml LIGHTNING: ../common/PaymentLightningInvoiceInfo.yaml diff --git a/openapi/components/schemas/common/PaymentLightningInvoiceInfo.yaml b/openapi/components/schemas/common/PaymentLightningInvoiceInfo.yaml index f3998ec..a18bb24 100644 --- a/openapi/components/schemas/common/PaymentLightningInvoiceInfo.yaml +++ b/openapi/components/schemas/common/PaymentLightningInvoiceInfo.yaml @@ -1,12 +1,10 @@ -allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml +type: object required: - accountType - invoice properties: accountType: - type: string - enum: [LIGHTNING] + const: LIGHTNING example: LIGHTNING invoice: type: string diff --git a/openapi/components/schemas/common/PaymentNgnAccountInfo.yaml b/openapi/components/schemas/common/PaymentNgnAccountInfo.yaml index 5cbe02b..587f52a 100644 --- a/openapi/components/schemas/common/PaymentNgnAccountInfo.yaml +++ b/openapi/components/schemas/common/PaymentNgnAccountInfo.yaml @@ -1,5 +1,4 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./NgnAccountInfo.yaml required: - reference diff --git a/openapi/components/schemas/common/PaymentPixAccountInfo.yaml b/openapi/components/schemas/common/PaymentPixAccountInfo.yaml index 24c3262..a586649 100644 --- a/openapi/components/schemas/common/PaymentPixAccountInfo.yaml +++ b/openapi/components/schemas/common/PaymentPixAccountInfo.yaml @@ -1,3 +1,2 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./PixAccountInfo.yaml diff --git a/openapi/components/schemas/common/PaymentPolygonWalletInfo.yaml b/openapi/components/schemas/common/PaymentPolygonWalletInfo.yaml index 059424e..1bd4efa 100644 --- a/openapi/components/schemas/common/PaymentPolygonWalletInfo.yaml +++ b/openapi/components/schemas/common/PaymentPolygonWalletInfo.yaml @@ -1,9 +1,7 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./PolygonWalletInfo.yaml properties: assetType: type: string description: Type of asset - enum: - - USDC \ No newline at end of file + const: USDC \ No newline at end of file diff --git a/openapi/components/schemas/common/PaymentSolanaWalletInfo.yaml b/openapi/components/schemas/common/PaymentSolanaWalletInfo.yaml index a344b2a..bc9e7f8 100644 --- a/openapi/components/schemas/common/PaymentSolanaWalletInfo.yaml +++ b/openapi/components/schemas/common/PaymentSolanaWalletInfo.yaml @@ -1,5 +1,4 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./SolanaWalletInfo.yaml properties: assetType: diff --git a/openapi/components/schemas/common/PaymentSparkWalletInfo.yaml b/openapi/components/schemas/common/PaymentSparkWalletInfo.yaml index 7933ff4..2b0cbe6 100644 --- a/openapi/components/schemas/common/PaymentSparkWalletInfo.yaml +++ b/openapi/components/schemas/common/PaymentSparkWalletInfo.yaml @@ -1,5 +1,4 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./SparkWalletInfo.yaml required: - assetType diff --git a/openapi/components/schemas/common/PaymentTronWalletInfo.yaml b/openapi/components/schemas/common/PaymentTronWalletInfo.yaml index 60ede12..4aa2cc9 100644 --- a/openapi/components/schemas/common/PaymentTronWalletInfo.yaml +++ b/openapi/components/schemas/common/PaymentTronWalletInfo.yaml @@ -1,9 +1,7 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./TronWalletInfo.yaml properties: assetType: type: string description: Type of asset - enum: - - USDT \ No newline at end of file + const: USDT \ No newline at end of file diff --git a/openapi/components/schemas/common/PaymentUpiAccountInfo.yaml b/openapi/components/schemas/common/PaymentUpiAccountInfo.yaml index 6f03983..0dc0366 100644 --- a/openapi/components/schemas/common/PaymentUpiAccountInfo.yaml +++ b/openapi/components/schemas/common/PaymentUpiAccountInfo.yaml @@ -1,3 +1,2 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./UpiAccountInfo.yaml diff --git a/openapi/components/schemas/common/PaymentUsAccountInfo.yaml b/openapi/components/schemas/common/PaymentUsAccountInfo.yaml index 738d09b..c03cbce 100644 --- a/openapi/components/schemas/common/PaymentUsAccountInfo.yaml +++ b/openapi/components/schemas/common/PaymentUsAccountInfo.yaml @@ -1,5 +1,4 @@ allOf: - - $ref: ./PaymentAccountOrWalletInfo.yaml - $ref: ./UsAccountInfo.yaml required: - reference From 41e30377643f3e1b9db8eeca971aef8aba76a267 Mon Sep 17 00:00:00 2001 From: Peng Ying Date: Tue, 27 Jan 2026 13:36:18 -0800 Subject: [PATCH 2/2] Update PaymentLightningInvoiceInfo.yaml --- .../components/schemas/common/PaymentLightningInvoiceInfo.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/openapi/components/schemas/common/PaymentLightningInvoiceInfo.yaml b/openapi/components/schemas/common/PaymentLightningInvoiceInfo.yaml index a18bb24..05166c8 100644 --- a/openapi/components/schemas/common/PaymentLightningInvoiceInfo.yaml +++ b/openapi/components/schemas/common/PaymentLightningInvoiceInfo.yaml @@ -4,6 +4,7 @@ required: - invoice properties: accountType: + type: string const: LIGHTNING example: LIGHTNING invoice: