3.36. /api/scoring/v1/score
Introduction
API URLs
Integration |
Production |
---|---|
https://sandbox.payneteasy.com/paynet/api/scoring/v1/score/{endpoint_id} |
https://gate.payneteasy.com/paynet/api/scoring/v1/score/{endpoint_id} |
Request Parameters
Note
Parameter name |
Description |
Format |
---|---|---|
card-ref-id |
The card-ref-id created earlier using create-card-ref call that can be used to find the specific card that is needed. To create create-card-ref see /api/v2/create-card-ref/. Send either card-ref-id or card-number, not all. |
N{1-*} |
card-number |
Full card number. Send either card-number or card-ref-id, not all. |
N{13-19} |
client-order-id |
Unique order identifier assigned by Connecting Party. |
N{1-*} |
first-name |
First Name. |
N{64} |
last-name |
Last Name. |
N{64} |
middle-name |
Middle Name. |
N{64} |
birth-date |
Customer’s birth date. |
1982-07-31 |
rating |
For example 0000. |
N{4} |
phone |
Customer’s full international phone number, including country code. |
N{11} |
Response Parameters
Parameter name |
Description |
---|---|
type |
The type of response. May be async-response, validation-error, error. If type equals validation-error or error, error-message and error-code parameters contain error details. |
paynet-order-id |
Order id assigned to the order by Payneteasy. |
merchant-order-id |
Connecting Party order id |
serial-number |
Unique number assigned by Payneteasy server to particular request from the Connecting Party. |
error-message |
If status is error this parameter contains the reason for decline or error details. |
error-code |
The error code is case of error status. |
Request example
POST /paynet/api/scoring/v1/score/2404
Parameters:
birth-date: 2000-01-01
card-ref-id: 12345
client-order-id: score123
create-card-ref: false
first-name: John
last-name: Smith
middle-name: M
phone: 19019019191
rating: 5
Headers:
accept: */*
accept-encoding: gzip,deflate
authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="connectingparty",oauth_timestamp="1702073235",oauth_nonce="OPASWJfawifJHG",oauth_signature_method="HMAC-SHA1", oauth_signature="8FpDccqJGDwppPUnLwokfJl53Mc%3D"
content-length: 419
content-type: application/x-www-form-urlencoded
Success Response Example
HTTP/2 200 OK
Date: Mon, 01 Dec 2020 11:47:18 GMT
type=async-response
&serial-number=00000000-0000-0000-0000-00010b87db96
&merchant-order-id=score123
&paynet-order-id=9550
&end-point-id=2404
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
normalized parameters |
---|
signature base string |
---|
Signature |
---|
authorization header |
---|
|