API Reference
Log into Sandbox

Create Transfer

post
https://{corename}.payment-hub.{env}.gpsrv.com/payment-hub/1.0/createTransfer

👍

Availability

Some of the field descriptions for this endpoint reference FedNow or Fedwire, which are future capabilities not yet available for clients.

Use the Create Transfer endpoint to move funds between a source account and a destination account. You can use an active account link that was created by Create External Account Link or create a new one via the request.

For card transfers, the referenced external debit card link must have a validation status of "PASSED" before it can be used for transfers.

For new transfers: Omit the returnDetails field.
For payment returns: Include the returnDetails field with the original transaction reference.
When returnDetails is present, the request initiates a return of the original transfer.

Body Params
string
required

The PRN associated with this transfer.
Pattern: PRN
Example: "074103447228"

string
enum
required

Payment network to use for the transfer.
Rail-specific validation: CARD requires the sourceAccount to be GALILEO and creditOrDebit to be DEBIT or CREDIT.
Example: "CARD"

Allowed:
currencyAmount
object
required

Amount and currency for the transfer.

string
enum
required

Posting type indicating debit or credit.

  • DEBIT: Debit transaction (funds withdrawn)
  • CREDIT: Credit transaction (funds deposited)
Allowed:
sourceAccount
object
required

Identifies the account's role in the transaction.

If used as the sourceAccount, this is the account being debited. For push transfers (withdrawals), use the
Galileo account; for pull transfers (deposits), use the linked external account.

If used as the destinationAccount, this is the account being credited. For push transfers, use the linked
external account; for pull transfers, use the Galileo account.

destinationAccount
object
required

Identifies the account's role in the transaction.

If used as the sourceAccount, this is the account being debited. For push transfers (withdrawals), use the
Galileo account; for pull transfers (deposits), use the linked external account.

If used as the destinationAccount, this is the account being credited. For push transfers, use the linked
external account; for pull transfers, use the Galileo account.

Client-defined identifier for tracking and reconciliation.
Pattern: Alphanumeric string
Example: My-Internal-ID-123

Reason for the transfer.
Pattern: Alphanumeric string
Validation:

  • Default: Alphanumeric string
  • FEDWIRE: Limited to alphanumeric and special characters: @&/'"`~()<>$#%+-={}*|[]^.,?!;:_
    Example: "Bill Payment"

Additional details about the transfer, such as an invoice number.
Pattern: Alphanumeric string
Validation:

  • Default: Alphanumeric string
  • FEDWIRE: 1-140 characters, limited to alphanumeric and special characters: @&/'"~()<>$#%+-={}*|[]^.,?!;:_ Example: "Invoice #456-ABC`"
returnDetails

Payment return information. If present, this request initiates a return/reversal of a previous transfer.

When provided, the following fields take on return-specific meanings:

  • currencyAmount: The amount being returned (supports partial returns, must be less than or equal to the original amount)
  • sourceAccount: Account initiating the return.
  • destinationAccount: Account receiving the return.
  • paymentMethod: Payment rail used for the return.

See ReturnDetails class documentation for additional return fields and requirements.

Headers
string
required
string
required

Basic authentication token (base64-encoded {apilogin}:{apitranskey} credentials provided by Galileo)

Responses

Updated about 2 hours ago

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 hours ago

© Galileo Financial Technologies, LLC 2026    Privacy Disclosure

All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of Galileo Financial Technologies, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of Galileo Financial Technologies, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.