Create intra-account transfer

POST/

Use this endpoint to request an intra-account transfer. Add the source details to the body of the request in JSON format. When creating an intra-account transfer request, you must pass in both a token to identify the transfer sender (either sender_user_token or sender_business_token) and a token to identify the transfer recipient (either recipient_user_token or recipient_business_token). The sender and recipient objects must already exist.

Note
This feature is disabled by default and requires activation by Marqeta.This feature enables you to transfer or reallocate funds where the sender and the recipient belong to the same user within the card program. It does not allow you to transfer or reallocate funds between different users within the same card program, or between different card programs. Contact your Marqeta representative for more information.

Request body

Fields	Description
amount decimal Required	Amount of the transfer. Allowable Values: decimal Format: 0.00
currency_code string Required	Three-digit ISO 4217 currency code. Allowable Values: Valid three-digit ISO 4217 currency code
memo string Optional	Additional descriptive text about the transfer. Allowable Values: 1–99 chars
recipient_business_token string Optional	Specifies the business account holder that receives funds. Send a `GET` request to `/businesses` to retrieve business tokens. Allowable Values: 1–36 chars
recipient_user_token string Optional	Specifies the user account holder that receives funds. Send a `GET` request to `/users` to retrieve user tokens. Allowable Values: 1–36 chars
sender_business_token string Optional	Specifies the business account holder that sends funds. Send a `GET` request to `/businesses` to retrieve business tokens. Allowable Values: 1–36 chars
sender_user_token string Optional	Specifies the user account holder that sends funds. Send a `GET` request to `/users` to retrieve user tokens. Allowable Values: 1–36 chars
tags string Optional	Metadata about the intra-account transfer. Allowable Values: 1–255 chars
token string Optional	Unique identifier of the intra-account transfer request. If you do not include a token, the system will generate one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. Allowable Values: 1–36 chars

Sample request body

JSON

{
  "token": "my_intra_account_transfer_01",
  "sender_user_token": "my_user_01",
  "recipient_user_token": "my_user_01_account_2",
  "currency_code": "USD",
  "amount": 50
}

Response body

Fields	Description
amount decimal Returned	Amount of the transfer. Allowable Values: decimal Format: 0.00
currency_code string Returned	Three-digit ISO 4217 currency code. Allowable Values: Valid three-digit ISO 4217 currency code
memo string Conditionally returned	Additional descriptive text about the intra-account transfer. Allowable Values: 1–99 chars
recipient_business_token string Conditionally returned	Specifies the business account holder that receives funds. Allowable Values: 1–36 chars
recipient_user_token string Conditionally returned	Specifies the user account holder that receives funds. Allowable Values: 1–36 chars
sender_business_token string Conditionally returned	Specifies the business account holder that sends funds. Allowable Values: 1–36 chars
sender_user_token string Conditionally returned	Specifies the user account holder that sends funds. Allowable Values: 1–36 chars
tags string Conditionally returned	Metadata about the intra-account transfer. Allowable Values: 1–255 chars
token string Returned	Unique identifier of the intra-account transfer request. Allowable Values: 1–36 chars

Sample response body

JSON

{
  "token": "my_intra_account_transfer_01",
  "amount": 50,
  "currency_code": "USD",
  "sender_user_token": "my_user_01",
  "recipient_user_token": "my_user_01_account_2",
  "created_time": "2023-03-11T19:15:01Z"
}

Getting Started

Testing

Card Issuing

Card Processing

Accounts & Money Movement

Risk, Fraud, and Disputes

Cardholder User Experience

Create intra-account transfer

Request body

Sample request body

Response body

Sample response body

​Request body

​Sample request body

​Response body

​Sample response body

Request body

Sample request body

Response body

Sample response body