Get Payment Status

Retrieve the current status of a payment transaction.

POST

***

Request Parameters

Name	Type	Description
`public_key`Required	`String`	Merchant identifier. Example: `i000000001`
`transaction`Required	`String`	Epoint transaction identifier. Example: `tw0000000101`

Request Example

Send Request

Payload

{
  "public_key": "i000000001",
  "transaction": "tw0000000101"
}

1DATA=$(echo -n '{"public_key":"i000000001","transaction":"tw0000000101"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3
4curl -X POST *** \
5-H "Content-Type: application/x-www-form-urlencoded" \
6-d "data=$DATA&signature=$SIGNATURE"

Response Parameters

Name	Type	Description
`status`Required	`String`	Payment status: `success`, `failed`, `new`, `returned`, `error`, `server_error`
`code`Required	`String`	Bank response code
`message`Required	`String`	Payment status message
`transaction`Required	`String`	Epoint transaction identifier
`bank_transaction`Required	`String`	Bank transaction identifier
`bank_response`Required	`String`	Bank response for the payment
`operation_code`Required	`String`	`001` — card registration, `100` — customer payment
`rrn`Optional	`String`	Retrieval Reference Number. Only present for successful transactions.
`card_name`Optional	`String`	Cardholder name from payment page
`card_mask`Optional	`String`	Card mask in `123456******1234` format
`amount`Required	`Number`	Payment amount
`other_attr`Optional	`Array`	Additional parameters
`trace_id`Required	`String`	Unique request identifier for debugging. Provide this to Epoint support for issue investigation.

Success

Success Response
{
  "status": "success",
  "code": "000",
  "message": "Approved",
  "transaction": "te_0000000001",
  "bank_transaction": "BT12345",
  "bank_response": "000",
  "operation_code": "100",
  "rrn": "123456789012",
  "card_name": "John Doe",
  "card_mask": "123456******1234",
  "amount": 30.75,
  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}