> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.paylias.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Submission

> Once submitted, payments are propagated through the network

Once a payment has been created the next required step, regardless of payment type (push or pull), is for the initiating partner to **submit** that payment to Paylias. This step signals the partner’s intent to move forward with the transaction and enables Paylias to issue admission or submission tasks to the receiving platform or finalize the payment flow.

Submissions are tied to a specific payment ID and can be created, retrieved by ID, or listed per payment.

## Submission APIs

### Create a Payment Submission

To submit a payment, call the [Create Payment Submission](/api-reference/submissions/create-payment-submission) endpoint. This action is required before Paylias can proceed with any further steps in the payment lifecycle.

```bash theme={null}
curl --request POST \
     --url https://sandbox.paylias.xyz/gateway/api/v1/csp/payments/{payment_id}/submissions \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-paylias-api-key: <API-KEY>' \
     --header 'x-org-id: <Org-ID>' \
     --header 'x-partner-id: <Partner-ID>' \
     --header 'idempotency-key: <uuid>'
```

Replace `{payment_id}` with the ID of the payment you previously created.

#### Response

```json expandable theme={null}
{
  "ok": true,
  "data": {
    "organization_id": "org_ct239n420or249k5bo90",
    "partner_id": "part_ct23b6420or249k5boag",
    "payment_id": "cjes76vsemvj3obsnc53",
    "status": 1,
    "submission_time": 1743273405,
    "token": "sub_cvk3rfc20or8munut3tg",
    "relationships": {
      "payment": {
        "amount": {
          "currency": "USD",
          "total": "10000"
        },
        "beneficiary_party": {
          "billing": {
            "country": "US"
          },
          "email": "ziyad.parekh@gmail.com",
          "first_name": "Ziyad",
          "last_name": "Parekh",
          "payment_address": "ziyad@safepay-platinum",
          "phone": "+923008277879",
          "type": "Payee_Individual"
        },
        "debtor_party": {
          "billing": {
            "country": "US"
          },
          "email": "johnc@stripe.com",
          "first_name": "John",
          "last_name": "Collison",
          "payment_address": "john@stripe-platinum",
          "phone": "+16462442945",
          "type": "Payee_Individual"
        },
        "device": {},
        "location": {},
        "expires_at": 1743276991,
        "initiated_at": 1743273391,
        "organization_id": "org_ct239n420or249k5bo90",
        "partner_id": "part_ct23b6420or249k5boag",
        "payment_id": "cjes76vsemvj3obsnc53",
        "reference": "INV0001"
      }
    }
  }
}
```

### Retrieve a Payment Submission

To retrieve a specific payment submission, use the [Find Payment Submission](/api-reference/submissions/find-payment-submission) endpoint.

```bash theme={null}
curl --request GET \
     --url https://sandbox.paylias.xyz/gateway/api/v1/csp/payments/{payment_id}/submissions/{submission_id} \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-paylias-api-key: <API-KEY>' \
     --header 'x-org-id: <Org-ID>' \
     --header 'x-partner-id: <Partner-ID>'
```

Replace `{payment_id}` and `{submission_id}` with the ID of the payment and submission you're looking for.

#### Response

```json expandable theme={null}
{
  "ok": true,
  "data": {
    "organization_id": "org_ct239n420or249k5bo90",
    "partner_id": "part_ct23b6420or249k5boag",
    "payment_id": "cjes76vsemvj3obsnc53",
    "status": 1,
    "submission_time": 1743273405,
    "token": "sub_cvk3rfc20or8munut3tg",
    "relationships": {
      "payment": {
        "amount": {
          "currency": "USD",
          "total": "10000"
        },
        "beneficiary_party": {
          "billing": {
            "country": "US"
          },
          "email": "ziyad.parekh@gmail.com",
          "first_name": "Ziyad",
          "last_name": "Parekh",
          "payment_address": "ziyad@safepay-platinum",
          "phone": "+923008277879",
          "type": "Payee_Individual"
        },
        "debtor_party": {
          "billing": {
            "country": "US"
          },
          "email": "johnc@stripe.com",
          "first_name": "John",
          "last_name": "Collison",
          "payment_address": "john@stripe-platinum",
          "phone": "+16462442945",
          "type": "Payee_Individual"
        },
        "device": {},
        "location": {},
        "expires_at": 1743276991,
        "initiated_at": 1743273391,
        "organization_id": "org_ct239n420or249k5bo90",
        "partner_id": "part_ct23b6420or249k5boag",
        "payment_id": "cjes76vsemvj3obsnc53",
        "reference": "INV0001"
      }
    }
  }
}
```

### List Submissions by Payment

To fetch the submission(s) associated with a particular payment, use the [Fetch Submission by Payment](/api-reference/submissions/fetch-payment-submission-by-payment) endpoint.

```bash theme={null}
curl --request GET \
     --url https://sandbox.paylias.xyz/gateway/api/v1/csp/payments/{payment_id}/submissions \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-paylias-api-key: <API-KEY>' \
     --header 'x-org-id: <Org-ID>' \
     --header 'x-partner-id: <Partner-ID>'
```

Replace `{payment_id}` with the ID of the payment you previously created. This is useful if you want to confirm whether a submission has already been made for a given payment ID.

#### Response

```json expandable theme={null}
{
  "ok": true,
  "data": {
    "organization_id": "org_ct239n420or249k5bo90",
    "partner_id": "part_ct23b6420or249k5boag",
    "payment_id": "cjes76vsemvj3obsnc53",
    "status": 1,
    "submission_time": 1743273405,
    "token": "sub_cvk3rfc20or8munut3tg",
    "relationships": {
      "payment": {
        "amount": {
          "currency": "USD",
          "total": "10000"
        },
        "beneficiary_party": {
          "billing": {
            "country": "US"
          },
          "email": "ziyad.parekh@gmail.com",
          "first_name": "Ziyad",
          "last_name": "Parekh",
          "payment_address": "ziyad@safepay-platinum",
          "phone": "+923008277879",
          "type": "Payee_Individual"
        },
        "debtor_party": {
          "billing": {
            "country": "US"
          },
          "email": "johnc@stripe.com",
          "first_name": "John",
          "last_name": "Collison",
          "payment_address": "john@stripe-platinum",
          "phone": "+16462442945",
          "type": "Payee_Individual"
        },
        "device": {},
        "location": {},
        "expires_at": 1743276991,
        "initiated_at": 1743273391,
        "organization_id": "org_ct239n420or249k5bo90",
        "partner_id": "part_ct23b6420or249k5boag",
        "payment_id": "cjes76vsemvj3obsnc53",
        "reference": "INV0001"
      }
    }
  }
}
```