PortX ORCA Payments (0.2.1)
Download OpenAPI specification:Download
PortX ORCA Payments
Retrieves a list of credit transfers matching the parameters.
Authorizations:
query Parameters
paymentId.eq | string (Id) [ 1 .. 36 ] characters Example: paymentId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002 |
paymentMethod.eq | string |
debtorAccountId.eq | string |
creditorAccountNumber.eq | string (AccountNumber) <= 30 characters Example: creditorAccountNumber.eq=012345678 The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country. |
creditorAccountId.eq | string (Id) [ 1 .. 36 ] characters Example: creditorAccountId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002 |
checkType.eq | string |
checkNumber.eq | string |
amount.lte | string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$ Example: amount.lte=100 Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999 |
amount.gte | string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$ Example: amount.gte=100 Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999 |
checkDate.lte | string <date> (Date) Example: checkDate.lte=2022-04-17 Check date less than or equal |
checkDate.gte | string <date> (Date) Example: checkDate.gte=2022-04-17 Check date greater than or equal |
checkNumber.lte | string Check number less than or equal |
checkNumber.gte | string Check number greater than or equal |
header Parameters
servicerId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Account Servicer Identification (Bank) |
servicerBranchId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Identification of the account servicer institution at branch level or operation level. |
Responses
Response samples
- 200
- 400
- 500
[- {
- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "currency": "USD",
- "exchange": {
- "currency": "USD",
- "exchangeFactor": "0.7"
}, - "check": {
- "checkType": "string",
- "checkNumber": "string",
- "availabilityDate": "2022-04-17T08:00:00Z"
}, - "valueDate": "2022-04-17",
- "creditor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}, - "remittanceInformation": {
- "remittanceNumber": "string",
- "documentType": "string"
}, - "paymentId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "status": "AcceptedSettlementCompleted",
- "statusReason": "Cash",
- "date": "2022-04-17T08:00:00Z"
}
]
Credit Transfer Initiation
Instruction to pay an amount of money to an ultimate beneficiary, on behalf of an originator.
Authorizations:
header Parameters
idempotencyId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Idempotency identifier used by the client when making repeated calls |
servicerId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Account Servicer Identification (Bank) |
servicerBranchId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Identification of the account servicer institution at branch level or operation level. |
Request Body schema: application/json
endToEndIdentification required | string (EndToEndIdentification) [ 1 .. 35 ] characters Example: "12345678912345" Unique identification assigned by the initiating party to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain. Usage: The end-to-end identification can be used for reconciliation or to link tasks relating to the transaction. It can be included in several messages related to the transaction. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects (PaymentIdentification) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
paymentMethod required | string (PaymentMethod) [ 1 .. 35 ] characters Example: "CreditTransfer" Specifies the means of payment that will be used to move the amount of money. Possible ISO 20022 compliant values are: Check, CreditTransfer | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
paymentType required | string (PaymentType) [ 1 .. 35 ] characters Example: "On-Us" Specifies the type of Payment. Possible values: LiquidityTransfer, On-Us, ACH, Wire | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
amount required | string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$ Example: "100" Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
paymentReason | string (PaymentPurpose) [ 1 .. 60 ] characters Example: "CashManagementTransfer" Underlying reason for the payment transaction. Usage: Purpose is used to provide information concerning the nature of the payment. Possible Values: BillerSubscriberIdentification, BankLoanDelayedDrawFunding, BankLoanFees, BankLoanFundingMemo, BankLoanAccruedInterestPayment, BankLoanPrincipalPaydown, CardBulkClearing, CardPaymentWithCashBack, CashDisbursementCashSettlement, CashDisbursementWithSurcharging, CardDeferredPayment, OriginalCredit, QuasiCash, EPurseTopUp, FeeCollection, MobileTopUp, AccountManagement, CashManagementTransfer, CollectionPayment, CashDisbursementCashManagement, Deposit, IntraCompanyPayment, IntraPartyPayment, LiquidityManagement, Netting, BondForward, CrossCurrencyIRS, CCPClearedInitialMargin, CCPClearedVariationMargin, CCPClearedInitialMarginSegregatedCash, CreditDefaultSwap, CrossProduct, CreditSupport, CreditLine, EquityOption, EquitySwap, ExoticOption, ExchangeTradedDerivatives, FixedIncome, ForwardBrokerOwnedCashCollateral, ForwardClientOwnedCashCollateral, ForwardBrokerOwnedCashCollateralSegregated, ForwardClientOwnedSegregatedCashCollateral, DailyMarginOnListedDerivatives, MBSBrokerOwnedCashCollateral, MBSClientOwnedCashCollateral, FuturesInitialMargin, FuturesInitialMarginClientOwnedSegregatedCashCollateral, ClientOwnedOCCPledgedCollateral, OTCOptionBrokerOwnedCashCollateral, OTCOptionClientOwnedCashCollateral, OTCOptionBrokerOwnedSegregatedCashCollateral, OTCOptionClientOwnedCashSegregatedCashCollateral, FXOption, OTCDerivatives, RepurchaseAgreement, BilateralRepoBrokerOwnedCollateral, RepoClientOwnedCollateral, BilateralRepoBrokerOwnedSegregatedCashCollateral, BilateralRepoClientOwnedSegregatedCashCollateral, ReverseRepurchaseAgreement, SecuritiesBuySellSellBuyBack, SingleCurrencyIRSExotic, SingleCurrencyIRS, SecuritiesCrossProducts, BrokerOwnedCollateralShortSale, ClientOwnedCollateralShortSale, ShortSell, SecuritiesLendingAndBorrowing, SecuredLoan, SwapBrokerOwnedCashCollateral, SwapClientOwnedCashCollateral, Swaption, SwapsBrokerOwnedSegregatedCashCollateral, SwapsClientOwnedSegregatedCashCollateral, ToBeAnnounced, TBABrokerOwnedCashCollateral, TBAClientOwnedCashCollateral, TreasuryCrossProduct, AgriculturalTransfer, AccountsReceivablesEntry, BusinessExpenses, BackOfficeConversionEntry, CommercialPayment, Copyright, PurchaseSaleOfGoods, PurchaseSaleOfGoodsAndServices, PurchaseSaleOfGoodsAndServicesWithCashBack, LicenseFee, MobileP2BPayment, PointOfPurchaseEntry, Royalties, PurchaseSaleOfServices, ServiceCharges, Subscription, SupplierPayment, Commercial, CharityPayment, ConsumerThirdPartyConsolidatedPayment, MobileP2PPayment, GuaranteedEPayment, EPaymentReturn, NonGuaranteedEPayment, Epayment, CarLoanPrincipalRepayment, CompensationPayment, DebitCollectionPayment, GovernmentInsurance, PropertyLoanRepayment, PropertyLoanSettlement, InsurancePremiumCar, InsurancePremiumRefund, PaymentOfInsuranceClaim, InsurancePremium, Interest, LaborInsurance, LifeInsurance, Loan, LoanRepayment, PaymentBasedOnEnforcementOrder, PropertyInsurance, RentalLeaseGeneral, RecurringInstallmentPayment, TrustFund, ForwardForeignExchange, ForeignExchangeRelatedNetting, AdministrativeManagement, AdvancePayment, BearerCheckDomestic, BearerCheckForeign, BuildingMaintenance, BondForwardNetting, CapitalBuilding, CapitalBuildingRetirement, CreditCardPayment, CreditCardBill, CancellationFee, CardGeneratedDirectDebit, TradeSettlementPayment, Costs, CarparkCharges, DebitCardPayment, PrintedOrderDisbursement, DeliverAgainstPayment, Education, FactorUpdateRelatedPayment, FinancialAidInCaseOfNaturalDisaster, LatePaymentOfFeesAndCharges, PaymentOfFees, Gift, GovernmentPayment, IrrevocableCreditCardPayment, IrrevocableDebitCardPayment, InstalmentHirePurchaseAgreement, Installment, InvoicePayment, MultiCurrenyCheckDomestic, MultiCurrenyCheckForeign, MultipleServiceTypes, NotOtherwiseSpecified, OrderChequeDomestic, OrderChequeForeign, OpeningFee, PreauthorizedDebit, PaymentTerms, RepresentedCheckEntry, ReceiptPayment, Rebate, Refund, Rent, AccountOverdraftRepayment, ReimbursementOfAPreviousErroneousTransaction, BilateralRepoInternetNetting, RoundRobin, ReimbursementReceivedCreditTransfer, RelatedRequestToPay, ReceiveAgainstPayment, PaymentSlipInstruction, SplitPayments, Study, TBAPairOffNetting, TelecommunicationsBill, TownCouncilServiceCharges, TelephoneInitiatedTransaction, TMPGClaimPayment, TriPartyRepoInterest, TriPartyRepoNetting, TruncatedPaymentSlip, TravellerCheque, InternetInitiatedTransaction, InstantPayments, InstantPaymentsCancellation, InstantPaymentsForDonations, InstantPaymentsInECommerceWithoutAddressData, InstantPaymentsInECommerceWithAddressData, InstantPaymentsInECommerce, InstantPaymentsAtPOS, InstantPaymentsReturn, InstantPaymentsUnattendedVendingMachineWith2FA, InstantPaymentsUnattendedVendingMachineWithout2FA, Annuity, CustodianManagementFeeInhouse, CapitalFallingDueInhouse, CommodityTransfer, Derivatives, Dividend, ForeignExchange, Hedging, InvestmentAndSecurities, PreciousMetal, Savings, Securities, SecuritiesPurchaseInhouse, TreasuryPayment, UnitTrustPurchase, FuturesNettingPayment, Futures, AnesthesiaServices, ConvalescentCareFacility, DurableMedicaleEquipment, DentalServices, HomeHealthCare, HealthInsurance, HospitalCare, IntermediateCareFacility, LongTermCareFacility, MedicalAidFundContribution, MedicalAidRefund, MedicalServices, VisionCare, CreditDefaultEventPayment, SwapContractFinalPayment, SwapContractPartialPayment, SwapContractResetPayment, SwapContractUpfrontPayment, AdvisoryDonationCopyrightServices, ActiveEmploymentPolicy, Allowance, AlimonyPayment, BabyBonusScheme, ChildBenefit, UnemploymentDisabilityBenefit, BonusPayment, CashCompensationHelplessnessDisability, Commission, CompanySocialLoanPaymentToBank, GuaranteeFundRightsPayment, GovermentWarLegislationTransfer, HousingRelatedContribution, Payroll, PensionFundContribution, PensionPayment, PricePayment, RehabilitationSupport, SalaryPayment, SalaryPensionSumPayment, SocialSecurityBenefit, LendingBuyInNetting, LendingCashCollateralFreeMovement, LendingFees, LendingEquityMarkedToMarketCashCollateral, LendingFixedIncomeMarkedToMarketCashCollateral, LendingUnspecifiedTypeOfMarkedToMarketCashCollateral, LendingRebatePayments, LendingRevenuePayments, LendingClaimPayment, EstateTax, ForeignWorkerLevy, GoodsServicesTax, HousingTax, IncomeTax, NetIncomeTax, PropertyTax, RoadTax, TaxPayment, ValueAddedTaxPayment, WithHolding, TaxRefund, TrailerFeePayment, TrailerFeeRebate, NonUSMutualFundTrailerFeePayment, NonUSMutualFundTrailerFeeRebatePayment, Air, Bus, Ferry, Railway, RoadPricing, CableTVBill, ElectricityBill, Energies, GasBill, NetworkCharge, NetworkCommunication, OtherTelecomRelatedBill, TelephoneBill, Utilities, WaterBill, Bonds, CorporateActions-Bonds, CorporateActions-Equities, CreditCard, DebitCard, Diners, Equities, FleetCard, LowValueCredit, LowValueDebit, MoneyMarket, RapidPaymentInstruction, GamblingOrWageringPayment, LotteryPayment, Amex, ATM, AuthenticatedCollections, PropertyCompletionPayment, PropertyDeposit, PropertyLoanDisbursement, PropertyLoanRefinancing, GovernmentFamilyAllowance, GovernmentHousingAllowance, CashPenalties. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
debtorAccountId | string (AccountId) [ 1 .. 36 ] characters Example: "0dd926fe-1ca2-11ed-861d-0242ac120002" Identification assigned by the account service institution (Servicer). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
creditorAccountId | string (AccountId) [ 1 .. 36 ] characters Example: "0dd926fe-1ca2-11ed-861d-0242ac120002" Identification assigned by the account service institution (Servicer). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
purpose | string (Description) [ 1 .. 1025 ] characters Example: "This is a description." | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (PaymentProcessingDetail) Provides further details of the type of payment. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
chargeBearerType | string (ChargeBearerType) [ 1 .. 35 ] characters Example: "Shared" Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
currency | string = 3 characters ^([A-Z]{3})?$ Example: "USD" Specifies the currency of the amount to be transferred which may be different from the currency of the debtor's account. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (Exchange) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (Check) Characteristics of a check | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
valueDate | string <date> Example: "2022-04-17" Date on which a payment must be executed | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (PartyIdentification) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (RemittanceInformation) Information supplied to enable the matching/reconciliation of an entry with the items that the payment is intended to settle, such as commercial invoices in an accounts' receivable system. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "currency": "USD",
- "exchange": {
- "currency": "USD",
- "exchangeFactor": "0.7"
}, - "check": {
- "checkType": "string",
- "checkNumber": "string",
- "availabilityDate": "2022-04-17T08:00:00Z"
}, - "valueDate": "2022-04-17",
- "creditor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}, - "remittanceInformation": {
- "remittanceNumber": "string",
- "documentType": "string"
}
}
Response samples
- 202
- 400
- 500
{- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "currency": "USD",
- "exchange": {
- "currency": "USD",
- "exchangeFactor": "0.7"
}, - "check": {
- "checkType": "string",
- "checkNumber": "string",
- "availabilityDate": "2022-04-17T08:00:00Z"
}, - "valueDate": "2022-04-17",
- "creditor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}, - "remittanceInformation": {
- "remittanceNumber": "string",
- "documentType": "string"
}, - "paymentId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "status": "AcceptedSettlementCompleted",
- "statusReason": "Cash",
- "date": "2022-04-17T08:00:00Z"
}
Credit Transfer Status
Returns the status report of a credit transfer initiation, process and excecution.
Authorizations:
path Parameters
paymentId required | string (PaymentId) [ 1 .. 36 ] characters Example: 0dd926fe-1ca2-11ed-861d-0242ac120002 Identification of the Payment. |
header Parameters
servicerId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Account Servicer Identification (Bank) |
servicerBranchId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Identification of the account servicer institution at branch level or operation level. |
Responses
Response samples
- 200
- 400
- 404
- 500
{- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "currency": "USD",
- "exchange": {
- "currency": "USD",
- "exchangeFactor": "0.7"
}, - "check": {
- "checkType": "string",
- "checkNumber": "string",
- "availabilityDate": "2022-04-17T08:00:00Z"
}, - "valueDate": "2022-04-17",
- "creditor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}, - "remittanceInformation": {
- "remittanceNumber": "string",
- "documentType": "string"
}, - "paymentId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "status": "AcceptedSettlementCompleted",
- "statusReason": "Cash",
- "date": "2022-04-17T08:00:00Z"
}
Credit Transfer Cancellation
Request a payment cancellation.
Authorizations:
path Parameters
paymentId required | string (PaymentId) [ 1 .. 36 ] characters Example: 0dd926fe-1ca2-11ed-861d-0242ac120002 Identification of the Payment. |
header Parameters
idempotencyId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Idempotency identifier used by the client when making repeated calls |
servicerId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Account Servicer Identification (Bank) |
servicerBranchId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Identification of the account servicer institution at branch level or operation level. |
Request Body schema: application/json
cancellationReason | string (Description) [ 1 .. 1025 ] characters Example: "This is a description." |
Responses
Request samples
- Payload
{- "cancellationReason": "This is a description."
}
Response samples
- 202
- 400
- 500
{- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "currency": "USD",
- "exchange": {
- "currency": "USD",
- "exchangeFactor": "0.7"
}, - "check": {
- "checkType": "string",
- "checkNumber": "string",
- "availabilityDate": "2022-04-17T08:00:00Z"
}, - "valueDate": "2022-04-17",
- "creditor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}, - "remittanceInformation": {
- "remittanceNumber": "string",
- "documentType": "string"
}, - "paymentId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "status": "AcceptedSettlementCompleted",
- "statusReason": "Cash",
- "date": "2022-04-17T08:00:00Z"
}
Retrieves a list of direct debits matching the parameters.
Authorizations:
query Parameters
paymentId.eq | string (Id) [ 1 .. 36 ] characters Example: paymentId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002 |
paymentMethod.eq | string |
debtorAccountId.eq | string |
creditorAccountNumber.eq | string (AccountNumber) <= 30 characters Example: creditorAccountNumber.eq=012345678 The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country. |
creditorAccountId.eq | string (Id) [ 1 .. 36 ] characters Example: creditorAccountId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002 |
amount.lte | string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$ Example: amount.lte=100 Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999 |
amount.gte | string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$ Example: amount.gte=100 Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999 |
header Parameters
servicerId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Account Servicer Identification (Bank) |
servicerBranchId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Identification of the account servicer institution at branch level or operation level. |
Responses
Response samples
- 200
- 400
- 500
[- {
- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "currency": "USD",
- "exchange": {
- "currency": "USD",
- "exchangeFactor": "0.7"
}, - "check": {
- "checkType": "string",
- "checkNumber": "string",
- "availabilityDate": "2022-04-17T08:00:00Z"
}, - "valueDate": "2022-04-17",
- "creditor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}, - "remittanceInformation": {
- "remittanceNumber": "string",
- "documentType": "string"
}, - "paymentId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "status": "AcceptedSettlementCompleted",
- "statusReason": "Cash",
- "date": "2022-04-17T08:00:00Z"
}
]
Direct Debit Initiation
Instruction to collect funds from a debitor.
Authorizations:
header Parameters
idempotencyId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Idempotency identifier used by the client when making repeated calls |
servicerId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Account Servicer Identification (Bank) |
servicerBranchId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Identification of the account servicer institution at branch level or operation level. |
Request Body schema: application/json
endToEndIdentification required | string (EndToEndIdentification) [ 1 .. 35 ] characters Example: "12345678912345" Unique identification assigned by the initiating party to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain. Usage: The end-to-end identification can be used for reconciliation or to link tasks relating to the transaction. It can be included in several messages related to the transaction. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects (PaymentIdentification) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
paymentMethod required | string (PaymentMethod) [ 1 .. 35 ] characters Example: "CreditTransfer" Specifies the means of payment that will be used to move the amount of money. Possible ISO 20022 compliant values are: Check, CreditTransfer | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
paymentType required | string (PaymentType) [ 1 .. 35 ] characters Example: "On-Us" Specifies the type of Payment. Possible values: LiquidityTransfer, On-Us, ACH, Wire | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
amount required | string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$ Example: "100" Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
paymentReason | string (PaymentPurpose) [ 1 .. 60 ] characters Example: "CashManagementTransfer" Underlying reason for the payment transaction. Usage: Purpose is used to provide information concerning the nature of the payment. Possible Values: BillerSubscriberIdentification, BankLoanDelayedDrawFunding, BankLoanFees, BankLoanFundingMemo, BankLoanAccruedInterestPayment, BankLoanPrincipalPaydown, CardBulkClearing, CardPaymentWithCashBack, CashDisbursementCashSettlement, CashDisbursementWithSurcharging, CardDeferredPayment, OriginalCredit, QuasiCash, EPurseTopUp, FeeCollection, MobileTopUp, AccountManagement, CashManagementTransfer, CollectionPayment, CashDisbursementCashManagement, Deposit, IntraCompanyPayment, IntraPartyPayment, LiquidityManagement, Netting, BondForward, CrossCurrencyIRS, CCPClearedInitialMargin, CCPClearedVariationMargin, CCPClearedInitialMarginSegregatedCash, CreditDefaultSwap, CrossProduct, CreditSupport, CreditLine, EquityOption, EquitySwap, ExoticOption, ExchangeTradedDerivatives, FixedIncome, ForwardBrokerOwnedCashCollateral, ForwardClientOwnedCashCollateral, ForwardBrokerOwnedCashCollateralSegregated, ForwardClientOwnedSegregatedCashCollateral, DailyMarginOnListedDerivatives, MBSBrokerOwnedCashCollateral, MBSClientOwnedCashCollateral, FuturesInitialMargin, FuturesInitialMarginClientOwnedSegregatedCashCollateral, ClientOwnedOCCPledgedCollateral, OTCOptionBrokerOwnedCashCollateral, OTCOptionClientOwnedCashCollateral, OTCOptionBrokerOwnedSegregatedCashCollateral, OTCOptionClientOwnedCashSegregatedCashCollateral, FXOption, OTCDerivatives, RepurchaseAgreement, BilateralRepoBrokerOwnedCollateral, RepoClientOwnedCollateral, BilateralRepoBrokerOwnedSegregatedCashCollateral, BilateralRepoClientOwnedSegregatedCashCollateral, ReverseRepurchaseAgreement, SecuritiesBuySellSellBuyBack, SingleCurrencyIRSExotic, SingleCurrencyIRS, SecuritiesCrossProducts, BrokerOwnedCollateralShortSale, ClientOwnedCollateralShortSale, ShortSell, SecuritiesLendingAndBorrowing, SecuredLoan, SwapBrokerOwnedCashCollateral, SwapClientOwnedCashCollateral, Swaption, SwapsBrokerOwnedSegregatedCashCollateral, SwapsClientOwnedSegregatedCashCollateral, ToBeAnnounced, TBABrokerOwnedCashCollateral, TBAClientOwnedCashCollateral, TreasuryCrossProduct, AgriculturalTransfer, AccountsReceivablesEntry, BusinessExpenses, BackOfficeConversionEntry, CommercialPayment, Copyright, PurchaseSaleOfGoods, PurchaseSaleOfGoodsAndServices, PurchaseSaleOfGoodsAndServicesWithCashBack, LicenseFee, MobileP2BPayment, PointOfPurchaseEntry, Royalties, PurchaseSaleOfServices, ServiceCharges, Subscription, SupplierPayment, Commercial, CharityPayment, ConsumerThirdPartyConsolidatedPayment, MobileP2PPayment, GuaranteedEPayment, EPaymentReturn, NonGuaranteedEPayment, Epayment, CarLoanPrincipalRepayment, CompensationPayment, DebitCollectionPayment, GovernmentInsurance, PropertyLoanRepayment, PropertyLoanSettlement, InsurancePremiumCar, InsurancePremiumRefund, PaymentOfInsuranceClaim, InsurancePremium, Interest, LaborInsurance, LifeInsurance, Loan, LoanRepayment, PaymentBasedOnEnforcementOrder, PropertyInsurance, RentalLeaseGeneral, RecurringInstallmentPayment, TrustFund, ForwardForeignExchange, ForeignExchangeRelatedNetting, AdministrativeManagement, AdvancePayment, BearerCheckDomestic, BearerCheckForeign, BuildingMaintenance, BondForwardNetting, CapitalBuilding, CapitalBuildingRetirement, CreditCardPayment, CreditCardBill, CancellationFee, CardGeneratedDirectDebit, TradeSettlementPayment, Costs, CarparkCharges, DebitCardPayment, PrintedOrderDisbursement, DeliverAgainstPayment, Education, FactorUpdateRelatedPayment, FinancialAidInCaseOfNaturalDisaster, LatePaymentOfFeesAndCharges, PaymentOfFees, Gift, GovernmentPayment, IrrevocableCreditCardPayment, IrrevocableDebitCardPayment, InstalmentHirePurchaseAgreement, Installment, InvoicePayment, MultiCurrenyCheckDomestic, MultiCurrenyCheckForeign, MultipleServiceTypes, NotOtherwiseSpecified, OrderChequeDomestic, OrderChequeForeign, OpeningFee, PreauthorizedDebit, PaymentTerms, RepresentedCheckEntry, ReceiptPayment, Rebate, Refund, Rent, AccountOverdraftRepayment, ReimbursementOfAPreviousErroneousTransaction, BilateralRepoInternetNetting, RoundRobin, ReimbursementReceivedCreditTransfer, RelatedRequestToPay, ReceiveAgainstPayment, PaymentSlipInstruction, SplitPayments, Study, TBAPairOffNetting, TelecommunicationsBill, TownCouncilServiceCharges, TelephoneInitiatedTransaction, TMPGClaimPayment, TriPartyRepoInterest, TriPartyRepoNetting, TruncatedPaymentSlip, TravellerCheque, InternetInitiatedTransaction, InstantPayments, InstantPaymentsCancellation, InstantPaymentsForDonations, InstantPaymentsInECommerceWithoutAddressData, InstantPaymentsInECommerceWithAddressData, InstantPaymentsInECommerce, InstantPaymentsAtPOS, InstantPaymentsReturn, InstantPaymentsUnattendedVendingMachineWith2FA, InstantPaymentsUnattendedVendingMachineWithout2FA, Annuity, CustodianManagementFeeInhouse, CapitalFallingDueInhouse, CommodityTransfer, Derivatives, Dividend, ForeignExchange, Hedging, InvestmentAndSecurities, PreciousMetal, Savings, Securities, SecuritiesPurchaseInhouse, TreasuryPayment, UnitTrustPurchase, FuturesNettingPayment, Futures, AnesthesiaServices, ConvalescentCareFacility, DurableMedicaleEquipment, DentalServices, HomeHealthCare, HealthInsurance, HospitalCare, IntermediateCareFacility, LongTermCareFacility, MedicalAidFundContribution, MedicalAidRefund, MedicalServices, VisionCare, CreditDefaultEventPayment, SwapContractFinalPayment, SwapContractPartialPayment, SwapContractResetPayment, SwapContractUpfrontPayment, AdvisoryDonationCopyrightServices, ActiveEmploymentPolicy, Allowance, AlimonyPayment, BabyBonusScheme, ChildBenefit, UnemploymentDisabilityBenefit, BonusPayment, CashCompensationHelplessnessDisability, Commission, CompanySocialLoanPaymentToBank, GuaranteeFundRightsPayment, GovermentWarLegislationTransfer, HousingRelatedContribution, Payroll, PensionFundContribution, PensionPayment, PricePayment, RehabilitationSupport, SalaryPayment, SalaryPensionSumPayment, SocialSecurityBenefit, LendingBuyInNetting, LendingCashCollateralFreeMovement, LendingFees, LendingEquityMarkedToMarketCashCollateral, LendingFixedIncomeMarkedToMarketCashCollateral, LendingUnspecifiedTypeOfMarkedToMarketCashCollateral, LendingRebatePayments, LendingRevenuePayments, LendingClaimPayment, EstateTax, ForeignWorkerLevy, GoodsServicesTax, HousingTax, IncomeTax, NetIncomeTax, PropertyTax, RoadTax, TaxPayment, ValueAddedTaxPayment, WithHolding, TaxRefund, TrailerFeePayment, TrailerFeeRebate, NonUSMutualFundTrailerFeePayment, NonUSMutualFundTrailerFeeRebatePayment, Air, Bus, Ferry, Railway, RoadPricing, CableTVBill, ElectricityBill, Energies, GasBill, NetworkCharge, NetworkCommunication, OtherTelecomRelatedBill, TelephoneBill, Utilities, WaterBill, Bonds, CorporateActions-Bonds, CorporateActions-Equities, CreditCard, DebitCard, Diners, Equities, FleetCard, LowValueCredit, LowValueDebit, MoneyMarket, RapidPaymentInstruction, GamblingOrWageringPayment, LotteryPayment, Amex, ATM, AuthenticatedCollections, PropertyCompletionPayment, PropertyDeposit, PropertyLoanDisbursement, PropertyLoanRefinancing, GovernmentFamilyAllowance, GovernmentHousingAllowance, CashPenalties. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
debtorAccountId | string (AccountId) [ 1 .. 36 ] characters Example: "0dd926fe-1ca2-11ed-861d-0242ac120002" Identification assigned by the account service institution (Servicer). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
creditorAccountId | string (AccountId) [ 1 .. 36 ] characters Example: "0dd926fe-1ca2-11ed-861d-0242ac120002" Identification assigned by the account service institution (Servicer). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
purpose | string (Description) [ 1 .. 1025 ] characters Example: "This is a description." | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (PaymentProcessingDetail) Provides further details of the type of payment. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
chargeBearerType | string (ChargeBearerType) [ 1 .. 35 ] characters Example: "Shared" Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (DirectDebitMandate) Authorization in favour of the creditor given by the debtor to debit its own account. Provides details related to a direct debit mandate signed between the creditor and the debtor. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
requestedCollectionDate | string <date> Example: "2022-04-17" Date and time at which the creditor requests that the amount of money is to be collected from the debtor. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (PartyIdentification) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "mandate": {
- "mandateId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
- "dateOfSignature": "2022-04-17",
- "digitalSignature": {
- "0": 83,
- "1": 109,
- "2": 70,
- "3": 117,
- "4": 90,
- "5": 83,
- "6": 66,
- "7": 67,
- "8": 97,
- "9": 88,
- "10": 74,
- "11": 114,
- "12": 97,
- "13": 87,
- "14": 52,
- "15": 61
}, - "firstCollectionDate": "2022-04-17",
- "finalCollectionDate": "2022-04-17",
- "frequency": {
- "cycle": "Monthly",
- "every": 15,
- "weekDay": "Tuesday",
- "weekNumber": "1st",
- "day": 30,
- "startDay": "04-17"
}, - "trackingDays": 30
}, - "requestedCollectionDate": "2022-04-17",
- "debitor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}
}
Response samples
- 202
- 400
- 500
{- "paymentId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "status": "AcceptedSettlementCompleted",
- "statusReason": "Cash",
- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "mandate": {
- "mandateId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
- "dateOfSignature": "2022-04-17",
- "digitalSignature": {
- "0": 83,
- "1": 109,
- "2": 70,
- "3": 117,
- "4": 90,
- "5": 83,
- "6": 66,
- "7": 67,
- "8": 97,
- "9": 88,
- "10": 74,
- "11": 114,
- "12": 97,
- "13": 87,
- "14": 52,
- "15": 61
}, - "firstCollectionDate": "2022-04-17",
- "finalCollectionDate": "2022-04-17",
- "frequency": {
- "cycle": "Monthly",
- "every": 15,
- "weekDay": "Tuesday",
- "weekNumber": "1st",
- "day": 30,
- "startDay": "04-17"
}, - "trackingDays": 30
}, - "requestedCollectionDate": "2022-04-17",
- "debitor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}
}
Direct Debit Status
Returns the status report of a direct debit initiation, process and excecution.
Authorizations:
path Parameters
paymentId required | string (PaymentId) [ 1 .. 36 ] characters Example: 0dd926fe-1ca2-11ed-861d-0242ac120002 Identification of the Payment. |
header Parameters
servicerId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Account Servicer Identification (Bank) |
servicerBranchId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Identification of the account servicer institution at branch level or operation level. |
Responses
Response samples
- 200
- 400
- 404
- 500
{- "paymentId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "status": "AcceptedSettlementCompleted",
- "statusReason": "Cash",
- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "mandate": {
- "mandateId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
- "dateOfSignature": "2022-04-17",
- "digitalSignature": {
- "0": 83,
- "1": 109,
- "2": 70,
- "3": 117,
- "4": 90,
- "5": 83,
- "6": 66,
- "7": 67,
- "8": 97,
- "9": 88,
- "10": 74,
- "11": 114,
- "12": 97,
- "13": 87,
- "14": 52,
- "15": 61
}, - "firstCollectionDate": "2022-04-17",
- "finalCollectionDate": "2022-04-17",
- "frequency": {
- "cycle": "Monthly",
- "every": 15,
- "weekDay": "Tuesday",
- "weekNumber": "1st",
- "day": 30,
- "startDay": "04-17"
}, - "trackingDays": 30
}, - "requestedCollectionDate": "2022-04-17",
- "debitor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}
}
Direct Debit Cancellation
Requests direct debit cancellation.
Authorizations:
path Parameters
paymentId required | string (PaymentId) [ 1 .. 36 ] characters Example: 0dd926fe-1ca2-11ed-861d-0242ac120002 Identification of the Payment. |
header Parameters
idempotencyId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Idempotency identifier used by the client when making repeated calls |
servicerId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Account Servicer Identification (Bank) |
servicerBranchId | string (Id) [ 1 .. 36 ] characters Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002 Identification of the account servicer institution at branch level or operation level. |
Request Body schema: application/json
cancellationReason | string (Description) [ 1 .. 1025 ] characters Example: "This is a description." |
Responses
Request samples
- Payload
{- "cancellationReason": "This is a description."
}
Response samples
- 202
- 400
- 500
{- "paymentId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "status": "AcceptedSettlementCompleted",
- "statusReason": "Cash",
- "endToEndIdentification": "12345678912345",
- "identifiers": [
- {
- "number": "string",
- "identifierName": "UETR",
- "issuer": "Banc of California"
}
], - "paymentMethod": "CreditTransfer",
- "paymentType": "On-Us",
- "amount": "100",
- "paymentReason": "CashManagementTransfer",
- "debtorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "creditorAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
- "purpose": "This is a description.",
- "paymentProcessing": {
- "instructionPriority": "123456789",
- "serviceLevel": "BookTransaction",
- "clearingChannel": "ACH",
- "localInstrument": "CorporateCreditDebit",
- "categoryPurpose": "SalaryPayment"
}, - "chargeBearerType": "Shared",
- "mandate": {
- "mandateId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
- "dateOfSignature": "2022-04-17",
- "digitalSignature": {
- "0": 83,
- "1": 109,
- "2": 70,
- "3": 117,
- "4": 90,
- "5": 83,
- "6": 66,
- "7": 67,
- "8": 97,
- "9": 88,
- "10": 74,
- "11": 114,
- "12": 97,
- "13": 87,
- "14": 52,
- "15": 61
}, - "firstCollectionDate": "2022-04-17",
- "finalCollectionDate": "2022-04-17",
- "frequency": {
- "cycle": "Monthly",
- "every": 15,
- "weekDay": "Tuesday",
- "weekNumber": "1st",
- "day": 30,
- "startDay": "04-17"
}, - "trackingDays": 30
}, - "requestedCollectionDate": "2022-04-17",
- "debitor": {
- "name": "Jane Birkin",
- "account": {
- "name": "Hermes PD_CA 0002",
- "identifiers": [
- {
- "identification": "string",
- "schemeName": "BBANIdentifier",
- "issuer": "string"
}
], - "currency": "USD",
- "accountType": "Checking"
}, - "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "agent": {
- "clearingSystemMemberIdentification": "UnitedStatesRoutingNumberFedwireNACHA",
- "memberIdentification": "string",
- "name": "string",
- "postalAddress": {
- "addressType": "Postal",
- "addressPurpose": "Billing",
- "primaryIndicator": true,
- "department": "A",
- "subDepartment": "B",
- "streetName": "First Street",
- "firstCrossStreetName": "string",
- "secondCrossStreetName": "Second Street",
- "buildingNumber": "11407",
- "buildingName": "Tall Tower",
- "floor": "20",
- "postBox": "MY779",
- "room": "22",
- "postCode": "97062-68",
- "censusTrack": "04013216813",
- "cBSACode": "49780",
- "cBSAType": "MSA",
- "foreignIndicator": true,
- "townName": "Tualatin",
- "townLocationName": "Clackamas",
- "districtName": "Washington",
- "countrySubDivision": "Oregon",
- "countrySubDivisionCode": "AR-B",
- "country": "US",
- "addressLine": [
- "11407 Sw Amu st, Suite MY777"
], - "period": {
- "fromDateTime": "2022-04-17T08:00:00Z",
- "upToDateTime": "2022-04-17T08:00:00Z"
}
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
]
}, - "placeAndDateOfBirth": {
- "countrySubdivision": "Oregon",
- "townName": "Tualatin",
- "country": "US",
- "birthDate": "2022-04-17"
}, - "contact": {
- "contactMethods": [
- {
- "channelType": "Email",
- "identification": "011-02010020202"
}
], - "preferredMethod": "Email",
- "preferredLanguage": "English"
}, - "identifiers": [
- {
- "number": "123-45-6789",
- "schemeName": "TaxIdentificationNumber",
- "issuer": "UnitedStates",
- "issueDate": "2022-04-17",
- "expirationDate": "2022-04-17"
}
], - "countryOfResidence": "US"
}
}