3.39. /api/scoring/v1/status

Introduction

Card scoring status is initiated through HTTPS GET request to the URLs and the parameters specified below. Use OAuth HMAC-SHA1 for authentication.

API URLs

Integration

Production

https://sandbox.payneteasy.com/paynet/api/scoring/v1/status/{endpoint_id}

https://gate.payneteasy.com/paynet/api/scoring/v1/status/{endpoint_id}

Request Parameters

Note

Request must have content-type=application/x-www-form-urlencoded and Authorization headers.

Status call parameters

Description

client_orderid

Connecting Party order identifier of the transaction for which the status is requested.

orderid

Order id assigned to the order by Payneteasy.

Response Parameters

Parameter name

Description

type

The type of response. May be status-response.

serial-number

Unique number assigned by Payneteasy server to particular request from the Connecting Party.

status

The status code of the initial transaction. May be approved, declined, processing, error or filtered. It type equals filtered it means the transaction was considered fraudulent by Payneteasy Server.

client-order-id

Client order id

paynet-order-id

Order id assigned to the order by Payneteasy.

card-ref-id

ID generated by card-ref.

bin

First 6 digits of the card.

last-four-digits

Last 4 digits of the card.

bank-name

Card Bank Name.

scoring-service-request-id

Scoring service request ID.

scoring-service-response-id

Scoring service response ID.

score1

Scoring score 1.

score2

Scoring score 2.

score3

Scoring score 3.

scoring-service-response

Scoring service text response.

error-message

If status in declined, error, filtered this parameter contains the reason for decline.

error-code

The error code is case status in declined, error, filtered.

Request example

GET /paynet/api/scoring/v1/status/2404?client-order-id=score123&orderid=9550
Parameters:
   client-order-id: score123
   orderid: 9550
Headers:
   accept-encoding: gzip,deflate
   authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="connectingparty",oauth_timestamp="1702073235",oauth_nonce="PSWvnfwMDH",oauth_signature_method="HMAC-SHA1",oauth_signature="lYpN%2BRi4u3tcCXJknQGVxlIGKQk%3D"

Success Response Example

HTTP/2 200 OK
Date: Mon, 01 Dec 2020 11:47:18 GMT

type=scoring-status-response
&serial-number=00000000-0000-0000-0000-00010b87dbc2
&status=approved
&client-order-id=score123
&paynet-order-id=9550
&bin=555555
&last-four-digits=4444
&bank-name=WORLDBANK
&scoring-service-request-id=9550
&scoring-service-response=<?xml version="1.0" encoding="UTF-8" standalone="yes"?><response><id>9550</id><cd>0</cd><results><result><name>score</name><value>0.5820386168936834</value></result></results></response>

Fail Response Example

HTTP/2 403 Forbidden
Date: Mon, 01 Dec 2020 11:47:18 GMT

type=error
&serial-number=00000000-0000-0000-0000-000003da9cb1
&error-message=Forbidden
&error-code=-1

Request Builder

HTTP method
URL
parameters
version
consumer key
consumer secret
timestamp

nonce

signature method

normalized parameters
signature base string
signature
authorization header