Skip to main content
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 endpoint. This action is required before Paylias can proceed with any further steps in the payment lifecycle. 
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

{
  "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": "[email protected]",
          "first_name": "Ziyad",
          "last_name": "Parekh",
          "payment_address": "ziyad@safepay-platinum",
          "phone": "+923008277879",
          "type": "Payee_Individual"
        },
        "debtor_party": {
          "billing": {
            "country": "US"
          },
          "email": "[email protected]",
          "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 endpoint. 
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

{
  "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": "[email protected]",
          "first_name": "Ziyad",
          "last_name": "Parekh",
          "payment_address": "ziyad@safepay-platinum",
          "phone": "+923008277879",
          "type": "Payee_Individual"
        },
        "debtor_party": {
          "billing": {
            "country": "US"
          },
          "email": "[email protected]",
          "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 endpoint. 
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

{
  "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": "[email protected]",
          "first_name": "Ziyad",
          "last_name": "Parekh",
          "payment_address": "ziyad@safepay-platinum",
          "phone": "+923008277879",
          "type": "Payee_Individual"
        },
        "debtor_party": {
          "billing": {
            "country": "US"
          },
          "email": "[email protected]",
          "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"
      }
    }
  }
}