Jump to

• Request
• Response

Save payment data received through events

post

/service/v1/savePaymentData

This endpoint is used to save payment data received through events.

Request

Supported Media Types

• application/json
• application/xml

Header Parameters

• appId: string
  Application id
• branchCode: string
  Branch Code
• userId: string
  user id

Body ()

Payment DTO

Root Schema : PaymentDto

Type: object

Payment DTO

Show Source

• accOwner(optional): string
  Account Owner
• allocatedAmt(optional): number
  Allocated Payment Amount
• allocationRequired(optional): string
  Allocation Required
• allocStatus(optional): string
  Allocation Status
• autoReconcile(optional): string
  Auto Reconcile
• bankCode(optional): string
  Bank Code
• beneficiaryCode(optional): string
  Beneficiary Code
• beneficiaryId(optional): string
  Beneficiary Id
• beneficiaryName(optional): string
  Beneficiary Name
• beneficiaryRole(optional): string
  Beneficiary Role
• counterpartyCode(optional): string
  Counterparty Code
• counterpartyId(optional): string
  Counterparty Id
• counterpartyName(optional): string
  Counterparty Name
• counterpartyRole(optional): string
  Counterparty Role
• creditAccNo(optional): string
  Credit Account Number
• creditNoteRefNo(optional): string
  Credit Note Reference Number
• dcIndicator(optional): string
  Dc Indicator
• derivedFlag(optional): string
  Derived Flag
• eftRefNo(optional): string
  Eft Reference Number
• entityRefNo(optional): string
  Entity Reference Number
• errorDesc(optional): string
  Error Description
• excessHandling(optional): string
• excessRefundParty(optional): string
• excessRefundPartyId(optional): string
• excessRefundPaymentMode(optional): string
• fileName(optional): string
  File Name
• filler1(optional): string
  Filler 1
• filler10(optional): string
  Filler 10
• filler2(optional): string
  Filler 2
• filler3(optional): string
  Filler 3
• filler4(optional): string
  Filler 4
• filler5(optional): string
  Filler 5
• filler6(optional): string
  Filler 6
• filler7(optional): string
  Filler 7
• filler8(optional): string
  Filler 8
• filler9(optional): string
  Filler 9
• financeReferenceNo(optional): string
• flag(optional): string
  Flag
• genericAppropriation(optional): string
  Generic Appropriation
• indicator(optional): string
  Indicator
• instrumentBank(optional): string
  Instrument Bank
• instrumentBranch(optional): string
  Instrument Branch
• instrumentDate(optional): string
  Instrument Date
• isAutoAuth(optional): string
• isIndirectPayment(optional): string
• isPUA(optional): string
• isRecon(optional): string
• lastActionPerformed(optional): string
  Last Action Performed
• mandateRefNo(optional): string
  Mandate Reference Number
• matchedAmount(optional): number
  Matched Amount
• parentPaymentRefNo(optional): string
• partyPaymentCode(optional): string
  Party Payment Code
• paymentAmount(optional): number
  Payment Amount
• paymentBusinessDate(optional): string
  Payment Business Date
• paymentCurrency(optional): string
  Payment Currency
• paymentDate(optional): string
  Payment Date
• paymentMode(optional): string
  Payment Mode
• paymentNumber(optional): string
  Payment Number
• paymentPartyCategory(optional): string
  Payment Party Category
• paymentPartyId(optional): string
  Payment Party Id
• paymentPartyName(optional): string
  Payment Party Name
• paymentPartyRole(optional): string
  Payment Party Role
• paymentProcessStatus(optional): string
  Payment Process Status
• paymentRefNo(optional): string
  Payment Reference Number
• paymentStatus(optional): string
  Payment Status
• procBranchCode(optional): string
  Proc Branch Code
• procBranchDate(optional): string
  Proc Branch Date
• programCode(optional): string
  Program Code
• reasonCode(optional): string
  Reason Code
• reconciledPmtAmt(optional): number
• reconTxnStatus(optional): string
  Recon Transaction Status
• refundAmount(optional): number
• relationshipCode(optional): string
  Relationship Code
• remarks(optional): string
  Remarks
• remitterAccNo(optional): string
  Remitter Account Number
• seqNo(optional): integer(int64)
  Sequence Number
• sourceTxnId(optional): string
  Recon Txn Number
• specificAppropriation(optional): string
  Specific Appropriation
• totalAllocatedAmt(optional): number
• transactionRefNo(optional): string
  Transaction Reference Number
• transactionStatus(optional): string
• unallocatedAmt(optional): number
  Unallocated Payment Amount
• unmatchedAmount(optional): number
  Unmatched Amount
• virtualAcFlag(optional): string
  Virtual Account Flag

{
    "description":"Payment DTO",
    "type":"object",
    "properties":{
        "bankCode":{
            "type":"string",
            "description":"Bank Code"
        },
        "beneficiaryCode":{
            "type":"string",
            "description":"Beneficiary Code"
        },
        "beneficiaryId":{
            "type":"string",
            "description":"Beneficiary Id"
        },
        "beneficiaryName":{
            "type":"string",
            "description":"Beneficiary Name"
        },
        "creditAccNo":{
            "type":"string",
            "description":"Credit Account Number"
        },
        "creditNoteRefNo":{
            "type":"string",
            "description":"Credit Note Reference Number"
        },
        "eftRefNo":{
            "type":"string",
            "description":"Eft Reference Number"
        },
        "entityRefNo":{
            "type":"string",
            "description":"Entity Reference Number"
        },
        "filler1":{
            "type":"string",
            "description":"Filler 1"
        },
        "filler2":{
            "type":"string",
            "description":"Filler 2"
        },
        "filler3":{
            "type":"string",
            "description":"Filler 3"
        },
        "filler4":{
            "type":"string",
            "description":"Filler 4"
        },
        "flag":{
            "type":"string",
            "description":"Flag"
        },
        "indicator":{
            "type":"string",
            "description":"Indicator"
        },
        "instrumentBank":{
            "type":"string",
            "description":"Instrument Bank"
        },
        "instrumentBranch":{
            "type":"string",
            "description":"Instrument Branch"
        },
        "instrumentDate":{
            "type":"string",
            "description":"Instrument Date"
        },
        "mandateRefNo":{
            "type":"string",
            "description":"Mandate Reference Number"
        },
        "paymentAmount":{
            "type":"number",
            "description":"Payment Amount"
        },
        "paymentCurrency":{
            "type":"string",
            "description":"Payment Currency"
        },
        "paymentDate":{
            "type":"string",
            "description":"Payment Date"
        },
        "paymentMode":{
            "type":"string",
            "description":"Payment Mode"
        },
        "paymentNumber":{
            "type":"string",
            "description":"Payment Number"
        },
        "paymentPartyId":{
            "type":"string",
            "description":"Payment Party Id"
        },
        "paymentPartyName":{
            "type":"string",
            "description":"Payment Party Name"
        },
        "paymentProcessStatus":{
            "type":"string",
            "description":"Payment Process Status"
        },
        "paymentRefNo":{
            "type":"string",
            "description":"Payment Reference Number"
        },
        "paymentStatus":{
            "type":"string",
            "description":"Payment Status"
        },
        "programCode":{
            "type":"string",
            "description":"Program Code"
        },
        "remarks":{
            "type":"string",
            "description":"Remarks"
        },
        "remitterAccNo":{
            "type":"string",
            "description":"Remitter Account Number"
        },
        "fileName":{
            "type":"string",
            "description":"File Name"
        },
        "reasonCode":{
            "type":"string",
            "description":"Reason Code"
        },
        "matchedAmount":{
            "type":"number",
            "description":"Matched Amount"
        },
        "unmatchedAmount":{
            "type":"number",
            "description":"Unmatched Amount"
        },
        "reconTxnStatus":{
            "type":"string",
            "description":"Recon Transaction Status"
        },
        "isAutoAuth":{
            "type":"string"
        },
        "virtualAcFlag":{
            "type":"string",
            "description":"Virtual Account Flag"
        },
        "filler5":{
            "type":"string",
            "description":"Filler 5"
        },
        "filler6":{
            "type":"string",
            "description":"Filler 6"
        },
        "filler7":{
            "type":"string",
            "description":"Filler 7"
        },
        "filler8":{
            "type":"string",
            "description":"Filler 8"
        },
        "filler9":{
            "type":"string",
            "description":"Filler 9"
        },
        "filler10":{
            "type":"string",
            "description":"Filler 10"
        },
        "genericAppropriation":{
            "type":"string",
            "description":"Generic Appropriation"
        },
        "specificAppropriation":{
            "type":"string",
            "description":"Specific Appropriation"
        },
        "partyPaymentCode":{
            "type":"string",
            "description":"Party Payment Code"
        },
        "counterpartyCode":{
            "type":"string",
            "description":"Counterparty Code"
        },
        "autoReconcile":{
            "type":"string",
            "description":"Auto Reconcile"
        },
        "counterpartyId":{
            "type":"string",
            "description":"Counterparty Id"
        },
        "counterpartyName":{
            "type":"string",
            "description":"Counterparty Name"
        },
        "paymentBusinessDate":{
            "type":"string",
            "description":"Payment Business Date"
        },
        "seqNo":{
            "type":"integer",
            "description":"Sequence Number",
            "format":"int64"
        },
        "transactionRefNo":{
            "type":"string",
            "description":"Transaction Reference Number"
        },
        "transactionStatus":{
            "type":"string"
        },
        "beneficiaryRole":{
            "type":"string",
            "description":"Beneficiary Role"
        },
        "counterpartyRole":{
            "type":"string",
            "description":"Counterparty Role"
        },
        "paymentPartyRole":{
            "type":"string",
            "description":"Payment Party Role"
        },
        "relationshipCode":{
            "type":"string",
            "description":"Relationship Code"
        },
        "errorDesc":{
            "type":"string",
            "description":"Error Description"
        },
        "paymentPartyCategory":{
            "type":"string",
            "description":"Payment Party Category"
        },
        "derivedFlag":{
            "type":"string",
            "description":"Derived Flag"
        },
        "allocationRequired":{
            "type":"string",
            "description":"Allocation Required"
        },
        "allocStatus":{
            "type":"string",
            "description":"Allocation Status"
        },
        "allocatedAmt":{
            "type":"number",
            "description":"Allocated Payment Amount"
        },
        "unallocatedAmt":{
            "type":"number",
            "description":"Unallocated Payment Amount"
        },
        "accOwner":{
            "type":"string",
            "description":"Account Owner"
        },
        "procBranchCode":{
            "type":"string",
            "description":"Proc Branch Code"
        },
        "procBranchDate":{
            "type":"string",
            "description":"Proc Branch Date"
        },
        "isPUA":{
            "type":"string"
        },
        "isIndirectPayment":{
            "type":"string"
        },
        "lastActionPerformed":{
            "type":"string",
            "description":"Last Action Performed"
        },
        "dcIndicator":{
            "type":"string",
            "description":"Dc Indicator"
        },
        "sourceTxnId":{
            "type":"string",
            "description":"Recon Txn Number"
        },
        "reconciledPmtAmt":{
            "type":"number"
        },
        "totalAllocatedAmt":{
            "type":"number"
        },
        "isRecon":{
            "type":"string"
        },
        "financeReferenceNo":{
            "type":"string"
        },
        "excessHandling":{
            "type":"string"
        },
        "excessRefundParty":{
            "type":"string"
        },
        "excessRefundPartyId":{
            "type":"string"
        },
        "excessRefundPaymentMode":{
            "type":"string"
        },
        "parentPaymentRefNo":{
            "type":"string"
        },
        "refundAmount":{
            "type":"number"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json
• application/xml

201 Response

Successfully received payment details

Body ()

Root Schema : schema

Type: boolean

400 Response

Malformed syntax.

401 Response

Request does not have sufficient credentials.

403 Response

Request is not authorized.

405 Response

Invalid input

500 Response

Internal error

Back to Top