Category links

API Links

Post Single Transaction

Action: POST

Endpoint: /api/CoreCredit/Transactions/PostSingleTransaction

Use this API to post any transaction by selecting the appropriate transaction code. The API permits posting of all transaction types, including debit, credit, fees, and post-payments, by selecting the invoice ID. Furthermore, the API can be used to reverse any transaction.

Note

You can also add a user-defined description which can be referred to in the future.

Request fields details
Fields Description

Source

string

Mandatory

Source of API Consumer For external system expected sources will be WEB.

Allowable Values:

50

IPAddress

string

Optional

IP Address of Client / Application Hosting Server Example: 10.206.0.204

Allowable Values:

15

DateFormat

string

Optional

Place Holder for Future Use. Values are: 1 : MM/dd/yyyy HH:MM:SS (Default) 2 : MM/dd/yy HH:MM:SS 3 : dd/MM/yyyy HH:MM:SS

Allowable Values:

25

CurrencyCode

string

Optional

Currency Code Place Holder for Future Use. Valid Values: Refer Appendix Section - Currency Code Example:840 = US Dollar Condition:If no value is passed, default value = 840

Allowable Values:

10

CurrencySymbolType

string

Optional

Place Holder for Future Use. CurrencySymbolType: 1: Currency Sign like $ 2: 3 ALPHA Currency Code like USD

Allowable Values:

10

Language

string

Optional

Place Holder for Future Use. Language: en: means use English Default: en - English

Allowable Values:

10

ExternalIP

string

Mandatory

IP Address of end user of API

Allowable Values:

50

SessionID

string

Optional

Session identifier of the API Example: 000028;026;1349906692

Allowable Values:

100

APIVersion

string

Mandatory

Version of the API to be invoked. Example: 2.0 API Version Current Version 2.0

Allowable Values:

10

CallerID

string

Optional

Caller ID of source from where API is initiated it is End User Caller ID Example: 7204454214 (phone number applicable in Case of IVR)

Allowable Values:

20

CalledID

string

Optional

Called ID of destination for which API is initiated It is Destination Called ID Example: 7314145404 (phone number applicable in Case of IVR)

Allowable Values:

20

RequestTime

datetime

Optional

Request Date Time of API Format: MM/dd/yyyy HH:mm:ss Example:01/15/2020 10:05:23

StoreID

integer

Optional

Unique Number which is assgined to a Store. Valid Values:0-9 Example:1234

RegisterID

string

Optional

Unique ID assigned to a Register. Valid Values:a-z 0-9 Example:123456

Allowable Values:

50

AccountNumber

string

Conditional

Card Holder's Account Number. Valid Values: 0-9 Format:XXXXXXXXXXXXXXXX Example:1236547896325874 Condition:At least one of AdminNumber/AccountNumber is required.

Allowable Values:

19

TransactionCurrencyCode

string

Mandatory

Currency code corresponding to the Transaction Amount. Valid Values:840 for US Dollar Example:840

Allowable Values:

3

TransactionDescription

string

Optional

User defined description of transaction if entered by user explicitly. If not entered by the user, then system will generate it. Valid Values:A-Z,0-9 Example:Purchase/Payment.

Allowable Values:

100

TransactionCode

string

Mandatory

A code to identify type of payment. Valid Values: The valid values of Transaction Code can be fetched from GetTranCodeByUserID API. Example:427248 = Principal Adjustment

Allowable Values:

20

ProductCode

string

Optional

Specific code assigned to the product. Valid Values: Refer Section 5.47 of Appendix Example: 12456

Allowable Values:

50

SettlementDate

DateTime

Optional

Date of Settlement. Valid Values:0-9 Format: MM/dd/yyyy HH:mm:ss Example:01/15/2020 10:05:23

TransactionAmount

decimal

Mandatory

Amount of Transaction. Valid Values:0-9 Format:XXX.XX Example:500.00

CreditPlanMaster

string

Optional

Plan name associated with the card account. Valid Values: 0-9 Example:6051

Allowable Values:

50

PaymentReferenceID

string

Optional

Refernce ID of the Payment. Valid Values:0-9, A-z Format:XXXXXXXXXXX Example:fy76869878gh

Allowable Values:

36

TransmissionDateTime

DateTime

Optional

Time of transaction. Valid Values:0-9 Format:MM-DD-YYYTHH:mm:ss Example:12-30-2015T13:05:10

EffectiveDateTime

DateTime

Optional

Effective Date of Transaction Valid Values:01/15/2020 Format: MM/dd/yyyy HH:mm:ss Example:01/15/2020 10:05:23

MerchantType

string

Optional

Type of Merchant Valid Values:a-z Example: Retail,Hospital

Allowable Values:

50

AdminNumber

int64

Conditional

Details can be obtained by admin number (Embossing Acctid). Valid Values:0-9 Example:7485122 Condition:At least one of AdminNumber/AccountNumber is required.

ReversalTargetTranID

string

Optional

Transaction number of target transaction which is going to be reversed. Valid Values: 0-9 Example:12345

Allowable Values:

20

ReturnTransactionID

int64

Optional

Transaction ID generated for The Return Transaction. Valid Values:0-9 Example:122390308

MethodName

string

Optional

Method Name uniquely identifies bank accounts in Core card system. Whenever user adds any bank account.This is required If User wants to send transaction in ACH. Valid Values:0-9 Example:4092

Allowable Values:

25

MerchantNumber

string

Optional

Number which is assigned to a Merchant. Valid Values: 0-9 Example:11642

Allowable Values:

9

InvoiceNumber

string

Optional

Incoice Number for Transaction. Valid Values: A-Z 0-9 Example: AB987567757

Allowable Values:

50

FeeReversalReason

string

Optional

Reason for Fee Reversal. Valid Values: 0 - Customers Goodwill , 1- Erroneous charges Example: 0 - Customers Goodwill

Allowable Values:

1

CheckNumber

string

Optional

Number of the Payment Check. Valid Values:0-9 Format:XXXXXXXX Example:89874545

Allowable Values:

15

IdentifierToken

string

Conditional

A generated token that is not expired can be used as an input field to access API. If we are passing this field in input, user should not pass any other account identifier. Condition:At least one account identifier is required.

Allowable Values:

800

AllowForcePost

string

Optional

To Force Post a Transaction. Valid Values: 0,1 Format: X Example: 0 = No, 1 = Yes

UniqueId

string

Optional

Unique ID is a transaction specific unique ID. This ID is unique for every transaction. If multiple calls are made by client for a specific transaction, the value of this tag will always be the same for a specific transaction. (GUID and UUID datatypes are supported for this tag). Valid Values: A-Z, 0-9 Example: F965C56F-C58F-EC11-B80E-A4BF010A357E Condition:For API user, if API Idempotency Applicable is set as Yes on CoreCredit, field is mandatory. The UniqueId is valid for 7 days from first submission of the request. Same request can be retried for 7 days without performing the same action twice.Idempotency will be checked at the belongingOwning Partner and Merchant Level.

Allowable Values:

40

InterestPlanID

integer

Optional

Interest Plan Id defined on Interest Tables. Valid Values :0-9, A-z Example: 1233 Condition: Interest Plan Override setup should be enabled at Plan

Sample request body
{
  "Source": "Web",
  "IPAddress": "10.120.0.1",
  "DateFormat": null,
  "CurrencyCode": null,
  "CurrencySymbolType": null,
  "Language": null,
  "ExternalIP": "10.120.0.0",
  "SessionID": null,
  "APIVersion": "2.0",
  "CallerID": null,
  "CalledID": null,
  "RequestTime": null,
  "MerchantNumber": "25636",
  "StoreID": 25637,
  "RegisterID": null,
  "TransactionCode": "34292",
  "EffectiveDateTime": null,
  "AccountNumber": "9000000900001737",
  "AdminNumber": 101055,
  "TransactionAmount": 53.21,
  "CreditPlanMaster": "21701",
  "TransactionDescription": null,
  "TransactionCurrencyCode": "840",
  "MerchantType": null,
  "InvoiceNumber": null,
  "ReversalTargetTranID": "0",
  "ProductCode": null,
  "ReturnTransactionID": null,
  "MethodName": "0",
  "SettlementDate": null,
  "FeeReversalReason": null,
  "PaymentReferenceID": null,
  "CheckNumber": null,
  "TransmissionDateTime": null,
  "IdentifierToken": null,
  "AllowForcePost": "0",
  "UniqueId": null,
  "InterestPlanID": 1233
}
Response fields details
Fields Description

CreditPlanMaster

string

Plan name associated with the card account. Valid Values: 0-9 Example:6051

Allowable Values:

50

PostingReference

string

Posting reference (Like -Transaction Posted Successfully)

Allowable Values:

100

PostingFlag

string

With certain IDs in response, It confirms the posting of transaction. Example:1 = Success,0 failed

Allowable Values:

1

TransactionAmount

decimal

Amount of Transaction. Valid Values: 0-9 Example:500.00

AccountNumber

string

Card Holder's Account Number. Valid Values: 0-9 Format:XXXXXXXXXXXXXXXX Example:1236547896325874

Allowable Values:

19

AdminNumber

int64

Details can be obtained by admin number (Embossing Acctid). Valid Values:0-9 Example:7485122

TransactionID

int64

Transaction Number for the transaction being posted. Valid Values:0-9 Example:23654789

ResponseID

string

This number indicates that API responded. Response ID is unique. This value will be null if no authentication information was passed. Response ID can be used for tracking Valid Values:0-9 Example:478585

Allowable Values:

15

StoreID

integer

Specific code assigned to a Store. Valid Values:0-9 Example:1234

TransactionCurrencyCode

string

Currency code corresponding to the Transaction Amount. Valid Values:840 for US Dollar Example:840

Allowable Values:

3

PostingDateTime

datetime

Date and Time of posting of the transaction. Format: MM/dd/yyyy HH:mm:ss Example:01/15/2020 10:05:23

TransactionDescription

string

User defined description of transaction if entered by user explicitly. If not entered by the user, then system will generate it. Valid Values:A-Z,0-9 Example:Purchase/Payment.

Allowable Values:

100

TransactionCode

string

A code to identify type of payment. Valid Values: A-Z 0-9 Example:427248 = Principal Adjustment

Allowable Values:

20

TransmissionDateTime

datetime

Time of transaction. Valid Values:0-9 Format:MM-DD-YYYTHH:mm:ss Example:12-30-2015T13:05:10

CurrencySymbol

string

This tag reflects the currency symbol

Sample response body

{
  "Message": "Transaction posted successfully",
  "Status": true,
  "ErrorCode": "ERR01058",
  "ResponseData": {
    "CreditPlanMaster": "21701",
    "PostingReference": null,
    "PostingFlag": null,
    "TransactionAmount": 53.21,
    "AccountNumber": "9000000900001737",
    "AdminNumber": 101055,
    "TransactionID": null,
    "ResponseID": "108410544",
    "StoreID": 25637,
    "TransactionCurrencyCode": "840",
    "PostingDateTime": null,
    "TransactionDescription": "45454 = INITIAL CHARGE OFF REVERSAL",
    "TransactionCode": "34292",
    "TransmissionDateTime": null,
    "InterestPlanID": null
  }
}