1. Appian - Submerchant Register
  • Developer Docs Ecuador 🇪🇨
  • Online Payments
    • Release Notes
    • Kushki API errors
    • Card Payments
      • Request a card token
      • Make a charge or deferred charge
      • Refund a transaction
      • Void a transaction
      • Request deferred options
      • Validate OTP
      • Bin Info V2
      • Bin Info
    • One Click and Scheduled Payments
      • Request a recurring charge token
      • Create a recurring charge
      • Update recurring charge card data
      • Make an One-click payment
      • Cancel a recurring charge
      • Update a recurring charge
      • Add a temporary charge or discount
      • Get recurring charge Info
    • Chargebacks
      • Query chargebacks
      • Request chargeback export
    • Subscription Transactions
      • Get subscription transactions
    • Transfer in
      • Request a Transfer In token
      • Init Transaction
      • Get Status
    • Cash in
      • Request a cash in token
      • Init Transaction
      • Update a cash in transaction
      • Transaction Status
      • Delete a cash in transaction
    • Smartlinks
      • Create a Smartlink
      • Update a Smartlink
      • Get a Smartlink
      • Delete a smartlink
    • Analytics
      • Get transactions list v1
      • Get transactions list v2
    • Status
      • Get gateway status
      • Get platform status
    • Commissions
      • Get Commission Configuration
    • Payment Credentials
      • Create a credential
      • Search credentials
      • Activate or deactivate
      • Delete credential
      • Update credential
      • Regenerate a credential
      • Advanced search
    • Payment Button
      • Create a payment button
    • Settlement
      • Query settlement
  • Appian - Submerchant Register
    • Release Notes
    • Submerchant Validation in Batch
      POST
    • Query submerchant status by requestId/submerchantId
      GET
    • Get submerchantIds
      GET
    • Get credentials for submerchants
      POST
  • Schemas
    • threeDomainSecure
    • webhooks
    • Card-old
    • Channel
    • Amount-cash-in
    • ChargebackListResponse
    • StatusComponent
    • SettlementDateRangeRequest
    • SubscriptionTransactionsResponse
    • Card
    • Card Present (CP)
    • currency
    • networkToken
    • ChargebackItem
    • ErrorResponse
    • SettlementRecord
    • SubscriptionTransaction
    • Card Not Present (CNP)
    • Subscription
    • Amount
    • ErrorResponse400
    • SettlementResponse
    • extraTaxes
    • Country
    • ErrorResponse401
    • Language
    • Deferred
    • ErrorResponse403
    • Metadata
    • payment_method
    • ErrorResponse500
    • ContactDetails
    • orderDetails
    • Shipping Address
    • Billing-Address
    • payment_submethod
    • SubscriptionUpdate
    • SubscriptionAdjustmentRequest
    • documentType
    • threeDomainSecure
    • webhooks
    • headers
    • webhooksChargeback
    • citMit
    • network
    • binInfo
    • messageFields
    • product
    • UnexpectedErrorResponse
    • ExternalReferenceId
    • transactionType
    • SettlementTicketRequest
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
  1. Appian - Submerchant Register

Release Notes


Release notes#

Discover the latest feature releases, product improvements and bug fixes of Kushki online payment services.


Stay up to date with changes and updates to the batch submerchant onboarding endpoint POST /onboarding/v1/submerchants/batch in Ecuador 🇪🇨.
We use the ISO 8601 standard (YYYY-MM-DD) for dates, and Semantic Versioning (MAJOR.MINOR.PATCH) for version numbers, increasing the:
1.
MAJOR version when we make incompatible API changes,
2.
MINOR version when we add functionality in a backward-compatible manner, and
3.
PATCH version when we make backward-compatible bug fixes.
NEW for new features.
IMPROVEMENTS for changes in existing functionality.
DEPRECATED for soon-to-be removed features.
REMOVED for now removed features.
FIX for any bug fixes.
SECURITY in case of vulnerabilities.

Latest#

1.1.0 - 2026-08-31#

NEW

🆕 Batch submerchant onboarding available in Ecuador (Card Not Present only)#

The batch submerchant onboarding endpoint POST /onboarding/v1/submerchants/batch is now available in Ecuador 🇪🇨, allowing multiple submerchants to be created in a single request. Ecuador supports Card Not Present only; there is no Card Present variant.
Key capabilities:
Each batch item uses the single Card Not Present model directly (no variant selection).
Point‑of‑sale fields are not applicable and are omitted.
INFO
Because Ecuador is Card Not Present only, requests do not select a request model — send Card Not Present items directly.
NEW

🆕 Nationality fields for legal representative and beneficial owners#

Three nationality properties were added to the submerchant model to support identity and compliance requirements.
FieldDescriptionRequired
legalRepresentativeNationalityNationality of the legal representative. ISO 3166‑1 alpha‑3 country code.Yes
uboNationalityNationality of the ultimate beneficial owner (UBO). ISO 3166‑1 alpha‑3 country code.Yes
ubo2NationalityNationality of the second UBO. ISO 3166‑1 alpha‑3 country code. Nullable when there is no second UBO.No
WARNING
Nationality values must be valid ISO 3166‑1 alpha‑3 codes (for example ECU, COL, PER, MEX, CHL). Send ubo2Nationality as null when a second beneficial owner does not apply.
NEW

🆕 Card Not Present validation rules#

The Card Not Present model reflects how online submerchants are onboarded in Ecuador.
RuleDetail
operationTypeRestricted to CNP or BIN CNP.
Point‑of‑sale fieldsNot applicable to remote payments.
submerchantUrlRequired — the operating website must be provided.
NEW

🆕 submerchantName rules#

The submerchantName value follows a defined specification for accepted values and normalization.
Key capabilities:
Maximum length of 18 characters.
The value is normalized to uppercase and trimmed of leading/trailing spaces.
Must contain at least one letter (A–Z).
Allowed characters: A–Z, 0–9, &, -, and single spaces between words.
Accented characters and Ñ are not allowed.
WARNING
Values that exceed 18 characters after normalization, or that contain unsupported characters, are rejected. Remove accents and Ñ before sending (for example, use PENA instead of PEÑA).
Got a suggestion on this documentation? Contact us.
Modified at 2026-08-31 21:24:52
Previous
Appian - Submerchant Register
Next
Submerchant Validation in Batch
Built with