6.6 Consumer Services - Oracle Banking Payments

This topic describes about the consumer services required for Oracle Banking Payments Implementation.

The below endpoints must be configured under Consumer Services in Oracle Banking Routing Hub:
  1. CreatePMSinglePayOut
  2. CreateExternalConsumerLoan

Figure 6-6 Consumer Services - Payments



CreatePMSinglePayOut

This API enables the user to get the incoming payment details which is used for Invoice Payment Reconciliation during Auto and Manual reconciliation. This API is called from finance service and instruments.

SERVICE-CONSUMER = “OBSCFCM_OBPM”

SERVICE-CONSUMER-SERVICE= “CreatePMSinglePayOut”

Request:

{  
  "serviceConsumerServiceName" : "CreatePMSinglePayOut",
  "body" : {
    "externalBankName" : "BANK123123",
    "obpmBranchCode" : "240",
    "seqNo" : 2,
    "programCode" : "RFPRG",
    "processingDate" : "2022-11-02",
    "drAcType" : 10,
    "mmbId" : "IFSC123123",
    "branchCode" : "004",
    "sourceCode" : "EXTSYS",
    "externalBranchName" : "BRANCH123123",
    "financeRefNo" : "004160324PAY20961",
    "userRef" : "2022-11-0217876",
    "beneName" : "RFPDBUYER",
    "accPartyId" : "202295",
    "networkCode" : "NEFT",
    "ccyOfTrf" : "USD",
    "externalAccount" : "123123",
    "hostCode" : "INDIA",
    "drAcNo" : "988623101",
    "sourceRef" : "2022-11-0217876",
    "remittanceInfo" : "004160324PAY20961",
    "accountingTransaction" : {
      "1" : {
        "seqNo" : 1,
        "accountingEntryCode" : "EXREFUND_RFND_API",
        "errorCode" : null,
        "accRoleCode" : "CR-RFPD",
        "externalBranchName" : null,
        "financeRefNo" : null,
        "exchangeRate" : 1,
        "accountNo" : "US18979797854",
        "accPartyType" : "BENEFICIARY",
        "id" : "1218566755892604928",
        "accType" : "C",
        "accEntryDesc" : "EXREFUND_RFND_API",
        "amountType" : "EXCESS_REFUND_AMOUNT",
        "externalBankName" : null,
        "amount" : 200,
        "errorDesc" : null,
        "eventSrNo" : 1,
        "paymentMode" : null,
        "drCrIndicator" : "D",
        "ecaRefNo" : null,
        "accSettMethod" : "CUST_A/C",
        "amountCcy" : "USD",
        "eventCode" : "EXCESS_REFUND",
        "accountCcy" : "USD",
        "accPartyId" : "202296",
        "externalAccountCcy" : null,
        "externalAccount" : null,
        "accEntrySeq" : 1,
        "accRoleDesc" : "CR-RFPD",
        "externalBankId" : null,
        "amountAccCcy" : 200,
        "externalBranchCode" : null,
        "routingCode" : null,
        "status" : "SUCCESS"
      },
      "2" : {
        "seqNo" : 1,
        "accountingEntryCode" : "EXREFUND_RFND_API",
        "errorCode" : null,
        "accRoleCode" : "CR-RFPD",
        "externalBranchName" : "BRANCH123123",
        "financeRefNo" : null,
        "exchangeRate" : 1,
        "accountNo" : "988623101",
        "accPartyType" : "PAYMENT_PARTY",
        "id" : "1218566755913576448",
        "accType" : "C",
        "accEntryDesc" : "EXREFUND_RFND_API",
        "amountType" : "EXCESS_REFUND_AMOUNT",
        "externalBankName" : "BANK123123",
        "amount" : 200,
        "errorDesc" : null,
        "eventSrNo" : 1,
        "paymentMode" : "EFT",
        "drCrIndicator" : "C",
        "ecaRefNo" : null,
        "accSettMethod" : "NEFT",
        "amountCcy" : "USD",
        "eventCode" : "EXCESS_REFUND",
        "accountCcy" : "USD",
        "accPartyId" : "202295",
        "externalAccountCcy" : "USD",
        "externalAccount" : "123123",
        "accEntrySeq" : 1,
        "accRoleDesc" : "CR-RFPD",
        "externalBankId" : "bankId",
        "amountAccCcy" : 200,
        "externalBranchCode" : null,
        "routingCode" : "IFSC123123",
        "status" : "SUCCESS"
      }
    },
    "instdAmt" : 200,
    "startDate" : "2022-11-02"
  },
  "serviceConsumerName" : "OBSCFCM_OBPM"
}

Response:

{
    "headers": {},
    "body": {
        "data": {
            "sourceCode": "999",
            "txnRefNo": "999",
            "status": "SUCCESS"
        },
        "messages": {
            "keyId": null,
            "status": "SUCCESS",
            "codes": [],
            "requestId": null,
            "httpStatusCode": "OK",
            "overrideAuthLevelsReqd": null
        }
    }
}

CreateExternalConsumerLoan

This API enables the user to transfer the finance data to payments. This API is called from finance service and instruments.

SERVICE-CONSUMER = “OBSCFCM_OBPM”

SERVICE-CONSUMER-SERVICE= “CreateExternalConsumerLoan”

Request
{
  
  "serviceConsumerServiceName" : "CreateExternalConsumerLoan",
  "body" : {
    "branchCode" : "004",
    "accountStatus" : "A",
    "accountCcy" : "USD",
    "sourAccBrn" : "240",
    "sourceSystem" : "OBSCF",
    "loanAccNum" : "INV0645",
    "custId" : "000380",
    "loanBrn" : "004",
    "hostCode" : "INDIA",
    "sourcCustAcc" : "INV0645",
    "paymentRequest" : {
      "invoiceId" : "2022040400000000000000000000000000000404",
      "amount" : 3026626,
      "totalInvoiceAmount" : 3026626,
      "buyerId" : "000380",
      "buyerName" : "Carrefour",
      "buyerDivCode" : null,
      "buyerDivName" : null,
      "currency" : "USD",
      "invoiceDate" : "2022-04-04",
      "dueDate" : "2022-07-30",
      "invoiceNumber" : "ETVTS/NOV22/0128",
      "repaymentAccNo" : null,
      "refNo" : "INV0645",
      "invAcceptanceDate" : "2022-04-04",
      "status" : "UNPAID",
      "programCode" : null,
      "programName" : null,
      "paymentTerms" : null,
      "supplierId" : "000381",
      "supplierName" : "Danone",
      "supplierDivCode" : null,
      "supplierDivName" : null,
      "relationCode" : "REL701",
      "supplierCode" : null,
      "buyerCode" : null,
      "virtualAcFlag" : null,
      "branchCode" : "004",
      "debtor" : null,
      "debtorName" : null,
      "customerId" : "000380"
    }
  },
  "serviceConsumerName" : "OBSCFCM_OBPM"
}
Response:
{
    "headers": {},
    "body": {
        "data": {
            "sourceCode": "999",
            "loanAccNumber": "10101",
            "status": "SUCCESS"
        },
        "messages": {
            "keyId": null,
            "status": "SUCCESS",
            "codes": [],
            "requestId": null,
            "httpStatusCode": "OK",
            "overrideAuthLevelsReqd": null
        }
    }