Everest Card — API reference
  • Credit
  • Debit
  • Prepaid
  • Common Methods
  • OAuth2
  • Delivery
Information
Cards
    Card applications
      getCardApplicationListpostgetDebitApplicationIdByFromShadowCardNumberpostsubmitCardApplicationExtStatuspost
    Card issuance and personalisation
      getApplicableProductsByCustomerNumberpostcreateIndividualCardpostcreateIndividualSupplementaryCardpostcreateCorporateCardpostcreateDummyCorporateCardpostcreateVirtualCardpostgetPendingCardEmbossListpostcancelCardEmbossByShadowCardNumberpost
    Card lifecycle
      getCustomerDebitCardListByTenantIdpostgetCustomerDebitShadowCardsByTenantIdpostchangeCardStatuspostgetCardListpostgetCardListNewpostgetCardInfopostreplaceCardpostchangeAndReplaceCardpostisCardFoundInpostaddDebitCardLogpost
    No-name cards
      createNoNameCardApplicationpostcancelNoNameCardApplicationpostupdateNoNameCardApplicationpostactivateNoNameCardpostcreateCardUsingNoNameApplicationpostcreateAndProcessNoNameCardApplicationpostreplaceNoNameCardpostreplaceCardUsingNoNameApplicationpostchangeAndReplaceNoNameCardpost
Customers and accounts
    Branch management
      changeCardBranchpostchangeCustomerBranchposttransferBranchCustomerpostgetDebitCustomerLisfOfBranchpost
    Customers
      getCorporateCustomerInfoByIndividualCustomerpostgetCustomerAssetpostisCustomerConvertToRipperpostgetCustomerAssetsSummaryDebitpost
    Account linking
      attachCardAccountpostdetachCardAccountpostdetachCardAccountByAccountNumberpostmodifyCardAccountpostlistCardAccountByAccountNumberpostlistCardAccountByShadowCardNumberpostrecreateCustomerCardAccountspostsaveCardAccountCurrencyConversionpostgetCardAccountCurrencyConversionpost
Transactions
    getDebitCardTransactionByUtidpostgetDebitCardTransactionByUtidNewpostgetDebitTransactionAllpostupdateTransactionForBNPLpostgetDigitalSlipReceiptpostgetAuthorizationListByBegindateEnddatepostgetDbttransactionByCardrefCustomernumpost
Limits and controls
    Card and customer limits
      getAvailableECommerceLimitpost
    Operation limits
      getCardLimitationParameterDatapostgetCardOperationLimitpostsetCardOperationLimitpostremoveCardOperationLimitpostgetCustomerOperationLimitpostsetCustomerOperationLimitpostremoveCustomerOperationLimitpostgetCustomerLimitationParameterDatapost
    Permissions and restrictions
      getCardPermissionspostsaveCardPermissionspostsaveCardBnplPermissionpostchangeCardMiscOptionpostgetCardMiscOptionpost
Security
    PIN and card security
      setCardPinpostchangeCardPinpostverifyCardPinpostverifyRsaPinpostsetRsaPinpostchangeRsaPinpostincreasePinTryCountpostverifyRsaPinWithStaticSaltpostverifyCVVpostverifyCVVPartialpostgenerateCVVpostgetCardPinOperationHistorypostresetCvvCounterpost
Disputes
    Disputes and chargebacks
      createDisputeCasepostgetDisputeListpostaddDocumentByCaseNumberpostcancelDisputeCasepost
Platform
    Platform operations
      healthCheckpostrefreshCachepost
    Reference data
      getCardTypeByBinpost
SchemasError codesChannels
powered by Zudoku
Debit Digital Channels Integration
Debit Digital Channels Integration

Customers

Read the customer behind the cards — portfolio summary, corporate relationships and total assets.


getCorporateCustomerInfoByIndividualCustomer

POST
https://sandboxpub.cms.dgpays.com/SandBox
/IntegrationDigitalChannelDebit/debit/api/getCorporateCustomerInfoByIndividualCustomer

Retrieves corporate customer information for a given individual customer. Validates the request, fetches customer assets, and filters for corporate supplementary cards (ProductSegmentCode = "T"). Returns a GetCorporateCustomerInfoByIndividualCustomerResponse containing MainCustomerNumber, ShadowCardNumber, and MaskedCardNumber for each relevant card.

getCorporateCustomerInfoByIndividualCustomer › Headers

evrst-ptrnid
​string

Correlation id for this request. Echo it in your own logs to trace the call through the platform.

Default: x_request_id

getCorporateCustomerInfoByIndividualCustomer › Request Body

GetCorporateCustomerInfoByIndividualCustomerRequest
channel
​string · maxLength: 3 · required

Three-digit code identifying the channel on behalf of which the request is made (e.g. 002 for Internet). Mandatory in every request. Used for entitlement checks, limit enforcement and audit logging. Channel codes are managed through configuration parameters and may change over time. Refer to the Channels page for the current list of valid codes.

customerNumber
​integer · int64 · required

The individual customer whose corporate relationships are read.

getCorporateCustomerInfoByIndividualCustomer › Responses

Success

GetCorporateCustomerInfoByIndividualCustomerResponse
​array · optional
POST/IntegrationDigitalChannelDebit/debit/api/getCorporateCustomerInfoByIndividualCustomer
curl https://sandboxpub.cms.dgpays.com/SandBox/IntegrationDigitalChannelDebit/debit/api/getCorporateCustomerInfoByIndividualCustomer \ --request POST \ --header 'Content-Type: application/json' \ --header 'evrst-ptrnid: x_request_id' \ --header 'Authorization: Bearer <access_token>' \ --data '{ "channel": "channel", "customerNumber": 0 }'
Example Request Body
{ "channel": "channel", "customerNumber": 0 }
json
application/json
Example Responses
{ "listOfDebitCorporateCustomerInfo": [ { "mainCustomerNumber": "mainCustomerNumber", "shadowCardNumber": "shadowCardNumber", "maskedCardNumber": "maskedCardNumber" } ] }
json
application/json

getCustomerAsset

POST
https://sandboxpub.cms.dgpays.com/SandBox
/IntegrationDigitalChannelDebit/debit/api/getCustomerAsset

Retrieves all debit card assets for a given customer. Fetches card details, sensitive data, account info, status, and delivery info. Uses _dcidRepository.GetCustomerAssetByCustomernumber for card data, _dbtServiceProxy.ListCardAccountByShadowCardNumber for account info, _coreBankingIntegrationOutdoor.GetAccountInformation for balances, and GetSensitiveData for sensitive card info (CVV2, PAN). Returns a GetCustomerAssetResponse containing a list of DebitCardModel with all relevant information.

getCustomerAsset › Headers

evrst-ptrnid
​string

Correlation id for this request. Echo it in your own logs to trace the call through the platform.

Default: x_request_id

getCustomerAsset › Request Body

GetCustomerAssetRequest
channelCode
​string · maxLength: 3 · required

Three-digit code identifying the channel on behalf of which the request is made (e.g. 002 for Internet). Mandatory in every request. Used for entitlement checks, limit enforcement and audit logging. Channel codes are managed through configuration parameters and may change over time. Refer to the Channels page for the current list of valid codes.

customerNumber
​integer · int64 · optional

The customer at the bank's core banking system, as a number. The platform stores it rather than issuing it, so it comes from the core.

purpose
​string · maxLength: 1 · optional

getCustomerAsset › Responses

Success.

Nothing in this request is validated. The facade passes the customer number, purpose and channel straight to a generated repository read, so an unknown customer, a zero customer number and an unrecognised purpose all return an empty result rather than a refusal.

channelCode is this operation's spelling of the channel field — it is not the channel the rest of the API carries, and it is not checked against the channel enumeration.

GetCustomerAssetResponse
​array · optional

The cards the search matched.

POST/IntegrationDigitalChannelDebit/debit/api/getCustomerAsset
curl https://sandboxpub.cms.dgpays.com/SandBox/IntegrationDigitalChannelDebit/debit/api/getCustomerAsset \ --request POST \ --header 'Content-Type: application/json' \ --header 'evrst-ptrnid: x_request_id' \ --header 'Authorization: Bearer <access_token>' \ --data '{ "channelCode": "channelCode", "customerNumber": 0, "purpose": "purpose" }'
Example Request Body
{ "channelCode": "channelCode", "customerNumber": 0, "purpose": "purpose" }
json
application/json
Example Responses
{ "listOfCard": [ { "shadowCardNumber": "shadowCardNumber", "maskedCardNumber": "maskedCardNumber", "cardRefNumber": "cardRefNumber", "mainCardRefNumber": "mainCardRefNumber", "customerNumber": 0, "mainCustomerNumber": 0, "relatedCardRefNumber": "relatedCardRefNumber", "supplementaryCardFlag": true, "cardRefCurrentCardFlag": true, "branchCode": 0, "branchName": "branchName", "ownerName": "ownerName", "ownerSecondName": "ownerSecondName", "ownerSurname": "ownerSurname", "embossName": "embossName", "productNumber": "productNumber", "productSegmentCode": "productSegmentCode", "cardStatusCode": "cardStatusCode", "cardStatusDscr": "cardStatusDscr", "cardStatusReasonCode": "cardStatusReasonCode", "cardStatusReasonDscr": "cardStatusReasonDscr", "virtualFlag": true, "digitalCardFlag": true, "productName": "productName", "productShortName": "productShortName", "tenantId": "tenantId", "emvFlag": true, "magneticStripeFlag": true, "contactlessFlag": true, "rewardEarningFlag": true, "cardBrand": "cardBrand", "cardBrandDescription": "cardBrandDescription", "cardDeliveryType": "cardDeliveryType", "expiryDateStr": "expiryDateStr", "provisionStatusFlag": true, "cardFormType": "cardFormType", "insertDate": "2026-10-16T14:30:00Z", "cvv2RetryCount": 0, "pinRetryCount": 0, "barcode": "barcode", "fromShadowCardNumber": "fromShadowCardNumber", "toShadowCardNumber": "toShadowCardNumber", "requestDate": "2026-10-16T14:30:00Z", "requestChannel": "requestChannel", "embossReasonCode": "embossReasonCode", "embossReasonDescription": "embossReasonDescription", "embossReasonSubCode": "embossReasonSubCode", "embossReasonSubDesc": "embossReasonSubDesc", "cardStatusChangeDate": "2026-10-16T14:30:00Z", "firstTrnDate": "2026-10-16T14:30:00Z", "lastTrnDate": "2026-10-16T14:30:00Z", "firstPinSetDate": "2026-10-16T14:30:00Z", "lastPinSetDate": "2026-10-16T14:30:00Z", "lastPinChangeDate": "2026-10-16T14:30:00Z", "deliveryAddress": "deliveryAddress", "isFirstPinSet": "isFirstPinSet", "sendingBranchCode": "sendingBranchCode", "sendingAddressType": "sendingAddressType", "productGroupCode": "productGroupCode", "productGroupDescription": "productGroupDescription", "fromMaskedCardNumber": "fromMaskedCardNumber", "toMaskedCardNumber": "toMaskedCardNumber", "disabledFlag": true, "cardAccountInfoList": [ { "accountNumber": 0, "cardAccountType": "cardAccountType", "accountType": "accountType", "accountSubType": "accountSubType", "accountBranchId": 0, "accountOrderFlag": true, "fecCode": 0, "currencyCode": "currencyCode", "balance": 0, "usableBalance": 0, "iBAN": "iBAN", "errorDescription": "errorDescription" } ], "sensitiveData": { "pan": "pan", "cvv2": "cvv2" }, "pendingReplaceApplicationExists": true, "pinStatus": "pinStatus", "cardStatusChangeChannel": "cardStatusChangeChannel", "securityFlag": true, "citizenshipNumber": "citizenshipNumber", "taxNumber": "taxNumber", "customerNameSurname": "customerNameSurname", "cardSeqNumber": 0, "isDelivered": true } ] }
json
application/json

isCustomerConvertToRipper

POST
https://sandboxpub.cms.dgpays.com/SandBox
/IntegrationDigitalChannelDebit/debit/api/isCustomerConvertToRipper

Checks whether a customer has any cards in the system. Accepts a CustomerNumber and returns flags indicating whether the customer has Credit, Debit, or Prepaid cards.

isCustomerConvertToRipper › Headers

evrst-ptrnid
​string

Correlation id for this request. Echo it in your own logs to trace the call through the platform.

Default: x_request_id

isCustomerConvertToRipper › Request Body

IsCustomerConvertToRipperRequest
customerNumber
​integer · int64 · min: 1 · required

Customer the question is asked about. The field is a non-nullable number, so omitting it is not the same as sending nothing: it arrives as zero and is refused as zero, naming CustomerNumber with the message CustomerNumber Invalid Value. A negative value is refused by a second check carrying the same message. There is no null check at all — absent and zero are one failure, not two.

isCustomerConvertToRipper › Responses

Success

IsCustomerConvertToRipperResponse
haveAnyDebitCard
​boolean · required

Always true. The service returns a constant here; it does not look at this customer's assets for this field.

haveAnyCreditCard
​boolean · required

The only field computed from the customer. true whenever the platform is not running the old system. While it is, true needs all three: the ShowCreditCardInNewVersion parameter set to Y, at least one of the customer's cards in the credit service domain, and no suppressed conversion card among them — a card whose converted shadow number is set and which is either hidden on mobile or in status B forces this to false on its own, whatever else the customer holds.

haveAnyPrepaidCard
​boolean · required

Always true. A constant, as haveAnyDebitCard is.

POST/IntegrationDigitalChannelDebit/debit/api/isCustomerConvertToRipper
curl https://sandboxpub.cms.dgpays.com/SandBox/IntegrationDigitalChannelDebit/debit/api/isCustomerConvertToRipper \ --request POST \ --header 'Content-Type: application/json' \ --header 'evrst-ptrnid: x_request_id' \ --header 'Authorization: Bearer <access_token>' \ --data '{ "customerNumber": 0 }'
Example Request Body
{ "customerNumber": 0 }
json
application/json
Example Responses
{ "haveAnyDebitCard": true, "haveAnyCreditCard": true, "haveAnyPrepaidCard": true }
json
application/json

getCustomerAssetsSummaryDebit

POST
https://sandboxpub.cms.dgpays.com/SandBox
/IntegrationDigitalChannelDebit/debit/api/getCustomerAssetsSummaryDebit

Retrieves a summarized list of debit card assets for a customer. Fetches card details, status, and related accounts. Uses _dcidRepository.GetCustomerAssetsSummaryDebit for card info, _dbtServiceProxy.ListCardAccountByShadowCardNumber for accounts, _coreBankingIntegrationOutdoor.GetAccountInformation for balances, and _cache for product and status descriptions. Filters out invalid or expired reissue cards and orders the list according to sort rules. Returns GetCustomerAssetsSummaryDebitResponse containing a list of GetCustomerAssetsSummaryDebitCardModel with card and account info.

getCustomerAssetsSummaryDebit › Headers

evrst-ptrnid
​string

Correlation id for this request. Echo it in your own logs to trace the call through the platform.

Default: x_request_id

getCustomerAssetsSummaryDebit › Request Body

GetCustomerAssetsSummaryDebitRequest
channelCode
​string · maxLength: 3 · required

Three-digit code identifying the channel on behalf of which the request is made (e.g. 002 for Internet). Mandatory in every request. Used for entitlement checks, limit enforcement and audit logging. Channel codes are managed through configuration parameters and may change over time. Refer to the Channels page for the current list of valid codes.

customerNumber
​integer · int64 · optional

The customer at the bank's core banking system, as a number. The platform stores it rather than issuing it, so it comes from the core.

getCustomerAssetsSummaryDebit › Responses

Success

GetCustomerAssetsSummaryDebitResponse
​array · optional

The cards the search matched.

POST/IntegrationDigitalChannelDebit/debit/api/getCustomerAssetsSummaryDebit
curl https://sandboxpub.cms.dgpays.com/SandBox/IntegrationDigitalChannelDebit/debit/api/getCustomerAssetsSummaryDebit \ --request POST \ --header 'Content-Type: application/json' \ --header 'evrst-ptrnid: x_request_id' \ --header 'Authorization: Bearer <access_token>' \ --data '{ "channelCode": "channelCode", "customerNumber": 0 }'
Example Request Body
{ "channelCode": "channelCode", "customerNumber": 0 }
json
application/json
Example Responses
{ "listOfCard": [ { "shadowCardNumber": "shadowCardNumber", "maskedCardNumber": "maskedCardNumber", "cardRefNumber": "cardRefNumber", "mainCardRefNumber": "mainCardRefNumber", "customerNumber": "customerNumber", "mainCustomerNumber": "mainCustomerNumber", "supplementaryCardFlag": true, "productNumber": "productNumber", "productName": "productName", "productShortName": "productShortName", "expiryDateStr": "expiryDateStr", "digitalCardFlag": true, "cardStatusCode": "cardStatusCode", "cardStatusCodeDescription": "cardStatusCodeDescription", "cardStatusReasonCode": "cardStatusReasonCode", "cardStatusReasonCodeDescription": "cardStatusReasonCodeDescription", "cardStatusChangeChannel": "cardStatusChangeChannel", "securityFlag": true, "cardAccountInfoList": [ { "accountNumber": 0, "cardAccountType": "cardAccountType", "accountType": "accountType", "accountSubType": "accountSubType", "accountBranchId": 0, "accountOrderFlag": true, "fecCode": 0, "currencyCode": "currencyCode", "balance": 0, "usableBalance": 0, "iBAN": "iBAN", "errorDescription": "errorDescription" } ] } ] }
json
application/json

Branch managementAccount linking