Skip to main content

Class CreditTransferAPIRequest


Properties

NAMETYPEREQUIREDDESCRIPTION
Resource/{version}/institutions/{rtnnumber}/environments/{envname}/products/paycenter/networks/rtp/credit-transfers
Request MethodHTTP POST
Response formatJSON
Content Typeapplication/jsonYesSpecify this as a “Content-Type” header property
AuthorizationBearer access_tokenYesSpecify this as a “Authorization” header property and pass OAuth 2.0 access token

Path parameters

ParameterTYPEREQUIREDDescription
rtnnumberstringYesDebtor Financial Institution Routing Number
envnameStringYesDenotes environment name where the API referred

Possible values
  • SANDBOX
  • PROD

Fields (Debtor section)

NameTYPEREQUIREDDescription
AccountNumberstringYesDebtor routing number.
NameStringUltimate debtor name.

CreditTransfer.Debtor.UltimateDebtor.Name

Fields (Creditor section)

NameTYPEREQUIREDDescription
NamestringYesCreditor name.

CreditTransfer.Creditor.Name
RoutingNumberstringYesCreditor Routing number.

CreditTransfer.Creditor.RoutingNumber
AccountNumberstringYesCreditor account number.

CreditTransfer.Creditor.AccountNumber
NamestringUltimate creditor name.

CreditTransfer.Creditor.UltimateCreditor.Name

Fields (CreditTransfer Description section)

NameTYPEREQUIREDDescription
AmountNumber (double- precision format)YesAmount to be transferred.

CreditTransfer.CreditTransferDescription.Amount
OriginatorTypestringYesDefine Originator type.

Enum values: BUSINESS, CONSUMER

Rule:
  • For CONSUMER, none of the ultimate fields should be supplied
  • For BUSINESS, ultimate fields can be supplied


CreditTransfer.CreditTransferDescription.OriginatorType
UserNamestringYesDefine the Name of the User Invoking the API

CreditTransfer.CreditTransferDescription.UserName
NotesstringFree text. Notes for credit transfer.

CreditTransfer.CreditTransferDescription.Notes

Request body - JSON representation

{
"CreditTransfer": {
"Debtor": {
"AccountNumber": string,
"UltimateDebtor": {
"Name": string
}
},
"Creditor": {
"Name": string,
"RoutingNumber": string,
"AccountNumber": string,
"UltimateCreditor": {
"Name": string
}
},
"CreditTransferDescription": {
"Amount": number,
"OriginatorType": enum (type),
"UserName": string,
"Notes": string
}
}
}

Sample Request 1: OriginatorType - BUSINESS

POST /v1/institutions/111025466/environments/sandbox/products/paycenter/networks/rtp/credit-transfers HTTP/1.1
Host: wag01.eagle.jhapaycenter.com
Authorization: Bearer EXJ8NG95eDBKa1B.........Yzh5M1ZyZnNlNUVjyjmk
Content-Type: application/json

Request Body

{
"CreditTransfer": {
"Debtor": {
"AccountNumber": "123456798",
"UltimateDebtor": {
"Name": "Jason"
}
},
"Creditor": {
"Name": "Jace Taylor",
"RoutingNumber": "111222333",
"AccountNumber": "987654321"
"UltimateCreditor": {
"Name": "John"
}
},
"CreditTransferDescription": {
"Amount": 50.13,
"OriginatorType": "BUSINESS",
"UserName": "RTPUATUser",
"Notes": "This is test transaction"
}
}
}

Sample Request 2: OriginatorType - CONSUMER

POST /v1/institutions/111025466/environments/sandbox/products/paycenter/networks/rtp/credit-transfers HTTP/1.1
Host: wag01.eagle.jhapaycenter.com
Authorization: Bearer EXJ8NG95eDBKa1B.........Yzh5M1ZyZnNlNUVjyjmk
Content-Type: application/json

Request Body

{
"CreditTransfer": {
"Debtor": {
"AccountNumber": "123456798"
},
"Creditor": {
"Name": "Jace Taylor",
"RoutingNumber": "111222333",
"AccountNumber": "987654321"
},
"CreditTransferDescription": {
"Amount": 50.13,
"OriginatorType": "CONSUMER",
"UserName": "RTPUATUser",
"Notes": "This is test transaction"
}
}
}