Sign in
Transactions EB

Create transaction

Creates a new transaction, such as a payment via ACH, Wire or Real Time Payments (RTP).

post/transactions

Request

  • Base URL: https://apigateway.jpmorgan.com/tsapi/ef/v1
  • URL: https://apigateway.jpmorgan.com/tsapi/ef/v1/transactions
  • Auth: none declared

Headers

tokenstring

JWT Client token

Request body

type'RTP' | 'WIRE' | 'ACH' | 'TRANSFER' required

Payment method - ACH, RTP, WIRE, ACH, TRANSFER. Only ACH (for payouts) and TRANSFER (for payments between embedded accounts) are used in Embedded Payments transactions.

originatingAccountstring required

ID of the account to make the payment from

amountnumber required
currency'USD' required

Payment currency - currently supported: USD

memostring

Memorandum

paymentDatestring date required

ISO date format - yyyy-MM-dd

recipientIdstring

Payment recipient Id, either recipient or recipient id must be provided

Example request

{
  "type": "ACH",
  "originatingAccount": "dc2eda9084bf40b7a1d8baa8c5e0ea0ax",
  "amount": 100,
  "currency": "USD",
  "memo": "Invoice 1234",
  "paymentDate": "2022-12-31",
  "recipient": {
    "partyDetails": {
      "address": {
        "addressLine1": "345 Wouda St",
        "addressLine2": "Malibu Point",
        "addressLine3": "Greater Woking",
        "city": "Springfield",
        "countryCode": "US",
        "state": "ND",
        "zip": "58008"
      },
      "type": "INDIVIDUAL",
      "firstName": "Jon",
      "lastName": "Smith",
      "businessName": "Widget Co.",
      "contacts": [
        {
          "contactType": "PHONE",
          "countryCode": "+1",
          "value": "6316215110"
        }
      ]
    },
    "account": {
      "number": "021000021",
      "type": "CHECKING",
      "routingCodeType": "USABA",
      "routingNumber": "021000021",
      "countryCode": "US"
    }
  },
  "recipientId": "a8eb71c9-7bbb-41f2-8d9e-b0f52d1ecd71"
}

Response

Successful

idstring
status'PENDING' | 'CANCELED' | 'COMPLETED' | 'COMPLETED_WITH_EXCEPTIONS' | 'COMPLETED_NOT_IN_TARGET_WALLET' | 'REJECTED' | 'RETURNED' | 'PARTIALLY_COMPLETED' | 'UNDEFINED'

The current status of the transaction as it is processed:

  • PENDING - The transaction is still being processed.
  • CANCELED - The transaction has been canceled.
  • COMPLETED - The transaction has been completed.
  • COMPLETED_WITH_EXCEPTIONS - The transaction has completed, but not all of the requested criteria has been fulfilled.
  • REJECTED - The transaction has been rejected and will not be completed.
  • RETURNED - The payment rail has been unable to complete the payment specified recipient. The payment has been returned to the originator.
  • PARTIALLY_COMPLETED - Not all transactions in the batch have been completed.
  • UNDEFINED - The status of this transaction cannot be found.
type'RTP' | 'WIRE' | 'ACH' | 'TRANSFER'

Payment method - ACH, RTP, WIRE, ACH, TRANSFER. Only ACH (for payouts) and TRANSFER (for payments between embedded accounts) are used in Embedded Payments transactions.

accountIdstring
accountNumberstring
amountnumber
currencystring
memostring
paymentDatestring date

ISO date format - yyyy-MM-dd

c2ProfileIdstring

Example response

{
  "id": "123434534",
  "status": "PENDING",
  "type": "ACH",
  "accountId": "dc2eda9084bf40b7a1d8baa8c5e0ea0ax",
  "accountNumber": "20000023556044",
  "recipient": {
    "partyDetails": {
      "address": {
        "addressLine1": "345 Wouda St",
        "addressLine2": "Malibu Point",
        "addressLine3": "Greater Woking",
        "city": "Springfield",
        "countryCode": "US",
        "state": "ND",
        "zip": "58008"
      },
      "type": "INDIVIDUAL",
      "firstName": "Jon",
      "lastName": "Smith",
      "businessName": "Widget Co.",
      "contacts": [
        {
          "contactType": "PHONE",
          "countryCode": "+1",
          "value": "6316215110"
        }
      ]
    },
    "account": {
      "number": "021000021",
      "type": "CHECKING",
      "routingCodeType": "USABA",
      "routingNumber": "021000021",
      "countryCode": "US"
    }
  },
  "amount": 100,
  "currency": "USD",
  "memo": "Invoice 1234",
  "paymentDate": "2022-12-31",
  "c2ProfileId": "0030000132",
  "debitCardDetails": {
    "cardPaymentRoutingNumber": "2000303444",
    "cardLast4": "0000",
    "cardSerialNumber": "100000158935",
    "messageType": "1200",
    "cardTransactionType": "CR",
    "isa": "0",
    "surcharge": 1,
    "merchant": {
      "name": "XYZ001",
      "address": {
        "addressLine1": "345 Wouda St",
        "city": "Springfield",
        "countryCode": "US",
        "state": "ND",
        "zip": "58008"
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.