DCM Platform Guide
  • 🌐DCM platform
  • ⚙️Specifics of working with the API
    • 🔐Security stack
    • 🔑Key Generation
    • 🔐Data encrypting
    • 🪃Retry policy
  • 🎨Design guide
  • 🗂️DCM platform's artifacts
  • 🏦Bank
    • 📋Preparing for integration
    • 🏪E-commerce
      • 📦Order and payment
      • 📨Payment message
        • 1️⃣Validation
        • 2️⃣Сallback 1 “Pay-in”
        • 3️⃣Callback 3 “Pay-out”
        • 4️⃣Callback 4 "Credit callback"
      • 🎯Testing
      • 🖇️Merchant Onboarding
      • ⛔Error reference guide
    • 🗃️Alias database
      • 🗝️Adding alias
      • ↕️"Сallback "Alias updated"
      • ☑️Get alias status
    • 💸p2p transfers
      • 📲p2p by phone number
        • ⏺️p2p order (to pay)
        • 🔍Receiver search
        • 🗂️Get receiver's data
        • ⏪Callback "Pay request"
      • 🖇️p2p by deeplink or QR code
        • ⏺️p2p order (to request)
        • Pay request initiation
      • 📨Payment message
        • 1️⃣Validation
        • 2️⃣Сallback “Pay-in”
        • 3️⃣Callback "Pay-out"
    • 💲Gross settlement
      • 1️⃣Callback “Gross_Settlement”
      • 2️⃣Gross_settlement_list
      • 3️⃣Gross_settlement_by_id
      • 4️⃣Gross_settlement_pay
      • 5️⃣Gross_settlement_confirm
      • 6️⃣Gross_settlement_confirm_internal
      • 📧Email notification
    • ✔️Reconciliation
  • 🏢Merchant
    • 🏫DCM platform for Merchants
      • 🔠Integration options
    • 👨‍🏫Preparing for integration
      • ⚙️Working with the API
      • 🔑Key Generation
      • 🖥️Updating interfaces
    • 🏪E-commerce
      • 📦Order
        • 💵Payment through the DCM platform
        • 💳Payment on the Merchant's website
        • 📋Emitters
        • 📬Order status
      • 1️⃣Сallback "Pay-in"
  • 📑Document data
    • 🆕Version history
    • 📃Change log
Powered by GitBook
On this page
  1. Bank
  2. p2p transfers
  3. Payment message

Validation

Upon receiving a Payment Message creation request, the DCM platform performs a comprehensive verification and validation of the request's key attributes. If any issues are detected, the system provides a response detailing the identified errors.

Error list:

Сode 400:

  • "INVALID_DEBTOR_ACCOUNT"

  • "INVALID_CREDITOR_ACCOUNT"

  • "INVALID_NONCE"

  • "INVALID_ENCRYPTED_KEY"

  • "INVALID_DEBTOR_NAME"

  • "INVALID_DEBTOR_ID"

  • "INVALID_DEBTOR_PHONE"

  • "INVALID_CREDITOR_ID"

  • "INVALID_CREDITOR_NAME"

  • "INVALID_CURRENCY"

  • "UNSUPPORTED_CURRENCY"

  • "ORDER_NOT_FOUND"

  • "SENDER_COUNTERPARTY_NOT_FOUND"

  • "RECEIVER_COUNTERPARTY_NOT_FOUND"

  • "EXTERNAL_ID_IS_ALREADY_TAKEN"

  • "ORDER_IS_EXPIRED"

  • "INVALID_EXTERNAL_ID"

  • "INVALID_AMOUNT"

  • "INVALID_PURPOSE"

  • "INVALID_CREATION_DATE"

  • "INVALID_CREATION_TIME"

  • "CREATION_DATE_IS_NOT_PAST"

  • "INVALID_REQUEST"

Code 401:

  • "AUTHORIZATION_FAILED"

Code 500

  • "INTERNAL_ERROR"

Examples of the Most Common error Responses:

Duplicate Payment Message with the same Order Details

If it exists, response:

{
    “error”: “payment message with provided order id already exists”,
    “payment_message_guid”: “10f6e03c-7769-4d83-a600-fa642f856105"
}

Duplicate Payment Message with the Same JTI

If it exists, response:

{
    “error”: “payment message with provided jti already exists”,
    “payment_message_guid”: “fc436ab7-0cc0-47fb-801e-4ab86f3c5e00"
}

Upon successful creation, the DCM platform sends cascading callbacks in JWT format to all involved participants:

  • Callback: "Pay-in" — sent to the Recipient Bank.

  • Callback: "Pay-out" — sent to the Initiator Bank.

PreviousPayment messageNextСallback “Pay-in”

Last updated 3 months ago

🏦
💸
📨
1️⃣