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. p2p by phone number

Callback "Pay request"

Upon receiving the data from the GET /creditor's_data request, the DCM platform sends a "Pay request" callback to the initiating bank (in addition to the response regarding order creation). The structure of the callback depends on whether recipient information is available or not:

Recipient information is available

The callback payload includes a Success status

{
"order_guid": "123e4567-e89b-12d3-a456-426614174000",
"creditor": {
"name": "John Doe Enterprises", (encrypted data)
"tax_number": "54321", (encrypted data)
"account": "DE89370400440532013000", 
"encryption": {
"nonce": "random_nonce_value", 
"encrypted_key": "encrypted_key_value",
"public_key": {
"kty": "RSA", // Key type
"kid": "example-key-id", // Key identifier
"alg": "RS256", // Algorithm
"n": "modulus_value_here", // Modulus 
"e": "exponent_value_here" // Exponent
}
},
"agent": {
"bic": "DEUTDEDBXYZ",
"public_key": { 
"kty": "RSA",
"kid": "another-key-id",
"alg": "RS256", "n": "another_modulus_value_here",
"e": "another_exponent_value_here"
}
}
},
"pay_request_guid": "987e6543-e21b-12d3-a456-426614174001", 
"status": "completed", 
"debtor": {
"account": "DE89370400440532013000" 
}
}

Recipient information is absent

The callback payload includes a Failed status

{ 
"order_guid": "123e4567-e89b-12d3-a456-426614174000", 
"reason": "pay request is failed", 
"pay_request_guid": "987e6543-e21b-12d3-a456-426614174001", 
"status": "failed", 
"debtor": { 
"account": "DE89370400440532013000" 
  } 
}

The following steps are identical for all P2P transfer scenarios, namely:

  • Payment message initiation by the initiating bank

  • Processing of the "Pay-in" callback by the recipient's bank

  • Processing of the "Pay-out" callback by the initiating bank

  • Handling and payment of Gross Settlement Register (GSR)

PreviousGet receiver's dataNextp2p by deeplink or QR code
🏦
πŸ’Έ
πŸ“²
βͺ