Send funds to a payee

POST /api/transaction

Use this call to transfer funds from a sender to a payee.

When you POST a pull or push transaction, send the cardToken, amount, and RequestId in the request body JSON.

When P2C receives the POST request, it uses the token to retrieve the debit card number and performs the transaction. The API response includes the card token, amount transferred, and a transaction status which indicates success/failure.

Request attributes

AttributeDescription
sourceSenderId
string
Merchant ID.
sourceSenderName
string
Merchant name.
sourceMcc
string
Merchant Category Code (MCC).
4-digits that a credit card issuer uses to categorize consumer transactions for their card.
RequestId
GUID
This attribute corresponds to the TransacationRequestId in the response.
Required
cardToken
string
Token for the signed up debit card.
Required
amount
integer
Transaction amount in cents.
Required

Sample request POST /api/transaction

{
  "sourceSenderId": "298fa967-97dp-vvy6-afag-11sghvk6nx12",
  "sourceSenderName": "Smiths",
  "sourceMcc": "5434",
  "requestId": "298fa967-97dp-vvy6-afag-11sghvk6nx12",
  "cardToken": "12975twtr423hbs34bn670103",
  "amount": 10
}

Response attributes

AttributeDescription
transactionRequestId
string
This attribute corresponds to the RequestId in the request.
amount
integer
Transaction amount in cents.
transactionRequestedAt
string
Date and time the transaction was requested.
transactionStatus
string
Status of the transaction:
- Succeeded
- Pending
- Failed
- Rejected
errorDescription
string
Description of any error that might have occurred.
creditCardId
string
Token for the signed up debit card.
railId
string
The processor used to perform the transaction
- RS2
- McSend
- TabaPay
network
string
Card network.
- Visa
- Mastercard
- ET
- PULSE
- STAR
- NYCE
- Accel
- RPPS
- MoneySend
retrievalReferenceId
GUID
Unique tracking identifier for this transaction in the processors to correlate this transaction to the processors.
actualTransactionDoneAt
string
Actual time the transaction was sent to the processor.
paymentSent
boolean
True if the payment passed all the way to the processor successfully, otherwise false.
requestApproved
boolean
True if the payment passed all the way to the processor successfully, otherwise false.
responseReceived
boolean
True if P2C received a response from the external processor, otherwise false.
responseCode
string
An ISO 8583 two-digit code signifying the transaction result. For example, 00 means successful.
responseDescription
string
An ISO 8583 string description of the transaction result. For example, Approved.
traceNumber
string
Unique number that is assigned to a transaction when it leaves the merchant bank until it arrives at the cardholder bank.
error
string
Descriptive error, if relevant.
transactionRequestBatchId
string
If a request is part of a batch, this ID shows.
sourceSenderName
string
Name of the sender of the payment.
*sourceMcc
string
Merchant Category Code (MCC).
4-digits that a credit card issuer uses to categorize consumer transactions for their card.
isSuccessful
boolean
True if the transaction is successful, otherwise false.

Sample response POST /api/transaction

{
"result": {
  "transactionRequestId": "e91ea2c5-e8dc-4790-acf7-5dea1cab7216", 
  "amount": 100,
  "transactionRequestedAt": "2022-09-10T00:28:37.76", 
  "transactionStatus": "Succeeded",
  "errorDescription": "null",
  "creditCardId": "OMOZBSFLNAUG8E2134UDH18WILO2QDA9K6XQVN", 
  "railId": "RS2",
  "network": "visa",
  "retrievalReferenceId": "null"
  "actualTransactionDoneAt": "2022-09-10T12:28:51", 
  "paymentSent": true,
  "requestApproved": true,
  "responseReceived": true,
  "responseCode": "00",
  "responseDescription": "Approved", 
  "traceNumber": "null",
  "error": "null",
  "sourceSenderName": "Cooks",
  "sourceMcc": "5981",
  },
  "isSuccessful": true 
}