Payout API

This API enables peer-to-peer (P2P) payment transactions.

POST/dev/p2p/initiate

Initiate Transaction

Creates new P2P transaction.

Request parameters

  • Name
    project
    Type
    string
    Required
    required
    Description

    Your project ID

  • Name
    price
    Type
    string
    Required
    required
    Description

    The amount of transaction

  • Name
    currency
    Type
    string
    Required
    required
    Description

    Transaction currency

  • Name
    result_url
    Type
    string
    Required
    required
    Description

    The callback URL

  • Name
    redirect_url
    Type
    string
    Required
    required
    Description

    Redirect URL

  • Name
    signature
    Type
    string
    Required
    required
    Description

    Request signature

Response Parameters

  • Name
    p2p_id
    Type
    string
    Required
    Description

    The ID of the transaction

  • Name
    success
    Type
    boolean
    Required
    Description

    The result of the request

  • Name
    amount
    Type
    string
    Required
    Description

    The amount of the transaction

  • Name
    currency
    Type
    string
    Required
    Description

    Currency of the transaction

  • Name
    form_url
    Type
    string
    Required
    Description

    Payment URL

  • Name
    recipient_card
    Type
    string
    Required
    Description

    Recipient card number

  • Name
    recipient_card_brand
    Type
    string
    Required
    Description

    Card brand

  • Name
    transaction_status
    Type
    string
    Required
    Description

    Transaction status

Request

POST
/dev/p2p/initiate
curl -X POST https://api.nodapay.ai/dev/p2p/initiate \
-H "Content-Type: application/json" \
-d '{
      "project": "d7d86391b36b4543bc1cf87cbd2ee6c9",
      "price": "1.00",
      "currency": "USD",
      "order_id": "123321",
      "result_url": "https://example.com/result",
      "redirect_url": "https://example.com/redirect",
      "signature": "a494b64e83f59f2fb1c08c3282fbe7f51ba820cab6baf107f1e2b675ce09d5a7"
    }'

Response

{
  "p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
  "success": true,
  "amount": "1.00",
  "currency": "USD",
  "form_url": "https://api.example.com/dev/p2p/form/1692853195443_WTWsOikQomYxGxyYfTEHmpug",
  "recipient_card": "4244491609788988",
  "recipient_card_brand": "VISA",
  "transaction_status": "waiting_payment"
}
POST/dev/p2p/transaction/status

Transaction Status

Get P2P transaction status by p2p_id.

Request parameters

  • Name
    project
    Type
    string
    Required
    required
    Description

    Your project ID

  • Name
    p2p_id
    Type
    string
    Required
    required
    Description

    Transaction ID

  • Name
    signature
    Type
    string
    Required
    required
    Description

    Request signature

Request

POST
/dev/p2p/transaction/status
curl https://api.nodapay.ai/dev/p2p/transaction/status \
-H "Content-Type: application/json" \
-d '{
      "project": "d7d86391b36b4543bc1cf87cbd2ee6c9",
      "p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
      "signature": "d0a8b96e5a0ef2c17d6484faeabcc737cfd05256dad840a98603ce97ae558690"
    }'

Response

{
  "success": true,
  "p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
  "amount": "1.00",
  "amount_gross": "1.00",
  "recipient_pan": "424449******8988",
  "create_date": "2023-08-24T04:59:56.184Z",
  "currency": "USD",
  "transaction_status": "completed"
}
POST/dev/p2p/transaction/paid

Mark paid

Mark P2P transaction as paid.

Request parameters

  • Name
    project
    Type
    string
    Required
    required
    Description

    Your project ID

  • Name
    p2p_id
    Type
    string
    Required
    required
    Description

    Transaction ID

  • Name
    signature
    Type
    string
    Required
    required
    Description

    Request signature

Request

GET
/dev/p2p/transaction/paid
curl https://api.nodapay.ai/dev/p2p/transaction/paid \
-H "Content-Type: application/json" \
-d '{
      "project": "d7d86391b36b4543bc1cf87cbd2ee6c9",
      "p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
      "signature": "d0a8b96e5a0ef2c17d6484faeabcc737cfd05256dad840a98603ce97ae558690"
    }'

Response

{
  "success": true,
  "p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
  "transaction_status": "paid"
}
POST/dev/p2p/transaction/cancel

Cancel Transaction

Cancel P2P transaction by p2p_id

Request parameters

  • Name
    project
    Type
    string
    Required
    required
    Description

    Your project ID

  • Name
    p2p_id
    Type
    string
    Required
    required
    Description

    Transaction ID

  • Name
    signature
    Type
    string
    Required
    required
    Description

    Request signature

Request

GET
/dev/p2p/transaction/cancel
curl https://api.nodapay.ai/dev/p2p/transaction/cancel \
-H "Content-Type: application/json" \
-d '{
      "project": "d7d86391b36b4543bc1cf87cbd2ee6c9",
      "p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
      "signature": "d0a8b96e5a0ef2c17d6484faeabcc737cfd05256dad840a98603ce97ae558690"
    }'

Response

{
  "success": true,
  "p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
  "transaction_status": "canceled"
}
POST/dev/p2p/transaction/dispute

Dispute

Creates new dispute for P2P transaction.

Request parameters

  • Name
    project
    Type
    string
    Required
    required
    Description

    Your project ID

  • Name
    p2p_id
    Type
    string
    Required
    required
    Description

    Transaction ID

  • Name
    signature
    Type
    string
    Required
    required
    Description

    Request signature

Request

GET
/dev/p2p/transaction/dispute
curl https://api.nodapay.ai/dev/p2p/transaction/dispute \
-H "Content-Type: application/json" \
-d '{
"project": "d7d86391b36b4543bc1cf87cbd2ee6c9",
"p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
"signature": "d0a8b96e5a0ef2c17d6484faeabcc737cfd05256dad840a98603ce97ae558690"
}'

Response

{
  "success": true,
  "p2p_id": "1692853195443_WTWsOikQomYxGxyYfTEHmpug",
  "dispute_id": "580446",
  "transaction_status": "in_review"
}