Skip to main content
POST
/
3p
/
api
/
v1
/
transaction
Create a new transaction ( STABLE )
curl --request POST \
  --url https://api.grailpay.com/3p/api/v1/transaction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payer_uuid": "9c330a70-84de-46c3-a380-70b34799b1d3",
  "payee_uuid": "9c330a70-84de-46c3-a380-70b34799b1d3",
  "processor_mid": "234234234",
  "amount": "100",
  "transaction_fee": "1.2",
  "client_reference_id": "adsssd",
  "payout_delay_days_min": "1",
  "speed": "fast",
  "company_name": "Company-1",
  "description": "lladsdf asldfs",
  "addenda": "",
  "source_bank_account": {
    "uuid": "9c330a70-84de-46c3-a380-70b34799b1d3",
    "aggregator_type": "plaid"
  },
  "destination_bank_account": {
    "uuid": "9c330a70-84de-46c3-a380-70b34799b1d3",
    "aggregator_type": "plaid"
  },
  "failure_simulation": "BeforePayout"
}
'
{
  "status": true,
  "message": "",
  "data": {
    "uuid": "9c330a70-84de-46c3-a380-70b34799b1d3",
    "payer_uuid": "7d021f9a-b5f4-4668-8d78-0f448f55f984",
    "payee_uuid": "ec82930a-b59e-4ed2-83dd-0f041bfa5baa",
    "transaction_status": "PAYOUT_COMPLETE",
    "currency": "USD",
    "amount": 57163,
    "transaction_fee": 0,
    "client_reference_id": "stageN5@123",
    "payout_delay_days": 0,
    "company_name": "a-z, A-Z, 12-'3.",
    "description": null,
    "addenda": null,
    "type": "api",
    "spped": "sameday",
    "processor_mid": "123131123",
    "batch_payout_id": "78e84f6a-c36e-4c9e-86bf-6ff4a492be90",
    "capture_status": "CAPTURE_COMPLETE",
    "payout_status": "PAYOUT_COMPLETE",
    "clawback_status": null,
    "reverse_payout_status": null,
    "failure_code": null,
    "failure_reason": null,
    "cancel_reason": null,
    "payer_bank_account": {
      "uuid": "9c3306a6-743f-4f8f-9a33-dcd081a06204",
      "aggregator_type": "bank_link"
    },
    "payee_bank_account": {
      "uuid": "9c33090b-c0fb-42ce-9ad8-921665d15a90",
      "aggregator_type": "bank_link"
    },
    "payout_ach_return_code": "R01",
    "payout_failure_reason": "Insufficient funds",
    "trace_ids": {
      "capture_trace_id": "ach_92lhg3vbf76qxzp",
      "payout_trace_id": "ach_57ytkdw84mncxvq",
      "reverse_payout_trace_id": "",
      "refunds": [
        {
          "refund_uuid": "",
          "refund_capture_trace_id": "",
          "refund_payout_trace_id": ""
        }
      ]
    },
    "created_at": "2024-06-03 15:58:44",
    "updated_at": "2024-06-04 18:30:30"
  },
  "errors": null,
  "error_code": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.ach.netevia.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Token-based authentication using Authorization: Bearer <YOUR_API_KEY> provided by the GrailPay Support Team.

Body

application/json
​
payer_uuid
string
Example:

"9c330a70-84de-46c3-a380-70b34799b1d3"

​
payee_uuid
string
Example:

"9c330a70-84de-46c3-a380-70b34799b1d3"

​
processor_mid
string
Example:

"234234234"

​
amount
integer
Example:

"100"

​
transaction_fee
integer
Example:

"1.2"

​
client_reference_id
string
Example:

"adsssd"

​
payout_delay_days_min
integer
Example:

"1"

​
speed
string
Example:

"fast"

​
company_name
string
Example:

"Company-1"

​
description
string
Example:

"lladsdf asldfs"

​
addenda
string
Example:

""

​
source_bank_account
object
​
destination_bank_account
object
​
failure_simulation
enum<integer>
Available options:
BeforePayout,
AfterPayout

Response

Transaction details

​
status
boolean
Example:

true

​
message
string
Example:

""

​
data
object
​
errors
string
Example:

null

​
error_code
string
Example:

null