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

Attribute	Description
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

Attribute	Description
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 
}