API Reference
Log into Sandbox

Create Payment

post
https://api-{corename}.{env}.gpsrv.com/intserv/4.0/createPayment

Use the Create Payment endpoint to move funds into a customer account. This endpoint may return load limit and velocity violations in its response. Payments created with this endpoint are returned by the Get Account Overview endpoint only after several seconds have elapsed.

Load limit and velocity response

If the payment violates load or velocity limits, this endpoint returns status: 26 with limit_error, limit_id, and limit_response_code values. Use the limit_id for troubleshooting the load and velocity configuration. The limit_response_code values are enumerated in the Limit Response Codes table.

Consult the Creating a Payment guide for instructions on using this endpoint.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status codeDescription
408-01Success -- partial limit violation. The value in amount exceeds the maximum account load and will only be partially applied. Inform the customer that the payment was only partially loaded to the account.
408-02holdAmount is missing while holdExpirationDateTime is passed. When holdExpirationDateTime is populated, holdAmount is required.
408-03Holds are not enabled for this product/program. Please contact client support for more information.
408-04Provided XID does not map to a valid balance in our system. The internal account ID does not have a valid balance_id. Verify that the PRN is correct or contact Galileo for troubleshooting.
408-05Provided expiration date needs to be in the correct format (YYYY-MM-DD HH:MM:SS) and needs to be in the future. Verify that holdExpirationDateTime is in the correct format and is in the future.
408-08Amount must be equal to or less than the payment minus any other holds that have already been placed. The holdAmount is invalid.
408-09An unknown error occurred while creating the hold. Please contact client support if this error persists.
408-10Amount must be equal to or less than the account balance. The holdAmount cannot be a negative number or an amount larger than the account balance.
Form Data
string
required

Web service username, as provided by Galileo.
Pattern: Max 50 characters
Example: "AbC123-9999"

string
required

Web service password, as provided by Galileo.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

int32
required

Galileo-issued provider identifier.
Pattern: Max 10 digits
Example: 9999

string
required
1 to 60

A unique provider-generated ID to identify this API call. A UUID is preferred.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"

string
required

The PRN or PAN of the account.
Pattern: PAN or PRN
Example: "074103447228"

float
required

Currency amount as a whole or decimal amount.
Pattern: Positive integer or decimal number
Example: 100.00, 100, or 100.73

string
required

The transaction type (otype) for the payment. Use the values provided by Galileo for your program.
Pattern: 2-character alphanumeric
Example: "RL"

string | null

Description for the transaction. If type is an otype that was custom-configured for your program, the description for that otype might override the description you provide here, depending on your setup with Galileo.
Pattern: 1–40 alphanumeric characters, including punctuation
Example: "One-time payroll load."

string | null

Unique location identifier (location) as returned by the Create Location endpoint. This value is also returned by the Get Locations endpoint depending on the value of locationType when the location was created:

  • 0 or 2 — Returned in the location_id field
  • 1 — Returned in the provider_specified_id field

Pattern: Integer if locationType: 0 or locationType: 2; max 15 characters if locationType: 1
Example: "a455-3483"

int32
enum
Defaults to 0

Type of ID in location:

  • 0 — Galileo location ID
  • 1 — Partner location ID
  • 2 — Don't validate

Pattern: Integer
Example: 0

Allowed:
float | null
-0.00001 to 999999999999.99

Fee amount assessed by the provider. This value is passed to Galileo only for informational purposes; passing this value does not assess the fee.
Pattern: Monetary amount greater than 0.
Example: 2.50

int32 | null
enum

Pass 1 to test the endpoint data without creating a transaction.
Pattern: Integer
Example: 0

Allowed:
string | null

Load partners only. Identifier for the merchant that loaded the card.
Pattern: Max 50 alphanumeric characters
Example: "R12573L123"

string | null

Load partners only. Partner providing the load request.
Pattern: Max 50 alphanumeric and international characters
Example: "CardLoader Inc"

string | null

Load partners only. Name of the retail chain where the card was loaded.
Pattern: Max 50 alphanumeric international characters
Example: "GroceryMart"

string | null

Load partners only. Identifier for the retail load transaction.
Pattern: Max 50 alphanumeric characters
Example: "12345abcdef"

string | null

Load partners only. First line of the retail store address where the card was loaded.
Pattern: 4–40 alphanumeric international characters plus address symbols.
Example: 123 Elm St

string | null

Load partners only. Second line of the retail store address where the card was loaded.
Pattern: Max 30 alphanumeric international characters plus address symbols
Example: Ste 700

string | null

Load partners only. The country where the store is located. Three-digit UN M49 code, such as 840 for USA, 124 for Canada, 484 for Mexico, 170 for Colombia.
Pattern: 3-digit numeric string
Example: 840

string | null

Load partners only. Latitude for the retail store where the card was loaded.
Pattern: Positive or negative float, no limit on decimal places
Example: 40.57297941556069

string | null

Load partners only. Longitude for the retail store where the card was loaded.
Pattern: Positive or negative float, no limit on decimal places
Example: -111.89920138637734

string | null

Load partners only. Name of the retail store where the card was loaded.
Pattern: Max 50 alphanumeric and international characters.
Example: "Main Street GroceryMart"

string | null

Load partners only. Identifier for the retail store where the card was loaded.
Pattern: Max 50 alphanumeric international characters
Example: "13459284"

date-time | null

Load partners only. Date that the card was loaded.
Pattern: YYYY-MM-DD hh:mm:ss
Example: 2021-11-14 13:23:04

string | null

Load partners only. City for the retail store where the card was loaded.
Pattern: Max 30 alphanumeric and international characters plus city symbols
Example: Salt Lake City

string | null

Load partners only. State or province for the retail store where the card was loaded.
Pattern: 2 ASCII letters or international characters
Example: UT

string | null

Load partners only. Zip code for the retail store where the card was loaded.
Pattern: 12345, 12345-1234, or K1A-1A1
Example: "84121"

float | null
0.01 to 999999999999.99

Amount to hold. To hold the entire payment amount, pass the same value as in amount.
Pattern: Positive integer or decimal number
Example: 100.00, 100, or 100.73

date-time | null

Date-time to expire the hold.
Pattern: YYYY-MM-DD hh:mm:ss
Example: 2021-11-14 13:23:04

string | null

Description for the hold.
Pattern: Max 80 alphanumeric characters, including punctuation
Example: "One time payroll load."

string | null

External identifier for a hold.
Pattern: Max 60 alphanumeric characters
Example: "45348bacd483348"

string | null

Network identifier for RTP payments.
Pattern: Max 35 alphanumeric characters
Example: "20230805021000021P1BRJPM00040034610"

string | null

Debtor (individual or company) name for RTP payments.
Pattern: Max 140 characters
Example: "John Doe"

string | null

Creditor (individual or company) name for RTP payments.
Pattern: Max 140 characters
Example: "Jane Smith"

Headers
string
enum
Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Updated about 1 year ago

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

Updated about 1 year 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.