Initiate a Book (Transfer) Payment

Initiate a transfer payment request

SecurityoAuth2
Request
Request Body schema: application/json
required

Book Transfer [Transfer] Request Fields

externalReferenceId
required
string

Unique reference id from a system outside of finzly. The external reference id can be used by the finzly for the request tracing (if needed).

required
object (BookTransferSender)
required
object (BookTransferReceiver)
paymentAmount
required
number

Payment amount in USD you want to transfer.

paymentDate
required
string

Payment date in mm-dd-yyyy format.

channel
string

The channel name set by the payment origination system such as API, TELLER etc. This is an optional field and defaulted to API if it is not provided. The channel names should be defined in the Finzly system before it can be used in the API.

Responses
200

search results matching criteria

400

bad input parameter environment

401

Unauthorized

403

Forbidden

404

Not Found

405

bad input parameter environment

500

Internal server error

503

Service unavailable

default

return payment response

post/v3/payments/booktransfer
Request samples
application/json
{
  • "externalReferenceId": "Payment101",
  • "senderAccount": {
    },
  • "receiverAccount": {
    },
  • "paymentAmount": 100,
  • "paymentDate": "07-21-2022",
  • "channel": "API"
}
Response samples
application/json
{
  • "status": "Success",
  • "code": "BOOKTRF001",
  • "message": "Failed to create a book transfer payment: <Reason>",
  • "data": {
    }
}