Overview

The P2P object represents a payment from one of your activated direct connections to another. P2P payments must be individually authorized by the sender within 10 minutes of creation, using a verification code sent to their mobile device. Once committed, P2P payments are initiated immediately, and cannot be canceled.

Permission Required

Executing peer to peer transactions requires the payment.debit permission from the source Account Connection and the payment.credit permission from the destination Account Connection. Since peer to peer implementations typically allow free money flow to/from all peers, we recommend requesting both permissions from all users.

Methods

POST /p2p
Initiate a payment between your Account Connections.

Body Parameters

string

required

ID of the Account Connection sending money.

string

required

ID of the Account Connection receiving money.

number

required

Amount in cents, e.g. $1.00 would be the number 100.

string

Description of payout. (Visible to creators.) Default value: Payment from ${sourceFullName} to ${destinationFullName}

object

User defined data that can be attached to the object. See the User Data page for details.

Example

// POST /p2p
{
    "source": "acon_XXXXX",
    "destination": "acon_YYYYY",
    "amount_in_cents": 2000,
    "description": "Thanks for your help!"
}

{
    "id": "p2p_XXXXX",
    "status": "created",
    "source": "acon_XXXXX",
    "destination": "acon_YYYYY",
    "amount_in_cents": 2000,
    "description": "Thanks for your help!",
    "expires_at": "2024-11-12T20:32:49.075Z",
    "failed_commits": 0,
    "userdata": {},
    "created_at": "2024-11-12T20:22:49.075Z",
    "updated_at": "2024-11-12T20:22:49.075Z"
}

POST /p2p/:id/commit
Execute P2P payment. Requires verification code sent to the source account connection’s verified mobile device. Include an idempotency key header to make the request idempotent.

Path Parameters

string

required

The ID of the P2P payment to commit.

Body Parameters

string

required

Verification code sent to source account connection’s verified mobile device.

Example

// POST /p2p/p2p_XXXXX/commit
{
    "code": "123456"
}

{
    "id": "p2p_XXXXX",
    "status": "pending",
    "source": "acon_XXXXX",
    "destination": "acon_YYYYY",
    "amount_in_cents": 2000,
    "description": "Thanks for your help!",
    "expires_at": "2024-11-12T20:32:49.075Z",
    "failed_commits": 0,
    "userdata": {},
    "created_at": "2024-11-12T20:22:49.075Z",
    "updated_at": "2024-11-12T20:22:49.075Z"
}

GET /p2p/:id
Get details of one of your P2P payments.

Path Parameters

string

required

The ID of the P2P payment to retrieve.

Example

{
    "id": "p2p_XXXXX",
    "status": "created",
    "source": "acon_XXXXX",
    "destination": "acon_YYYYY",
    "amount_in_cents": 2000,
    "description": "Thanks for your help!",
    "expires_at": "2024-11-12T20:32:49.075Z",
    "failed_commits": 0,
    "userdata": {},
    "created_at": "2024-11-12T20:22:49.075Z",
    "updated_at": "2024-11-12T20:22:49.075Z",
}

PUT /p2p/:id
Update data associated with one of your enterprise’s P2P payments. Since Manifest sends a verification message to the source account connection upon P2P creation, we do not let you update P2P fields that might materially change the nature of transaction.

Path Parameters

string

required

The ID of the P2P payment to update.

Body Parameters

object

User defined data that can be attached to the object. See the User Data page for details.

Example

// PUT /p2p/p2p_XXXXX
{
  "userdata": {
    "key": "value"
  }
}

{
    "id": "p2p_XXXXX",
    "status": "created",
    "source": "acon_XXXXX",
    "destination": "acon_YYYYY",
    "amount_in_cents": 2000,
    "description": "Thanks for your help!",
    "expires_at": "2024-11-12T20:32:49.075Z",
    "failed_commits": 0,
    "userdata": {
        "key": "value"
    },
    "created_at": "2024-11-12T20:22:49.075Z",
    "updated_at": "2024-11-12T20:22:49.075Z",
}

GET /p2p
List all P2P payments created by your enterprise.

Query Parameters

integer

The page number to return. Default is 1.

integer

The number of items to return per page. Default is 10.

Example

{
    "data": [
        {
            "id": "p2p_XXXXX",
            "status": "created",
            "source": "acon_YYYYY",
            "destination": "acon_XXXXX",
            "amount_in_cents": 2000,
            "description": "Thanks for your help!",
            "expires_at": "2024-11-12T20:32:49.075Z",
            "failed_commits": 0,
            "userdata": {},
            "created_at": "2024-11-12T20:22:49.075Z",
            "updated_at": "2024-11-12T20:22:49.075Z",
        },
        {
            "id": "p2p_YYYYY",
            "status": "sent",
            "source": "acon_XXXXX",
            "destination": "acon_YYYYY",
            "amount_in_cents": 2000,
            "description": "Session",
            "expires_at": "2024-11-12T20:32:49.075Z",
            "failed_commits": 0,
            "userdata": {},
            "created_at": "2024-11-12T20:22:49.075Z",
            "updated_at": "2024-11-12T20:22:49.075Z",
        },
        {
            "id": "p2p_ZZZZZ",
            "status": "created",
            "source": "acon_XXXXX",
            "destination": "acon_ZZZZZ",
            "amount_in_cents": 2000,
            "description": "Thanks for your help!",
            "expires_at": "2024-11-12T20:32:49.075Z",
            "failed_commits": 0,
            "userdata": {},
            "created_at": "2024-11-12T20:22:49.075Z",
            "updated_at": "2024-11-12T20:22:49.075Z",
        },
    ],
    "pagination": {
        "page": 1,
        "page_size": 10,
        "total": 3
    }
}

GET /account-connection/:id/p2p
List all P2P payments to/from a specific account connection.

Path Parameters

string

required

The ID of the Account Connection to list P2P payments for.

Query Parameters

integer

The page number to return. Default is 1.

integer

The number of items to return per page. Default is 10.

Example

{
    "data": [
        {
            "id": "p2p_XXXXX",
            "status": "created",
            "source": "acon_YYYYY",
            "destination": "acon_XXXXX",
            "amount_in_cents": 2000,
            "description": "Thanks for your help!",
            "expires_at": "2024-11-12T20:32:49.075Z",
            "failed_commits": 0,
            "userdata": {},
            "created_at": "2024-11-12T20:22:49.075Z",
            "updated_at": "2024-11-12T20:22:49.075Z",
        },
        {
            "id": "p2p_YYYYY",
            "status": "sent",
            "source": "acon_XXXXX",
            "destination": "acon_YYYYY",
            "amount_in_cents": 2000,
            "description": "Session",
            "expires_at": "2024-11-12T20:32:49.075Z",
            "failed_commits": 0,
            "userdata": {},
            "created_at": "2024-11-12T20:22:49.075Z",
            "updated_at": "2024-11-12T20:22:49.075Z",
        },
        {
            "id": "p2p_ZZZZZ",
            "status": "created",
            "source": "acon_XXXXX",
            "destination": "acon_ZZZZZ",
            "amount_in_cents": 2000,
            "description": "Thanks for your help!",
            "expires_at": "2024-11-12T20:32:49.075Z",
            "failed_commits": 0,
            "userdata": {},
            "created_at": "2024-11-12T20:22:49.075Z",
            "updated_at": "2024-11-12T20:22:49.075Z",
        },
    ],
    "pagination": {
        "page": 1,
        "page_size": 10,
        "total": 3
    }
}

GET /account-connection/:id/p2p/:peer_id
List all P2P between two specific account connections.

Path Parameters

string

required

Account Connection ID

string

required

Peer Account Connection ID

Query Parameters

integer

The page number to return. Default is 1.

integer

The number of items to return per page. Default is 10.

Example

{
    "data": [
        {
            "id": "p2p_XXXXX",
            "status": "created",
            "source": "acon_YYYYY",
            "destination": "acon_XXXXX",
            "amount_in_cents": 2000,
            "description": "Thanks for your help!",
            "expires_at": "2024-11-12T20:32:49.075Z",
            "failed_commits": 0,
            "userdata": {},
            "created_at": "2024-11-12T20:22:49.075Z",
            "updated_at": "2024-11-12T20:22:49.075Z",
        },
        {
            "id": "p2p_YYYYY",
            "status": "sent",
            "source": "acon_XXXXX",
            "destination": "acon_YYYYY",
            "amount_in_cents": 2000,
            "description": "Session",
            "expires_at": "2024-11-12T20:32:49.075Z",
            "failed_commits": 0,
            "userdata": {},
            "created_at": "2024-11-12T20:22:49.075Z",
            "updated_at": "2024-11-12T20:22:49.075Z",
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 10,
        "total": 2
    }
}

Properties

string

Identifier for this payout.

string

ID of Account Connection sending money.

string

ID of Account Connection receiving money.

number

Amount in cents, e.g. $1.00 would be the number 100.

string

Description of payout. (Visible to creators.) Default value: Payment from ${sourceFullName} to ${destinationFullName}

string

Status of payout. One of:

Status	Description
`created`	Initial status after object creation. Requires Commit P2P method to be executed.
`pending`	P2P has been committed, but payment is not complete.
`sent`	The payment was completed and the amount is now available in the destination account.
`error`	The payment encountered an error during processing. The reasons a payment might be set to error include non-sufficient funds, suspected fraud, or failed validation.

date

When the P2P expires, set to 10 minutes after object creation. Formatted as ISO 8601 date/time string.

number

Count of failed commit attempts. Once a P2P has failed 3 times, it instantly expires.

object

User defined data that can be attached to the object. See the User Data page for details.

Documentation

Sending Money

Receiving Money

Automations

Resources

Reference

P2P

Overview

Methods

Body Parameters

Example

Path Parameters

Body Parameters

Example

Path Parameters

Example

Path Parameters

Body Parameters

Example

Query Parameters

Example

Path Parameters

Query Parameters

Example

Path Parameters

Query Parameters

Example

Properties

​Overview

​Methods

​Body Parameters

​Example

​Path Parameters

​Body Parameters

​Example

​Path Parameters

​Example

​Path Parameters

​Body Parameters

​Example

​Query Parameters

​Example

​Path Parameters

​Query Parameters

​Example

​Path Parameters

​Query Parameters

​Example

​Properties

Overview

Methods

Body Parameters

Example

Path Parameters

Body Parameters

Example

Path Parameters

Example

Path Parameters

Body Parameters

Example

Query Parameters

Example

Path Parameters

Query Parameters

Example

Path Parameters

Query Parameters

Example

Properties